michielkempen/laravel-glide

Leverage Glide to perform on the fly image manipulations in Laravel.

0.3.1 2021-11-29 13:30 UTC

Requires

• php: ^7.1|^8.0
• illuminate/http: ^5.5|^6.0|^7.0|^8.0
• illuminate/support: ^5.5|^6.0|^7.0|^8.0
• league/glide-laravel: ^1.0

MIT

• Michiel Kempen

• laravel
• glide
• Michiel Kempen

README

Leverage Glide to perform on the fly image manipulations in Laravel.

Installation

Add the package to the dependencies of your application.

composer require michielkempen/laravel-glide

Configuration

Configure the package using environment variables.

<?php

return [

    'source' => [

        /*
         * The filesystem where the original files are stored.
         */
        'filesystem' => env('GLIDE_SOURCE_FILESYSTEM', 'public'),

        /*
         * The path within the filesystem where the original files are stored.
         */
        'path' => env('GLIDE_SOURCE_PATH', ''),

    ],

    'cache' => [

        /*
         * The filesystem where the manipulated files will be cached.
         */
        'filesystem' => env('GLIDE_CACHE_FILESYSTEM', 'public'),

        /*
         * The path within the filesystem where the manipulated files will be cached.
         */
        'path' => env('GLIDE_CACHE_PATH', 'cache/'),

    ],

    /*
     * The secret that is used to sign the manipulation requests.
     */
    'secret' => env('GLIDE_SECRET', 'secret'),

    /*
     * The prefix of the original files endpoint.
     */
    'file_endpoint_prefix' => env('FILE_ENDPOINT_PREFIX', '/storage/'),

    /*
     * The prefix of the manipulated files endpoint.
     */
    'glide_endpoint_prefix' => env('GLIDE_ENDPOINT_PREFIX', '/glide/'),

];

Usage

Here's a quick example that shows how an image can be modified:

$manipulatedImageUrl = glide($fileName, ['w'=> 50, 'filt'=>'greyscale']);

Take a look at Glide's image API to see which parameters you can pass to the method.

License

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