gwhthompson/laravel-cloudflare-transforms

Fluent API for Cloudflare Image Transformation URLs in Laravel

v3.2.2 2025-12-19 14:01 UTC

Requires

• php: ^8.3
• illuminate/filesystem: ^11.0|^12.0
• illuminate/support: ^11.0|^12.0

Requires (Dev)

• driftingly/rector-laravel: ^2.0
• laravel/boost: ^1.2
• laravel/pint: ^1.0
• mockery/mockery: ^1.6
• orchestra/testbench: ^9.0|^10.0
• pestphp/pest: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• phpstan/phpstan: ^2.0
• rector/rector: ^2.0.0

MIT

• George Thompson

• images
• cdn
• laravel
• cloudflare
• transformations

README

Fluent API for Cloudflare Image Transformations.

Installation

Requires PHP 8.3+ and Laravel 11+.

composer require gwhthompson/laravel-cloudflare-transforms

Set your disk's url to a Cloudflare-proxied domain:

// config/filesystems.php
'media' => [
    'driver' => 's3',
    'url' => env('CLOUDFLARE_CDN_URL'), // https://cdn.example.com
    // ...
],

Usage

Storage::disk('media')->image('photo.jpg')
    ->width(400)
    ->format(Format::Auto)
    ->url();
// → https://cdn.example.com/cdn-cgi/image/w=400,f=auto/photo.jpg

// Responsive srcset
Storage::disk('media')->image('hero.jpg')
    ->srcset([320, 640, 960, 1280]);

// Convenience methods
->optimize()     // format=auto, quality=high
->thumbnail(150) // square crop
->grayscale()

Blade Component

<x-cloudflare:image
    path="hero.jpg"
    :width="1200"
    :fit="Fit::Cover"
    :srcset="[320, 640, 960, 1280]"
    sizes="(max-width: 640px) 100vw, 50vw"
/>

Enums

Enum	Values
Fit	Contain, Cover, Crop, Pad, ScaleDown, Squeeze
Format	Auto, Avif, Jpeg, Webp
Quality	High, MediumHigh, MediumLow, Low
Gravity	Auto, Top, Bottom, Left, Right, Face

Configuration

php artisan vendor:publish --tag=cloudflare-transforms-config

Option	Default	Purpose
domain	null	Fallback for CloudflareImage::make()
transform_path	cdn-cgi/image	Custom path with URL rewrite
validate_file_exists	true	Disable for performance

Testing

# .env.testing
CLOUDFLARE_VALIDATE_FILE_EXISTS=false

Security

Report vulnerabilities to [e-mail].

License

MIT