图像处理
最后更新于:2022-04-02 01:55:12
## 安装扩展
使用`Composer`安装`ThinkPHP5`的图像处理类库:
~~~
composer require topthink/think-image
~~~
## 图像操作
下面来看下图像操作类的基础方法。
### 打开图像文件
假设当前入口文件目录下面有一个`image.png`文件,如图所示:
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/88e25fed9c22b2333334799f8484f952_768x432.png)
使用`open`方法打开图像文件进行相关操作:
~~~
$image = \think\Image::open('./image.png');
~~~
也可以从直接获取当前请求中的文件上传对象,例如:
~~~
$image = \think\Image::open(request()->file('image'));
~~~
### 获取图像信息
可以获取打开图片的信息,包括图像大小、类型等,例如:
~~~
$image = \think\Image::open('./image.png');
// 返回图片的宽度
$width = $image->width();
// 返回图片的高度
$height = $image->height();
// 返回图片的类型
$type = $image->type();
// 返回图片的mime类型
$mime = $image->mime();
// 返回图片的尺寸数组 0 图片宽度 1 图片高度
$size = $image->size();
~~~
### 裁剪图片
使用`crop`和`save`方法完成裁剪图片功能。
~~~
$image = \think\Image::open('./image.png');
//将图片裁剪为300x300并保存为crop.png
$image->crop(300, 300)->save('./crop.png');
~~~
生成的图片如图:
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/b46e4b15f928daf684058dff7077d0af_300x300.png)
支持从某个坐标开始裁剪,例如下面从(100,30)开始裁剪,例如:
~~~
$image = \think\Image::open('./image.png');
//将图片裁剪为300x300并保存为crop.png
$image->crop(300, 300,100,30)->save('./crop.png');
~~~
生成的图片如图:
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/b46e4b15f928daf684058dff7077d0af_300x300.png)
### 生成缩略图
使用`thumb`方法生成缩略图,例如:
~~~
$image = \think\Image::open('./image.png');
// 按照原图的比例生成一个最大为150*150的缩略图并保存为thumb.png
$image->thumb(150, 150)->save('./thumb.png');
~~~
生成的缩略图如图所示:
[](image/5785e5409cab2.png)
我们看到实际生成的缩略图并不是150*150,因为默认采用原图等比例缩放的方式生成缩略图,最大宽度是150。
可以支持其他类型的缩略图生成,设置包括`\think\Image`的下列常量或者对应的数字:
~~~
//常量,标识缩略图等比例缩放类型
const THUMB_SCALING = 1;
//常量,标识缩略图缩放后填充类型
const THUMB_FILLED = 2;
//常量,标识缩略图居中裁剪类型
const THUMB_CENTER = 3;
//常量,标识缩略图左上角裁剪类型
const THUMB_NORTHWEST = 4;
//常量,标识缩略图右下角裁剪类型
const THUMB_SOUTHEAST = 5;
//常量,标识缩略图固定尺寸缩放类型
const THUMB_FIXED = 6;
~~~
比如我们居中裁剪:
~~~
$image = \think\Image::open('./image.png');
// 按照原图的比例生成一个最大为150*150的缩略图并保存为thumb.png
$image->thumb(150,150,\think\Image::THUMB_CENTER)->save('./thumb.png');
~~~
后生成的缩略图效果如图:
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/9f0c37dc57cc38fccb00dbecca801013_150x150.png)
再比如我们右下角剪裁
~~~
$image = \think\Image::open('./image.png');
// 按照原图的比例生成一个最大为150*150的缩略图并保存为thumb.png
$image->thumb(150,150,\think\Image::THUMB_SOUTHEAST)->save('./thumb.png');
~~~
生成的缩略图效果如图:
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/144414432d50e94938754a8f775c69af_150x150.png)
这里就不再对其他用法一一举例了。
### 图像翻转
使用`flip`可以对图像进行翻转操作,默认是以x轴进行翻转,例如:
~~~
$image = \think\Image::open('./image.png');
// 对图像进行以x轴进行翻转操作
$image->flip()->save('./filp_image.png');
~~~
生成的效果如图:
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-07-23_579366dfb73f3.png)
我们也可以改变参数,以y轴进行翻转,例如:
~~~
$image = \think\Image::open('./image.png');
// 对图像进行以y轴进行翻转操作
$image->flip(\think\image::FLIP_Y)->save('./filp_image.png');
~~~
生成的效果如图:
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-07-23_579366e000540.png)
>[info]图像的翻转可以理解为图像的镜面效果与图像旋转有所不同。
### 图像旋转
使用`rotate`可以对图像进行旋转操作(默认是顺时针旋转90度),我们用默认90度进行旋转举例:
~~~
$image = \think\Image::open('./image.png');
// 对图像使用默认的顺时针旋转90度操作
$image->rotate()->save('./rotate_image.png');
~~~
生成的效果如图:
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/9e926b44ae235cdf8b9a635297e4a786_432x767.png)
### 图像保存参数
`save`方法可以配置的参数
| 参数 | 默认 | 描述 |
| -- | -- | -- |
| pathname | 必填项 | 图像保存路径名称 |
| type | 默认与原图相同 | 图像类型 |
| quality | 80 | 图像质量 |
| interlace | true | 是否对JPEG类型图像设置隔行扫描 |
>[info]设置隔行扫描的情况下在网页进行浏览时。是从上到下一行一行的显示,否则图片整个显示出来 然后由模糊到清晰显示。
### 添加水印
系统支持添加图片及文字水印,下面依次举例说明
添加图片水印,我们下载官网logo文件到根目录进行举例:
~~~
$image = \think\Image::open('./image.png');
// 给原图左上角添加水印并保存water_image.png
$image->water('./logo.png')->save('water_image.png');
~~~
`water`方法的第二个参数表示水印的位置,默认值是`WATER_SOUTH`,可以传入下列`\think\Image`类的常量或者对应的数字:
~~~
//常量,标识左上角水印
const WATER_NORTHWEST = 1;
//常量,标识上居中水印
const WATER_NORTH = 2;
//常量,标识右上角水印
const WATER_NORTHEAST = 3;
//常量,标识左居中水印
const WATER_WEST = 4;
//常量,标识居中水印
const WATER_CENTER = 5;
//常量,标识右居中水印
const WATER_EAST = 6;
//常量,标识左下角水印
const WATER_SOUTHWEST = 7;
//常量,标识下居中水印
const WATER_SOUTH = 8;
//常量,标识右下角水印
const WATER_SOUTHEAST = 9;
~~~
我们用左上角来进行测试:
~~~
$image = \think\Image::open('./image.png');
// 给原图左上角添加水印并保存water_image.png
$image->water('./logo.png',\think\Image::WATER_NORTHWEST)->save('water_image.png');
~~~
生成的图片效果如下:
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/30d6a32b977c060bf6f4996053e5bca7_768x432.png)
还可以支持水印图片的透明度(0~100,默认值是100),例如:
~~~
$image = \think\Image::open('./image.png');
// 给原图左上角添加透明度为50的水印并保存alpha_image.png
$image->water('./logo.png',\think\Image::WATER_NORTHWEST,50)->save('alpha_image.png');
~~~
生成的图片效果如下:
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/67fb22eaa6b1f2c1325d498d2ecadbe9_768x432.png)
也可以支持给图片添加文字水印(我们复制一个字体文件`HYQingKongTiJ.ttf`到入口目录),我们现在生成一个像素20px,颜色为`#ffffff`的水印效果:
~~~
$image = \think\Image::open('./image.png');
// 给原图左上角添加水印并保存water_image.png
$image->text('十年磨一剑 - 为API开发设计的高性能框架','HYQingKongTiJ.ttf',20,'#ffffff')->save('text_image.png');
~~~
生成的图片效果:
![](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/a38f1ee79cfbce71d6ddc50959a35c92_768x432.png)
### 文字水印参数
文字水印比较多,在此只做说明不做演示了
| 参数 | 默认 | 描述 |
| -- | -- | -- |
| text | 不能为空 | 添加的文字 |
| font | 不能为空 | 字体文件路径 |
| size | 不能为空 | 字号,单位是像素 |
| color | #00000000 | 文字颜色 |
| locate | WATER_SOUTHEAST | 文字写入位置 |
| offset | 0 | 文字相对当前位置的偏移量 |
| angle | 0 | 文字倾斜角度 |
';