vintage / yii2-tinify
Facade of Tinify API for Yii2 Framework
Installs: 6 649
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 2
Forks: 2
Type:yii2-extension
Requires
- tinify/tinify: ~1.1
- yiisoft/yii2: ~2.0.0
Requires (Dev)
This package is not auto-updated.
Last update: 2024-11-08 23:37:32 UTC
README
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.
Installation
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
.
Usage
Component
- Configure API token in app params with key
tinify-api-token
or inUploadedFile
component - 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
- 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 => '', ];
- Use
\vintage\tinify\UploadedFileS3
insead of\vintage\tinify\UploadedFile
- 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') ->setRegion('us-west-1') ->setPath('images-bucket/uploads') // path must be provided without slash in the end ->saveAs('image.jpg');
Resizing
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 $file->saveAs('@webroot/uploads');
or resize existing image
(new \vintage\tinify\components\TinifyResize('@webroot/uploads/image.jpg')) ->scale() ->width(600) ->process();
CLI
- Configure console controller in
console/config/main.php
'controllerMap' => [ // ... 'tinify' => \vintage\tinify\cli\TinifyController::class, ],
-
Run in console
./yii tinify/<command>
Tests
You can run tests with composer command
$ composer test
or using following command
$ codecept build && codecept run
Licence
This project is released under the terms of the BSD-3-Clause license.