README

Out of the box solution for Glide PHP for Laravel providing a fluent interface for the Glide API.

Full Docs & Examples are here: https://ampedweb.github.io/laravel-glide-in-a-box/

If you would like to use JUST the Fluent URL Builder in your project you can find that here: https://github.com/ampedweb/glide-url-helper. Docs are currently a work in progress there...!

Requirements

PHP >= 7.3 with the following extensions:
- Exif
- GD or ImageMagick
league/glide-laravel": "^1.6",

Features

Automatically signed urls when using the glide_url() helper function.
A fluent interface for all glide image api see here: https://glide.thephpleague.com

Installation

composer require ampedweb/laravel-glide-in-a-box

Publish the config file:

php artisan vendor:publish --tag=glideinabox

Basic Usage

The base url "out of the box" for all glide image url requests is "/img/". You can adjust this in the glideinabox.php config file once you have published it.

Using the glide_url() helper function should make building your image urls simple.

An example using a preset as a base and then making a few alterations using the fluent methods:

glide_url($pathToYourImageFile)->preset('medium')->filter('sepia')->url();

// You can also cast the FluentUrlBuilder to a string:

$url = (string)glide_url($pathToYourImageFile)->preset('medium')->filter('sepia'); 

// Or print it:

print glide_url($pathToYourImageFile)->preset('medium')->filter('sepia');

// Or use it directly in your blade templates:

{{ glide_url($pathToYourImageFile)->preset('medium')->filter('sepia') }}

There are also predefined constants if you prefer using those rather than strings, e.g:

use AmpedWeb\GlideUrl\Interfaces\Filter;

glide_url($pathToYourImageFile)->preset('medium')->filter(Filter::SEPIA)->url();

You can also build a completely custom image with no preset. Below is a 200x100 px cropped webp image at 50% quality:

use AmpedWeb\GlideUrl\Interfaces\Fit;

glide_url($pathToYourImageFile)->size(200,100)->fit(Fit::CROP)->webp(50)->url();

Always remember to call the ->url() method when you are done configuring your image.

Extension

If you would like to use your own image controller but still use the base functionality from the package then you will need to extend:

AmpedWeb\GlideInABox\Controller\GlideImageController;

Running Tests:

php vendor/bin/phpunit

ampedweb / laravel-glide-in-a-box

Maintainers

Details