doris/yii2-compressor

library for compress images by doris api

Установка и настройка

composer require doris/yii2-compressor "*", _(*1)

Для установки ключа и домена в common/config/params необходимо положить следующие настройки:
, _(*2)

'ImageCompressor' => [
      'key' => "Ключ для текущего сайта",
      'domain' => "Домен на который будет отправлятся запрос"
]

Параметры:, _(*3)

• $key - Ключ который генерируется на сайте и привязан к определенному проекту.
• $domain - Домен с протоколом, к примеру http://test.com.ua

Работа с сайта

Пример использования:
, _(*4)

use doris\compressor\CompressorApi;

try {
$compressor = new CompressorApi();
$compressor->setPathToImage('/images/test.png')
    ->setPathToSave('/uploads/products')
    ->setAlias('@web')
    ->setCustomName('mockup')

$imagePath = $compressor->compress(77);

catch (Exception $e) {
    $message = $e->getMessage();
}

Класс CompressorApi имеет ряд сеттеров (реализован паттерн текучего интерфейса):, _(*5)

• setPathToImage - путь к картинке относительно заданого псевдонима. Обязательно.
• setPathToSave - путь к дериктории для сохранения изображения относительно заданого псевдонима. Если не задан - картинка будет перезаписана. Опционально.
• setAlias - задает псевдоним пути. По умолчанию '@webroot'. Опционально.
• setCustomName - устанавливает новое имя для сжатой картинки. Опционально.

И несколько методов:, _(*6)

• compress - возвращает валидный путь для подключения картинки на сайте. Принимает параметр указывающий степень сжатия (от 0 до 100). По умолчанию 85.
• deleteOriginal - удаляет оригинал картинки. Возвращает результат удаления как true или false.

Каждая ошибка (к примеру если по указаному пути картинка не была найдена) генерирует exception по-этому рекомендуется использовать конструкцию try catch для его обработки., _(*7)

Работа с консоли

Если есть желание использовать библиотеку с консоли стоит зарегистрировать модуль в console/config/main, _(*8)

'modules' => [
    'compressor' => 'doris\compressor\Modules\Console\Handler',
],

Команда для сжатия картинок через консоль:, _(*9)

yii compressor $path $recursive

Параметры:, _(*10)

• $path - Путь к изображением начиная с web. К примеру \images. Обязательно.
• $recursive - Флаг который указывает нужно ли перебирать дочерние дериктории. Если true - будет перебирать все вложенные дериктории. По умолчанию true. Опционально.