Fork me on GitHub
The League of Extraordinary Packages

Our Packages:

Presented by The League of Extraordinary Packages

Getting Started


Image API

Simple example

Say you’re creating a user profile page that displays a user’s name and profile photo. The user has already uploaded an image, but it hasn’t been resized. All you have is the original file saved somewhere. The following example illustrates how easy Glide makes cropping and resizing the profile image without having to do any image processing ahead of time.

In your templates

In your templates simply define how the image will be manipulated. Using Glide’s HTTP based API, set the image manipulations in the profile image’s src attribute.


<!-- display profile image cropped to 300x400 -->
<img src="/img/users/<?=$user->id?>.jpg?w=300&h=400&fit=crop">

For simplicity this example has omitted HTTP signatures, however in a production environment it's very important to secure your images.

In your routes

Next, within your routes, setup your Glide server. Configure where the source images can be found, as well as where the manipulated images should be saved (the cache). Finally pass the server the request. It will handle all the image manipulations and will output the image.


// Setup Glide server
$server = League\Glide\ServerFactory::create([
    'source' => 'path/to/source/folder',
    'cache' => 'path/to/cache/folder',

// You could manually pass in the image path and manipulations options
$server->outputImage('users/1.jpg', ['w' => 300, 'h' => 400]);

// But, a better approach is to use information from the request
$server->outputImage($path, $_GET);

While the outputImage() method works okay, the getImageResponse() method is recommended. This allows your application to handle the outputting of the manipulated images. This approach does require a little more configuration. See responses for more info.