Laravel Cloudflare SDK

A premium, feature-rich PHP SDK and Laravel integration for the Cloudflare API v4, featuring rate-limit handling, automatic retries, and concurrent batch operations.

Features

100% Endpoint Coverage: Complete implementation of all zones, DNS, Workers, KV, R2, D1, Access, Turnstile, and 30 resource managers.
Fail-Safe Retries & Backoff: Robust exponential backoff and rate-limit parsing handling Retry-After response headers automatically.
Concurrently Pooled Processing: Execute calls asynchronously or concurrently in batches.
Dynamic Filter Builder: Fluent query-building for filtering, page indexing, and sorting.
Type-Safe DTOs: Automated data hydration into standard PHP DTO structures.
Custom Exceptions: Specialized mapping of Cloudflare API status codes and error formats.

Installation

Install the package via Composer:

composer require ghostcompiler/laravel-cloudflare

Publish the configuration file:

php artisan vendor:publish --provider="Vendor\Cloudflare\Providers\CloudflareServiceProvider" --tag="config"

Add your Cloudflare credentials to your .env file:

CLOUDFLARE_TOKEN=your_api_token_here
# Or legacy email/key credentials
CLOUDFLARE_EMAIL=your_email_here
CLOUDFLARE_API_KEY=your_global_api_key_here

CLOUDFLARE_TIMEOUT=30
CLOUDFLARE_RETRIES=3
CLOUDFLARE_RETRY_BACKOFF=100
CLOUDFLARE_LOGGING_ENABLED=true

Usage Examples

Zones

Listing Zones

use Vendor\Cloudflare\Facades\Cloudflare;

$zones = Cloudflare::zones()
    ->filter(['status' => 'active'])
    ->perPage(50)
    ->page(1)
    ->get();

foreach ($zones as $zone) {
    echo $zone->name . ': ' . $zone->status . "\n";
}

DNS Records

Managing DNS Records for a Zone

// Create a new record
$record = Cloudflare::dns()->create('zone_id_here', [
    'type' => 'A',
    'name' => 'subdomain',
    'content' => '1.2.3.4',
    'proxied' => true,
    'ttl' => 1
]);

// Update the record
Cloudflare::dns()->update('zone_id_here', $record->id, [
    'type' => 'A',
    'name' => 'subdomain',
    'content' => '5.6.7.8',
    'proxied' => false,
    'ttl' => 120
]);

// Delete the record
Cloudflare::dns()->delete('zone_id_here', $record->id);

Worker Scripts

Uploading and Managing Workers

Cloudflare::workers()->upload('account_id_here', 'my-script', 'console.log("Hello Worker");');

License

The MIT License (MIT). Please see License File for more information.

Development Environment

Built using ServBay

Mac M4 Tested
macOS Apple Silicon
Powered by ServBay

<?php namespace Vendor\Cloudflare\Facades; use Illuminate\Support\Facades\Facade; use Vendor\Cloudflare\Managers\CloudflareManager; /** * @method static \Vendor\Cloudflare\Managers\CloudflareManager authenticate(string $tokenOrEmail, ?string $apiKey = null) * @method static \Vendor\Cloudflare\Managers\AccountManager accounts() * @method static \Vendor\Cloudflare\Managers\ZoneManager zones() * @method static \Vendor\Cloudflare\Managers\ZoneSettingManager zoneSettings() * @method static \Vendor\Cloudflare\Managers\DnsRecordManager dns() * @method static \Vendor\Cloudflare\Managers\SslCertificateManager sslCertificates() * @method static \Vendor\Cloudflare\Managers\CertificatePackManager certificatePacks() * @method static \Vendor\Cloudflare\Managers\CustomHostnameManager customHostnames() * @method static \Vendor\Cloudflare\Managers\FirewallRuleManager firewallRules() * @method static \Vendor\Cloudflare\Managers\RulesetManager rulesets() * @method static \Vendor\Cloudflare\Managers\PageRuleManager pageRules() * @method static \Vendor\Cloudflare\Managers\CacheManager cache() * @method static \Vendor\Cloudflare\Managers\LoadBalancerManager loadBalancers() * @method static \Vendor\Cloudflare\Managers\LoadBalancerPoolManager loadBalancerPools() * @method static \Vendor\Cloudflare\Managers\LoadBalancerMonitorManager loadBalancerMonitors() * @method static \Vendor\Cloudflare\Managers\WorkerScriptManager workers() * @method static \Vendor\Cloudflare\Managers\WorkerRouteManager workerRoutes() * @method static \Vendor\Cloudflare\Managers\KvNamespaceManager kv() * @method static \Vendor\Cloudflare\Managers\R2BucketManager r2() * @method static \Vendor\Cloudflare\Managers\D1DatabaseManager d1() * @method static \Vendor\Cloudflare\Managers\PagesProjectManager pages() * @method static \Vendor\Cloudflare\Managers\ImageManager images() * @method static \Vendor\Cloudflare\Managers\StreamManager stream() * @method static \Vendor\Cloudflare\Managers\EmailRoutingManager emailRouting() * @method static \Vendor\Cloudflare\Managers\AccessApplicationManager access() * @method static \Vendor\Cloudflare\Managers\TunnelManager tunnels() * @method static \Vendor\Cloudflare\Managers\TurnstileManager turnstile() * @method static \Vendor\Cloudflare\Managers\HealthcheckManager healthchecks() * @method static \Vendor\Cloudflare\Managers\WaitingRoomManager waitingRooms() * @method static \Vendor\Cloudflare\Managers\LogpushManager logpush() * @method static \Vendor\Cloudflare\Managers\UserManager user() * @method static bool ping() * @method static string version() * @method static array rateLimit() * @method static array health() * @method static array config() * @method static \Vendor\Cloudflare\Http\Client\CloudflareClient client() * @method static array batch(array $callbacks) * * @see CloudflareManager */ class Cloudflare extends Facade { /** * Get the registered name of the component. * * @return string */ protected static function getFacadeAccessor() { return 'cloudflare'; } }

Laravel Cloudflare