alex-bond/yii2-thumbler
最新稳定版本:1.2.0
Composer 安装命令:
composer require alex-bond/yii2-thumbler
包简介
Library for auto-creating thumbs of images
README 文档
README
Image Resizer with automatic cache for Yii 2
This extension allows to resize images and automatically cache them.
Installation
The preferred way to install this extension is through composer.
Either run
php composer.phar require --prefer-dist alex-bond/yii2-thumbler
or add
"alex-bond/yii2-thumbler": "*"
to the require section of your composer.json.
Usage
To use this extension, you need add the following code in your application configuration:
return [ //.... 'components' => [ 'thumbler'=> [ 'class' => 'alexBond\thumbler\Thumbler', 'sourcePath' => '/path/to/source/files', 'thumbsPath' => '/path/to/resize/cache', ], ], ];
After this just call resize() method like this:
$path = \Yii::$app->thumbler->resize('image.png',500,500);
As result of this call extension will return path to resized image relative to $thumbsPath.
Methods
resize($image, $width, $height, $method = Thumbler::METHOD_NOT_BOXED, $backgroundColor = 'ffffff', $callExceptionOnError = true)
| Parameter | Description | Possible Values |
|---|---|---|
| $image | Path to image based relative to $sourcePath | String |
| $width | Width of needed image in pixels | int |
| $height | Height of needed image in pixels | int |
| $method | Resize algorithm | Thumbler::METHOD_BOXED; Thumbler::METHOD_NOT_BOXED; Thumbler::METHOD_CROP_TOP_LEFT; Thumbler::METHOD_CROP_TOP_CENTER; Thumbler::METHOD_CROP_TOP_RIGHT; Thumbler::METHOD_CROP_MIDDLE_LEFT; Thumbler::METHOD_CROP_CENTER; Thumbler::METHOD_CROP_MIDDLE_RIGHT; Thumbler::METHOD_CROP_BOTTOM_LEFT; Thumbler::METHOD_CROP_BOTTOM_CENTER; Thumbler::METHOD_CROP_BOTTOM_RIGHT; |
| $backgroundColor | Background color for `Thumbler::METHOD_BOXED` algorithm | String (HEX color) |
| $callExceptionOnError | When `true` extension will caught exception on error. If `false` extension will just add error in internal array which can be called by `getLastError()` | boolean |
getLastError()
Returns last error description.
clearImageCache($image)
Clears all cache for selected image file.
clearAllCache()
Clears all cache.
统计信息
- 总下载量: 2.06k
- 月度下载量: 0
- 日度下载量: 0
- 收藏数: 11
- 点击次数: 1
- 依赖项目数: 0
- 推荐数: 0
其他信息
- 授权协议: BSD-3-Clause
- 更新时间: 2015-04-30