qubiqx / laravel-drift-less
Fund package maintenance!
larsklopstra
Requires
- php: ^8.0
- illuminate/http: ^9.4
- illuminate/support: ^9.4
- intervention/image: ^2.7
README
Optimize images on the fly.
Installation
You can install the package via composer:
composer require qubiqx/laravel-drift
Usage
Simply install the package, and register a configuration in AppServiceProvider@boot
:
use Qubiqx\Drift\Config; use Qubiqx\Drift\DriftManager; use Qubiqx\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 \Qubiqx\Drift\UrlBuilder
like so:
use Qubiqx\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, ]" />