dashed/laravel-drift

Fund package maintenance!
Dashed-DEV

v1.0.15 2024-08-27 11:52 UTC

This package is auto-updated.

Last update: 2024-10-27 12:13:38 UTC


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,
    ]"
/>