PHPackages                             axn/laravel-glide - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image & Media](/categories/media)
4. /
5. axn/laravel-glide

ActiveLibrary[Image & Media](/categories/media)

axn/laravel-glide
=================

league/glide wrapper for Laravel

3.0.0(1y ago)1010.6k—6.3%71MITPHPPHP ^8.4

Since Oct 27Pushed 3mo ago2 watchersCompare

[ Source](https://github.com/AXN-Informatique/laravel-glide)[ Packagist](https://packagist.org/packages/axn/laravel-glide)[ Docs](https://github.com/AXN-Informatique/laravel-glide)[ RSS](/packages/axn-laravel-glide/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (5)Versions (22)Used By (1)

Laravel Glide
=============

[](#laravel-glide)

This package provides a Service Provider that allows you to very easily integrate Glide into a Laravel project. Moreover, **multiple servers** can be configured.

Glide is a easy on-demand image manipulation library written in PHP. It's part of the League of Extraordinary Packages.

Using this package you'll be able to generate image manipulations on the fly and generate URL's to those images. These URL's will be signed so only you will be able to specify which manipulations should be generated. Every manipulation will be cached.

Upgrade
-------

[](#upgrade)

For upgrade instructions please see the `UPGRADE.md` file.

Installation
------------

[](#installation)

Install through composer:

```
composer require axn/laravel-glide
```

Environment
-----------

[](#environment)

Edit your environment file by adding the following lines:

```
GLIDE_IMAGE_DRIVER=gd
GLIDE_SIGN_KEY=SetComplicatedSignKey

```

Obviously you have to adjust the values according to your environment.

The driver can be "gd" or "imagick".

A 128 character (or larger) signing key is recommended. To help you do this, you can run the following command:

```
php artisan glide:key-generate
```

Filesytem disks
---------------

[](#filesytem-disks)

For file storage it is possible to use as many servers as desired. In order to keep an organized storage architecture, we advise you to create several disks according to their uses.

You will then create a disk in the file `/config/filesystems.php` to store our images, and another one for user avatars:

```
'disks' => [
    //...
    'images' => [
        'driver' => 'local',
        'root' => storage_path('app/images'),
    ],

    'avatars' => [
        'driver' => 'local',
        'root' => storage_path('app/images'),
    ],
    //...
],
```

Configuration
-------------

[](#configuration)

Then publish the configuration files using artisan:

```
php artisan vendor:publish --tag="glide-config"
```

These files then published are rather to be taken as an example. Take the time to read the comments to understand what you can configure.

For example in these files we have configured two servers, one for images and a second for user avatars.

The name of the filestem "source", "cache" and "watermarks" must then be the same as that of the disk in the configuration of the filesystem of the application. The path prefixes will then depend on the configured disk.

*It's not very obvious at first glance, but it gives you a lot of freedom to organize the storage of your files.*And when you understand how it works and how you can benefit from it, you will be happy with the flexibility it gives you.

After looking at these files, feel free to delete, modify and create your own files as needed.

Usage
-----

[](#usage)

Create a route for each server you have configured:

```
// App/Http/routes.php

use App\Http\Controllers\GlideController;
use Illuminate\Support\Facades\Route;

Route::get(config('glide.servers.images.base_url').'/{path}', [GlideController::class, 'images'])
    ->name('images')
    ->where('path', '(.*)');

Route::get(config('glide.servers.avatars.base_url').'/{path}', [GlideController::class, 'avatars'])
    ->name('avatars')
    ->where('path', '(.*)');
```

Create corresponding controllers/actions:

```