Facade of Tinify API for Yii2 Framework

Installs: 5 954

Dependents: 0

Suggesters: 0

Security: 0

Stars: 2

Watchers: 3

Forks: 2


2.1.0 2018-03-12 18:59 UTC

This package is not auto-updated.

Last update: 2024-06-21 22:01:53 UTC


Tinify API

Facade of Tinify API for Yii2 Framework. This extension allows you to resize and compress images without loss of quality. For more information you can read official API documentation for PHP.

Build Status Scrutinizer Code Quality Total Downloads Latest Stable Version Latest Unstable Version


The preferred way to install this extension is through composer.

Either run

$ composer require vintage/yii2-tinify

or add

"vintage/yii2-tinify": "~2.1"

to the require section of your composer.json.



  1. Configure API token in app params with key tinify-api-token or in UploadedFile component
  2. Use \vintage\tinify\UploadedFile instead of \yii\web\UploadedFile

If you need to save some metadata, for example location, you can configure saveMetadata option like follow

use vintage\tinify\UploadedFile;

$file = UploadedFile::getInstance($model, 'image');
$file->saveMetadata = UploadedFile::METADATA_LOCATION;
// or more items
$file->saveMetadata = [UploadedFile::METADATA_LOCATION, UploadedFile::METADATA_CREATION];

Upload files to AWS S3 storage

  1. Configure AWS S3 service in config/params-local.php
use vintage\tinify\UploadedFileS3;

return [
    // ...
    UploadedFileS3::PARAM_KEY_AWS_ACCESS_KEY_ID         => '',
    UploadedFileS3::PARAM_KEY_AWS_SECRET_ACCESS_KEY     => '',
    UploadedFileS3::PARAM_KEY_S3_REGION                 => '',
    UploadedFileS3::PARAM_KEY_S3_BUCKET                 => '',
  1. Use \vintage\tinify\UploadedFileS3 insead of \vintage\tinify\UploadedFile
  2. Provide region and bucket name in methods calls
$file = UploadedFile::getInstance($model, 'image')->saveAs('image.jpg');

also you can override region and bucket

$file = UploadedFile::getInstance($model, 'image')
    ->setPath('images-bucket/uploads') // path must be provided without slash in the end


You can resize uploaded file

$file = \vintage\tinify\UploadedFile::getInstance($model, 'image');
$file->resize() // creates \vintage\tinify\components\TinifyResize object
    ->fit() // resize algorithm, also you can use scale() and cover()
    ->width(600) // set image width
    ->height(400) // set image height
    ->process(); // resize image

or resize existing image

(new \vintage\tinify\components\TinifyResize('@webroot/uploads/image.jpg'))


  1. Configure console controller in console/config/main.php
'controllerMap' => [
    // ...
    'tinify' => \vintage\tinify\cli\TinifyController::class,
  1. Run in console ./yii tinify/<command>

    Command Description
    $ ./yii tinify/test-connect [api-token] Test connection to API
    $ ./yii tinify/compress '/path/to/src.jpg' '/path/to/dest.jpg' Compress image
    $ ./yii tinify/compress-catalog '/path/to/catalog' Compress all images in catalog
    $ ./yii tinify/count Display compression images count


You can run tests with composer command

$ composer test

or using following command

$ codecept build && codecept run



This project is released under the terms of the BSD-3-Clause license.