daxslab/yii2-thumbnailer Yii2 component to generate image thumnails of any size


Yii2 Thumbnailer

Build Status Latest Stable Version Total Downloads Latest Unstable Version License

Yii2 component to generate image thumnails of any size.


The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist daxslab/yii2-thumbnailer "*"

or add

"daxslab/yii2-thumbnailer": "*"

to the require section of your composer.json file.


The basic configuration only requires adding the component to the application:

'components' => [
    'thumbnailer' => [
        'class' => 'daxslab\thumbnailer\Thumbnailer',

Besides that a default value is always provided, all the options can be configured.

'components' => [
    'thumbnailer' => [
        'class' => 'daxslab\thumbnailer\Thumbnailer',
        'defaultWidth' => 500,
        'defaultHeight' => 500,
        'thumbnailsBasePath' => '@webroot/assets/thumbs',
        'thumbnailsBaseUrl' => '@web/assets/thumbs',
        'enableCaching' => true, //defaults to false but is recommended


Once the extension is configured, simply use it in your views by:

//Generates thumbnail with default values specified in the configuration

//Generates a 400px width thumbnail. The height is determined as the width because is not set. 
Html::img(Yii::$app->thumbnailer->get($imageUrl, 400));

//Generates a 400x400 pixels thumbnail and 60% quality 
Html::img(Yii::$app->thumbnailer->get($imageUrl, 400, 400));

//Generates a 400x400 pixels thumbnail and 10% quality
Html::img(Yii::$app->thumbnailer->get($imageUrl, 400, 400, 10));

//Generates a 400x400 pixels thumbnail, 10% quality and not cropping the image
//but inserting it into a box with the specified dimensions.
Html::img(Yii::$app->thumbnailer->get($imageUrl, 400, 400, 10, ManipulatorInterface::THUMBNAIL_INSET));

Proudly made by Daxslab.


Yii2 Thumbnailer

1.1.0 February 26, 2018

  • Enh: Uses cache component to store the URLs of the already generated thumbnails instead of querying the filesystem like before.
  • Enh: Now default values can be set in the configuration.
  • Enh: Added this CHANGELOG.md
  • Enh: Source code comments.
  • Enh: Improvements of instructions in the README.md

1.0.0 December 24, 2017

  • Initial release.


GitHub Stars
GitHub Forks



1.2.0 is the latest of 9 releases

MIT license
9 github stars & 4 github forks
0 downloads in the last day
116 downloads in the last 30 days
12626 total downloads