安装扩展

使用Composer安装ThinkPHP5的图像处理类库:

  1. composer require topthink/think-image

图像操作

下面来看下图像操作类的基础方法。

打开图像文件

假设当前入口文件目录下面有一个image.png文件,如图所示:

图像处理 - 图1

使用open方法打开图像文件进行相关操作:

  1. $image = \think\Image::open('./image.png');

也可以从直接获取当前请求中的文件上传对象,例如:

  1. $image = \think\Image::open(request()->file('image'));

获取图像信息

可以获取打开图片的信息,包括图像大小、类型等,例如:

  1. $image = \think\Image::open('./image.png');
  2. // 返回图片的宽度
  3. $width = $image->width();
  4. // 返回图片的高度
  5. $height = $image->height();
  6. // 返回图片的类型
  7. $type = $image->type();
  8. // 返回图片的mime类型
  9. $mime = $image->mime();
  10. // 返回图片的尺寸数组 0 图片宽度 1 图片高度
  11. $size = $image->size();

裁剪图片

使用cropsave方法完成裁剪图片功能。

  1. $image = \think\Image::open('./image.png');
  2. //将图片裁剪为300x300并保存为crop.png
  3. $image->crop(300, 300)->save('./crop.png');

生成的图片如图:

图像处理 - 图2

支持从某个坐标开始裁剪,例如下面从(100,30)开始裁剪,例如:

  1. $image = \think\Image::open('./image.png');
  2. //将图片裁剪为300x300并保存为crop.png
  3. $image->crop(300, 300,100,30)->save('./crop.png');

生成的图片如图:

图像处理 - 图3

生成缩略图

使用thumb方法生成缩略图,例如:

  1. $image = \think\Image::open('./image.png');
  2. // 按照原图的比例生成一个最大为150*150的缩略图并保存为thumb.png
  3. $image->thumb(150, 150)->save('./thumb.png');

生成的缩略图如图所示:

我们看到实际生成的缩略图并不是150*150,因为默认采用原图等比例缩放的方式生成缩略图,最大宽度是150。可以支持其他类型的缩略图生成,设置包括\think\Image的下列常量或者对应的数字:

  1. //常量,标识缩略图等比例缩放类型
  2. const THUMB_SCALING = 1;
  3. //常量,标识缩略图缩放后填充类型
  4. const THUMB_FILLED = 2;
  5. //常量,标识缩略图居中裁剪类型
  6. const THUMB_CENTER = 3;
  7. //常量,标识缩略图左上角裁剪类型
  8. const THUMB_NORTHWEST = 4;
  9. //常量,标识缩略图右下角裁剪类型
  10. const THUMB_SOUTHEAST = 5;
  11. //常量,标识缩略图固定尺寸缩放类型
  12. const THUMB_FIXED = 6;

比如我们居中裁剪:

  1. $image = \think\Image::open('./image.png');
  2. // 按照原图的比例生成一个最大为150*150的缩略图并保存为thumb.png
  3. $image->thumb(150,150,\think\Image::THUMB_CENTER)->save('./thumb.png');

后生成的缩略图效果如图:

图像处理 - 图4

再比如我们右下角剪裁

  1. $image = \think\Image::open('./image.png');
  2. // 按照原图的比例生成一个最大为150*150的缩略图并保存为thumb.png
  3. $image->thumb(150,150,\think\Image::THUMB_SOUTHEAST)->save('./thumb.png');

生成的缩略图效果如图:

图像处理 - 图5

这里就不再对其他用法一一举例了。

图像翻转

使用flip可以对图像进行翻转操作,默认是以x轴进行翻转,例如:

  1. $image = \think\Image::open('./image.png');
  2. // 对图像进行以x轴进行翻转操作
  3. $image->flip()->save('./filp_image.png');

生成的效果如图:

图像处理 - 图6

我们也可以改变参数,以y轴进行翻转,例如:

  1. $image = \think\Image::open('./image.png');
  2. // 对图像进行以y轴进行翻转操作
  3. $image->flip(\think\image::FLIP_Y)->save('./filp_image.png');

生成的效果如图:

图像处理 - 图7

图像的翻转可以理解为图像的镜面效果与图像旋转有所不同。

图像旋转

使用rotate可以对图像进行旋转操作(默认是顺时针旋转90度),我们用默认90度进行旋转举例:

  1. $image = \think\Image::open('./image.png');
  2. // 对图像使用默认的顺时针旋转90度操作
  3. $image->rotate()->save('./rotate_image.png');

生成的效果如图:

图像处理 - 图8

图像保存参数

save方法可以配置的参数

参数默认描述
pathname必填项图像保存路径名称
type默认与原图相同图像类型
quality80图像质量
interlacetrue是否对JPEG类型图像设置隔行扫描
设置隔行扫描的情况下在网页进行浏览时。是从上到下一行一行的显示,否则图片整个显示出来 然后由模糊到清晰显示。

添加水印

系统支持添加图片及文字水印,下面依次举例说明添加图片水印,我们下载官网logo文件到根目录进行举例:

  1. $image = \think\Image::open('./image.png');
  2. // 给原图左上角添加水印并保存water_image.png
  3. $image->water('./logo.png')->save('water_image.png');

water方法的第二个参数表示水印的位置,默认值是WATER_SOUTH,可以传入下列\think\Image类的常量或者对应的数字:

  1. //常量,标识左上角水印
  2. const WATER_NORTHWEST = 1;
  3. //常量,标识上居中水印
  4. const WATER_NORTH = 2;
  5. //常量,标识右上角水印
  6. const WATER_NORTHEAST = 3;
  7. //常量,标识左居中水印
  8. const WATER_WEST = 4;
  9. //常量,标识居中水印
  10. const WATER_CENTER = 5;
  11. //常量,标识右居中水印
  12. const WATER_EAST = 6;
  13. //常量,标识左下角水印
  14. const WATER_SOUTHWEST = 7;
  15. //常量,标识下居中水印
  16. const WATER_SOUTH = 8;
  17. //常量,标识右下角水印
  18. const WATER_SOUTHEAST = 9;

我们用左上角来进行测试:

  1. $image = \think\Image::open('./image.png');
  2. // 给原图左上角添加水印并保存water_image.png
  3. $image->water('./logo.png',\think\Image::WATER_NORTHWEST)->save('water_image.png');

生成的图片效果如下:

图像处理 - 图9

还可以支持水印图片的透明度(0~100,默认值是100),例如:

  1. $image = \think\Image::open('./image.png');
  2. // 给原图左上角添加透明度为50的水印并保存alpha_image.png
  3. $image->water('./logo.png',\think\Image::WATER_NORTHWEST,50)->save('alpha_image.png');

生成的图片效果如下:

图像处理 - 图10

也可以支持给图片添加文字水印(我们复制一个字体文件HYQingKongTiJ.ttf到入口目录),我们现在生成一个像素20px,颜色为#ffffff的水印效果:

  1. $image = \think\Image::open('./image.png');
  2. // 给原图左上角添加水印并保存water_image.png
  3. $image->text('十年磨一剑 - 为API开发设计的高性能框架','HYQingKongTiJ.ttf',20,'#ffffff')->save('text_image.png');

生成的图片效果:

图像处理 - 图11

文字水印参数

文字水印比较多,在此只做说明不做演示了

参数默认描述
text不能为空添加的文字
font不能为空字体文件路径
size不能为空字号,单位是像素
color#00000000文字颜色
locateWATER_SOUTHEAST文字写入位置
offset0文字相对当前位置的偏移量
angle0文字倾斜角度