yurkinx / yii2-image
Yii2 extension for image manipulating using Kohana Image Library.
Installs: 343 189
Dependents: 21
Suggesters: 0
Security: 0
Stars: 65
Watchers: 17
Forks: 35
Open Issues: 5
Type:yii2-extension
Requires
- php: >=5.4.0
- yiisoft/yii2: *
This package is not auto-updated.
Last update: 2024-10-26 14:07:15 UTC
README
Simple to use Yii2 Framework extension for image manipulating using powerful Kohana Image Library. Inspired by old yii extension http://www.yiiframework.com/extension/image/ and Kohana Image Library https://github.com/kohana/image
Installation
Install as a composer package
Use this method to get continuous updates.
composer require yurkinx/yii2-image
or include the dependency in the composer.json
file:
{ "require": { "yurkinx/yii2-image": "^1.2" } }
Configuration
In config file
/config/web.php
Add image component
'components' => array(
...
'image' => array(
'class' => 'yii\image\ImageDriver',
'driver' => 'GD', //GD or Imagick
),
)
Usage
$file=Yii::getAlias('@app/pass/to/file'); $image=Yii::$app->image->load($file); header("Content-Type: image/png"); echo $image->resize($width,$height)->rotate(30)->render();
Supported methods out of the box from Kohana Image Library:
$image->resize($width = NULL, $height = NULL, $master = NULL); $image->crop($width, $height, $offset_x = NULL, $offset_y = NULL); $image->sharpen($amount); $image->rotate($degrees); $image->save($file = NULL, $quality = 100); $image->render($type = NULL, $quality = 100); $image->reflection($height = NULL, $opacity = 100, $fade_in = FALSE); $image->flip($direction); $image->background($color, $opacity = 100); $image->watermark(Image $watermark, $offset_x = NULL, $offset_y = NULL, $opacity = 100);
Using resize with resize constrains
$image->resize($width, $height, \yii\image\drivers\Image::HEIGHT); $image->resize($width, $height, \yii\image\drivers\Image::ADAPT)->background('#fff');
Using resize with resize constrains and best quality output image [for Imagick driver only]
Use 1 for best speed and lower quality, 100 for best quality and lower speed. Only values 1,100 currently supported
$image->resize($width, NULL, \yii\image\drivers\Image::WIDTH, 100);
Possible resize constrains:
// Resizing constraints ($master) const NONE = 0x01; const WIDTH = 0x02; const HEIGHT = 0x03; const AUTO = 0x04; const INVERSE = 0x05; const PRECISE = 0x06; const ADAPT = 0x07; const CROP = 0x08;
Using flip with flipping directions
// Flipping directions ($direction) $image->flip(\yii\image\drivers\Image::HORIZONTAL);
Possible flipping directions:
const HORIZONTAL = 0x11; const VERTICAL = 0x12;