Lawondyss / Imager 1.6.2

The library for manage images and thumbnails. Library uses ImageMagick in command line.

download-cloud-line composer require lawondyss/imager


Imager is manager for images and thumbnails.


Installation performed by Composer. Write to command line composer require lawondyss/imager.


Library used ImageMagick over command line. Is necessary have ImageMagick installed in system.

Generating image cannot be greater than 200 % of original image.


Create thumbnails

// Image accepts argument of image as instance of class Imager\ImageInfo (extends SplFileInfo)
$imageInfo = new Imager\ImageInfo('path/to/image.jpg');
$image = new Imager\Image($imageInfo);

// create over factory
// ImageFactory::create() accepts image name in string or instance of ImageInfo
$factory = new Imager\ImageFactory;
$image = $factory->create('path/to/image.jpg');

/** Thumbnails **/
// resize by width
$thumb = $image->resize(100); // instance of Imager\ImageInfo with temporary image
var_dump($thumb->getPathname()); // path to thumbnail

// resize by height
$thumb = $image->resize(null, 100);

// resize with crop, cropped image is centered
$thumb = $image->resize(100, 100);

// origin dimensions
$thumb = $image->resize(0, 0);

/** Quality **/
// set in third parameter, lower is worse, 0 is default quality
$thumb = $image->resize(0, 0, 25);

/** Send image to output **/
header('Content-Type: ' . $thumb->getMime());
header('Content-Length: ' . $thumb->getSize());
echo $thumb->getContent();

Repository for sources images and thumbnails

$factory = new Imager\ImageFactory;

// first argument is required; is directory with sources
// second argument is optional; is directory for thumbnails; if not set, then is same as directory for sources; autocreated 
$repository = new Imager\Repository('path/to/sources', 'path/to/thumbnails');

// create ImageInfo of source image
$uploadImageInfo = $factory->createInfo('path/to/uploaded/image.jpg');

// source image has not source, therefore save to sources directory
// second optional argument defined new name for saved image
$sourceImageInfo = $repository->save($uploadImageInfo, 'image.jpg'); // instance of Imager\ImageInfo with saved source image

// fetch source image only by name
$imageInfo = $repository->fetch('image.jpg'); // instance of Imager\ImageInfo with source image

// created thumbnail
$thumb = $factory->create($imageInfo)->resize(100); // instance of Imager\ImageInfo with temporary thumbnail of image

// thumbnail has source, therefore save to thumbnails directory
$thumbImageInfo = $repository->save($thumb); // instance of Imager\ImageInfo with saved thumbnail

Nette extension

For registration Imager as Nette extension is required add this configuration.

    imager: Imager\DI\Extension

Extension has this configuration:

    sourcesDir: %appDir%/../cdn/assets # required
    thumbsDir: %wwwDir%/images/thumbs
    baseUrl: # if is your images in another URL 
    basePath: images/thumbs/ # required; adds this path to URL
    errorImage: on # default on; displays error image if when generating an error occurred
    debugger: on # default as debugMode; display information in debug bar; WARNING! For every image send new HEAD request!

Example with extension

Presenter for upload and show images

class ImagerPresenter extends BasePresenter
    /** @var \Imager\Repository @inject */
    public $repository;

    /** @var \Imager\ImageFactory @inject */
    public $factory;

    public function renderDefault($id)
        if (isset($id)) {
            $this->template->imageFromString = $id;
            $this->template->imageFromRepository = $this->repository->fetch($id);

    protected function createComponentUploadForm()
        $control = new Nette\Application\UI\Form;

        $control->addSubmit('load', 'load image');
        $control->onSuccess[] = $this->uploadFormSucceed;

        return $control;

    public function uploadFormSucceed(Nette\Application\UI\Form $form, $values)
        $upload = $this->factory->createInfo($values->photo->getTemporaryFile());
        $source = $this->repository->save($upload);

        $this->redirect('default', $source->getFilename());

Latte template

{block content}
{control uploadForm}
{ifset $image}
    <img src="$imageFromRepository, 200, 0"> {* set width, origin height *}
    <img src="$imageFromRepository, 200, 300"> {* set width and height *}
    <img src="$imageFromRepository, null, 300"> {* resize by height *}
    <img src="$imageFromRepository, 200"> {* resize by width *}
    <img src="$imageFromRepository"> {* origin width and height *}

    {* set quality *}
    <img src="$imageFromRepository, null, null, 25"> {* origin width and height, but lowest quality *}

    {* same parameters as for $imageFromRepository *}
    <img src="$imageFromString">


Link to image

If you required create link to image (example to e-mail), then is here method ImageFactory::createLink(). Create a link is only possible when integrating into the Nette.

class EmailPresenter extends BasePresenter
    /** @var \Imager\ImageFactory @inject */
    public $factory;

    public function actionSendEmail($email)
        // ... defines $images as array with Imager\ImageInfo objects or names of images

        $linksHtml = [];
        foreach ($images as $image) {
          $linksHtml = $this->createImg($this, $image);

        // ... functionality for send e-mail

    private function createImg($image, $width = null, $height = null)
        $link = $this->factory->createLink($this, $image, $width, $height);
        $img = Nette\Utils\Html::el('img', ['src' => $link]);

        return $img->render();
  • 1.6.2 Fixed error of unreturned IRequest from Route::match()

  • 1.6.1 Changed version of required Nette\Utils

  • 1.6 Changed JS in panel from jQuery to naturally JS

  • 1.5 Added check for generating too much size of image

  • 1.4 Set quality for resized image

  • 1.3 Added new functionality and simplified use

  • 1.2 Changed show error information in headers of image

  • 1.1 Nette extension







Componette Componette