Image manipulation library Lumen Framework based on Imagine and inspired by Croppa for easy url based manipulation

v1.0.2 2015-07-02 14:42 UTC


Lumen Image is an image manipulation package for Lumen framework adapted from Folklore - Laravel image and based on the PHP Imagine library. It is inspired by Croppa as it can use specially formatted urls to do the manipulations. It supports basic image manipulations such as resize, crop, rotation and flip. It also supports effects such as negative, grayscale, gamma, colorize and blur. You can also define custom filters for greater flexibility.

Latest Stable Version Total Downloads License


This package is an adaptation of image manipulation library created by Folklore - Laravel image for lumen framework.

The main difference between this package and other image manipulation libraries is that you can use parameters directly in the url to manipulate the image. A manipulated version of the image is then saved in the same path as the original image, creating a static version of the file and bypassing PHP for all future requests.

For example, if you have an image at this URL:


To create a 300x300 version of this image in black and white, you use the URL:


To help you generate the URL to an image, you can use the Image::url() method



<img src="<?=Image::url('/uploads/photo.jpg',300,300,array('crop','grayscale'))?>" />

Alternatively, you can programmatically manipulate images using the Image::make() method. It supports all the same options as the Image::url() method.

    'width' => 300,
    'height' => 300,
    'grayscale' => true

or use directly the Imagine library

$thumbnail = Image::open('uploads/photo.jpg')
            ->thumbnail(new Imagine\Image\Box(300,300));




This package use Imagine for image manipulation. Imagine is compatible with GD2, Imagick, Gmagick and supports a lot of features.

This package also provides some common filters ready to use (more on this):

  • Resize
  • Crop (with position)
  • Rotation
  • Black and white
  • Invert
  • Gamma
  • Blur
  • Colorization


Dependencies: Server Requirements: Installation:
composer require ktquez/lumen-image

Inside the file bootstrap/app.php and insert the following lines




If you want to use dependency injection, just add this code in your file 'AppServiceProvider.php'

$this->app->bind('\Folklore\Image\ImageManager', function($app) {
    return $app['image'];