一款基于 url 的轻量级图像转换 PHP 库
EvaThumber 是一个基于URL的轻量级图片处理库,支持缩放/旋转/截取/滤镜等多种常用图片处理,支持设置水印/二维码,并且可以进行面部识别以及PNG优化压缩,所有处理仅仅需要通过更改图片的URL。
EvaThumber基于PHP实现,可以一键安装在任何主流系统,由于基于URL实现接口,所以其他编程语言也可以使用EvaThumber作为前端组件。
EvaThumber is a url based image transformation php library. See English version document.
EvaThumber的源代码存放于Github,完全开源,欢迎Fork或关注我。
下面是几个实例:
原图:
http://evathumber.avnpc.com/upload/demo.jpgEvaThumber的处理:裁剪为宽100,高100,加黑白滤镜,输出为png格式
http://evathumber.avnpc.com/thumb/d/demo,c_fill,f_gray,h_100,w_100.png按宽度缩小到150px,旋转180度,加上水印,压缩质量为60%。
http://evathumber.avnpc.com/thumb/watermark/demo,q_60,r_180,w_150.jpg
使用二维码作为水印,水印放在图片中央,缩小到原图的50%
http://evathumber.avnpc.com/thumb/watermark2/demo,p_50.jpg
在项目初期原型设计时,想要做一个图片墙功能,一般需要一些高质量的图片作为素材先看看效果,还在为一张一张找然后一张一张裁剪而感到厌烦?
EvaThumber只需要直接书写HTML,高素质的图片会自动下载并剪裁为指定尺寸展示出来:
``` html
一个典型的EvaThumber的URL形如:
http://evathumber.avnpc.com/thumb/default/abc/demo,c_fill,w_100,h_100.gif
高亮的部分分别是:
举例说明,我们的配置文件为:
'thumbers' => array(
'default' => array(
'source_path' => '/usr/www/upload',
'prefix' => 'thumb',
),
'another' => array(
'source_path' => '/usr/www/another',
),
),此时访问
http://evathumber.avnpc.com/thumb/default/abc/demo,c_fill,w_100,h_100.gif首先会找到配置文件的default片段,然后在/usr/www/upload/abc下查找文件名为demo的图片文件。
同理
http://evathumber.avnpc.com/thumb/another/foo.png会搜索/usr/www/another下的foo.*文件
很多时候我们不希望暴露原图片的地址,此时可以通过EvaThumber自动生成原图片的影子图片,保护原图片URL不被泄露,比如
假如原图片位于多级的树形目录下,影子图片也会保持与原图片同样的目录结构,从原切换到影子只需要更改域名或者根目录。
如果图片由用户上传,那么可能会遇到非常大的图片,此时可以在配置文件中设置最大尺寸限制。比如
'thumbers' => array(
'max' => array(
'max_width' => 100,
'max_height' => 100,
),
),访问当前配置下的图片,图片宽度已经被限制为100:
http://evathumber.avnpc.com/thumb/max/demo.jpgEvaThumber支持的图片格式有:
支持在任意两种格式间转换,只需要更改URL最后的扩展名即可,比如
http://evathumber.avnpc.com/thumb/d/demo,w_100.gif
http://evathumber.avnpc.com/thumb/d/demo,w_100.xbmw_[int Width]:w_允许输入一个整数,控制图片按宽度缩放,下面的URL会生成一张100px宽的图片:
http://evathumber.avnpc.com/thumb/d/demo,w_100.jpgh_[int Height]:同理h_允许输入一个整数,控制图片按高度缩放,下面的URL会生成一张50px高的图片:
http://evathumber.avnpc.com/thumb/d/demo,h_50.jpgp_[int Percent]:p_允许输入一个1-100的数字,图片会按照百分比缩放,比如p_30会将图片缩放至原尺寸的30%:
http://evathumber.avnpc.com/thumb/d/demo,p_30.jpg在缩放图片时,如果缩放尺寸大于图片本身的尺寸,操作默认会被忽略,但是也可以在配置文件中强制开启
'thumbers' => array(
'stretch' => array(
'allow_stretch' => true,
),
),此时图片允许被强制拉伸。
http://evathumber.avnpc.com/thumb/stretch/demo,w_310.jpgc_[int Crop]:c_ 允许输入一个整数,如c_50会从图片的中心位置截取出一张50px*50px的缩略图。
http://evathumber.avnpc.com/thumb/d/demo,c_50.jpgc_[int Crop] + g_[int Gracity]:配合c_输入g_,代表指定剪裁的宽度与高度,比如c_50,g_30,代表从图片中心位置剪裁一张50px*30px的缩略图。
http://evathumber.avnpc.com/thumb/d/demo,c_50,g_30.jpgx_[int X] + y_[int y]:如果想要指定剪裁的精确位置,需要用x_和y_参数指定起点坐标,x_0,y_0 以图片左上角为坐标原点。
比如 c_50,g_60,x_40,y_30 代表以距离图片左边40px,上边30px为起点,剪裁一张50px*60px的图片。
http://EvaThumber.avnpc.com/thumb/demo,c_100,g_200,x_80,y_10.jpg图片的剪裁与缩放可以混用,EvaThumber始终会先进行剪裁,然后再对剪裁后的图片缩放。
http://evathumber.avnpc.com/thumb/d/demo,c_50,g_60,x_40,y_30,w_30.jpgc_fill + w_[int Width] + h_[int Height]在实际使用中,我们经常会遇到这样的场景:需要截取并缩放图片以适应网页布局,此时我们可以使用剪裁中的填充模式,在填充模式下,需要指定剪裁参数为c_fill,同时设定填充的宽度与高度,然后可以得到一张完全吻合设定尺寸,同时经过缩放与剪裁处理的图片。
http://evathumber.avnpc.com/thumb/d/demo,c_fill,w_50,h_50.jpgr_[int Rotate]r_ 允许指定一个1-360的数字作为图片旋转的角度,比如r_90让图片按照顺时针旋转90度:
http://evathumber.avnpc.com/thumb/d/demo,r_90,w_50.pngf_[string Filter]目前支持的滤镜有:
f_gray 黑白滤镜q_[int Quality]q_ 允许指定一个1-100的参数设置jpg图片的压缩质量:
http://evathumber.avnpc.com/thumb/d/demo,w_100,q_10.jpg也可以在配置文件中设置一个全局压缩质量:
'thumbers' => array(
'd' => array(
'quality' => 70,
),
),可以在配置文件中指定layer_file为一张图片作为水印:
'thumbers' => array(
'd' => array(
'watermark' => array(
'enable' => 1,
'position' => 'br',
'layer_file' => __DIR__ . '/layers/watermark.png',
),
),
),水印的位置可以在:
tl : Top Left 左上tr : Top Right 右上bl : Bottom Left 左下br : Bottom Right 右下center : 中央同样可以直接使用文字作为水印
'thumbers' => array(
'd' => array(
'watermark' => array(
'enable' => 1,
'position' => 'br',
'layer_file' => '',
'text' => 'EvaThumber',
'font_file' => __DIR__ . '/layers/Yahei_Mono.ttf',
'font_size' => 12,
'font_color' => '#FFFFFF',
),
),
),此时必须将layer_file指定为空,同时设置:
font_file : 水印使用的ttf字体文件font_size : 字体大小font_color : 字体颜色text : 文字内容如果文字中包含中文等字符,需要ttf字体包含该字符集,否则可能出现乱码。
水印会在最后添加上去,不会受图片缩放旋转的影响。
作为扩展功能,二维码水印暂时只采用GD库生成,需要配置以下项目:
'thumbers' => array(
'd' => array(
'watermark' => array(
'enable' => 1,
'position' => 'center',
'layer_file' => '',
'text' => 'http://avnpc.com/pages/evathumber',
'qr_code' => 1,
'qr_code_size' => 2,
'qr_code_margin' => 1,
),
),
),qr_code 是否启用二维码 1/0qr_code_size 二维码大小qr_code_margin 二维码内边距通过设置d_dummy可以自动获得优质的图片素材,EvaThumber内置了两个默认图片源:
当自动素材功能启用时,图片路径可随意填写:
http://evathumber.avnpc.com/thumb/d/foo,c_fill,d_picasa,h_100,w_100.jpg
http://evathumber.avnpc.com/thumb/d/bar,c_fill,d_flickr,h_100,w_100.jpg如果在配置文件中指定source_path为一个ZIP压缩包文件,则可以直接从压缩包中读取图片信息无需解压。比如
'thumbers' => array(
'zip' => array(
'source_path' => __DIR__ . '/upload/archive.zip',
'zip_file_encoding' => 'GB2312',
),
),如果压缩包中路径或文件名含有非英语字符,则需要指定压缩包压缩时的系统编码,一般来说中文系统需要指定为GB2312。
如压缩包内文件结构为
- archive.zip
- archive/
zipimage.jpg
中文.jpg访问
http://evathumber.avnpc.com/thumb/zip/archive/zipimage,w_100.jpghttp://evathumber.avnpc.com/thumb/zip/archive/中文,w_100.jpg剪裁图片时默认的方式是通过指定x_和y_坐标来选择剪裁的区域,不过如果是带有人物的图片,可以试试使用c_face去自动识别人物面部坐标,比如下图
http://evathumber.avnpc.com/thumb/d/face,w_100.jpg使用默认的剪裁方式:
http://evathumber.avnpc.com/thumb/d/face,c_100.jpg使用面部识别:
http://evathumber.avnpc.com/thumb/d/face,c_face,w_100,h_100.jpgEvaThumber可以对PNG图片进行无损优化,优化基于PNGOut项目,下载pngout.exe到bin文件夹,配置以下项目:
'thumbers' => array(
'png' => array(
'png_optimize' => array(
'enable' => 1,
'pngout' => array(
'bin' => __DIR__ . '/bin/pngout.exe',
),
),
),
),对比一下有无图片优化的效果:
图片的动态生成,在实际部署上可能会带来两方面的问题:
对于问题1,EvaThumber采用如下的方法应对:
EvaThumber对于同样操作的请求,以及带有多余参数的请求,都会被重定向到唯一的一个URL地址,比如
http://evathumber.avnpc.com/thumb/d/demo,w_1000.jpg 宽度超出http://evathumber.avnpc.com/thumb/d/demo,x_10.jpg 不必要参数http://evathumber.avnpc.com/thumb/d/demo,,,,.jpg 错误参数等等情况,都会被重定向到唯一的URLhttp://evathumber.avnpc.com/thumb/d/demo.jpg。从而保证缓存尽可能少的产生。
在大部分Web应用中,其实图片都会被缩放为固定的几个尺寸,所以可以在配置文件中指定允许被缩放的尺寸:
'thumbers' => array(
'd' => array(
'allow_sizes' => array(
'200*100',
),
),
),此时图片只允许被缩放为w_200,h_100
EvaThumber所提供的功能并不一定能全部用到,可以在配置文件中禁用某些操作
'thumbers' => array(
'd' => array(
'disable_operates' => array(
'filter',
'rotate',
'dummy',
),
),
),可以禁用的操作包括:
在正式环境中,可以同时设置允许尺寸以及禁用操作。典型的场景如用户上传头像,配置文件设置为:
'thumbers' => array(
'd' => array(
'max_width' => 300,
'max_height' => 300,
'allow_sizes' => array(
'200*200',
'100*100',
'50*50',
),
'disable_operates' => array(
'dummy',
'filter',
'gravity',
'percent',
'quality',
'rotate',
'x',
'extension',
),
),
),
…
cd /opt/htdocs
git clone git://github.com/AlloVince/EvaThumber.git
cd EvaThumber
composer install然后访问http://localhost/EvaThumber/index.php/thumb/d/demo.jpg 即可看到示例的Demo图片并进行操作了。
基础功能包括:
如果已经有Composer,再EvaThumber目录下直接运行即可支持基础功能:
composer install如果没有安装Composer,参考下文:
假设php.exe目录在d:\xampp\php,那么首先将php目录加入windows环境变量。
cd d:\\xampp\php
php -r "eval('?>'.file_get_contents('https://getcomposer.org/installer'));"同目录下编辑文件 composer.bat,内容为
@ECHO OFF
SET composerScript=composer.phar
php "%~dp0%composerScript%" %*运行
composer -V检查composer安装是否成功。
以Ubuntu为例
apt-get install curl
cd /usr/local/bin
curl -s http://getcomposer.org/installer | php
chmod a+x composer.phar
alias composer='/usr/local/bin/composer.phar'开启URL Rewirte之后,可以省略URL中的index.php部分,如果已经生成缓存,则会优先显示缓存,所以在生产环境中是必须要打开的。
如果服务器为Apache并且已经开启mod_rewrite模块,则无需任何设置,重写规则已经写入.htaccess文件。
请参考以下配置调整路径
server {
listen 80;
server_name evathumber.avnpc.com;
location / {
root /usr/www/EvaThumber/;
index index.php index.html index.htm;
if (!-e $request_filename){
rewrite ^/(.*)$ /index.php last;
}
}
location ~ \.php$ {
include fastcgi_params;
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME /usr/www/EvaThumber/$fastcgi_script_name;
}
}因为配置文件可能经常需要修改,如果采用了GIT或SVN这样的版本控制工具非常容易引起冲突,所以这里并不推荐直接编辑config.default.php文件。
推荐的方法是新建一个config.local.php文件放于EvaThumber目录下,内容则与config.default.php保持同样的结构,所有的项目会自动复写默认设置。
缓存启用依赖于URL
暂无开放 Issues,或尚未同步最近议题。