php-plug-cdn/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Overview

This is lthn/php-plug-cdn, a Composer library providing CDN provider integrations for the Plug framework. It depends on lthn/php (the core Plug framework) which supplies Core\Plug\Response, BuildsResponse, and UsesHttp traits. Licensed under EUPL-1.2.

Architecture

Driver-based manager pattern. CdnManager is the entry point — it resolves CDN provider operations by driver name (default: bunny, configurable via cdn.driver).

Each driver registers two operation classes keyed by contract interface:

• Purgeable — cache purging (single URL, bulk, full zone, tag-based)
• HasStats — statistics and bandwidth reporting

New providers are added by: (1) creating classes implementing the contracts under src/{Provider}/, (2) registering them in CdnManager::$drivers or via CdnManager::extend().

Bunny CDN implementation (src/Bunny/) uses the Bunny.net REST API. Config keys: cdn.bunny.api_key, cdn.bunny.pull_zone_id. Both classes use the UsesHttp and BuildsResponse traits from lthn/php.

Conventions

• PHP 8.2+ with declare(strict_types=1) on all files
• PSR-4 autoloading: Core\Plug\Cdn\ → src/
• Contracts live in src/Contract/; provider implementations in src/{ProviderName}/
• All public methods return Core\Plug\Response (from the parent lthn/php package)
• Configuration accessed via Laravel's config() helper
• Errors logged via Illuminate\Support\Facades\Log before returning error responses

Development

No tests, linting, or build commands exist in this package yet. It is installed as a dependency via Composer into a Laravel-based application.