dashed / laravel-drift
Fund package maintenance!
Dashed-DEV
Requires
- php: ^8.3
- illuminate/http: ^11.21
- illuminate/support: ^11.0
- intervention/image: ^3.8
README
Optimize images on the fly.
Installation
You can install the package via composer:
composer require dashed/laravel-drift
Usage
Simply install the package, and register a configuration in AppServiceProvider@boot
:
use Dashed\Drift\Config; use Dashed\Drift\DriftManager; use Dashed\Drift\CachingStrategies\FilesystemCachingStrategy; /** @var DriftManager $drift */ $drift = app(DriftManager::class); $drift->registerConfig(new Config( name: 'my-config-name', // Will be used in the slug filesystemDisk: 'filesystems-disk-name', // Local, public or s3 for example cachingStrategy: FilesystemCachingStrategy::class, // Create your own or use the defaults like FilesystemCachingStrategy or NullCachingStrategy ));
Image URLs
To generate an image URL use the \Dashed\Drift\UrlBuilder
like so:
use Dashed\Drift\UrlBuilder; /** @var UrlBuilder $builder */ $builder = app(UrlBuilder::class); $image = $builder->url('my-config-name', 'example.png', [ 'resize' => [1920, 1080], 'encode' => 'webp', // The fallback encoding will be webp ]);
You can use most of Intervention Image's methods, simply use the method name as key and set the argument as value. Have more than one argument? Use an array instead like in the example above.
Blade Component
<x-drift::image class="w-full aspect-[16/9] object-cover" config="my-config-name" path="example.png" :manipulations="[ 'encode' => ['jpeg', 50], 'greyscale' => true, ]" />