图片处理扩展 Intervention/image 的简单使用

Intervention Image是一个开源的PHP图像处理和操作库。 它提供了一种创建，编辑和合成图像的简便且富有表现力的方式，并支持当前两个最常见的图像处理库GD Library和Imagick。
编写该类是为了使PHP图像操作更容易且更具表现力。 无论您是要创建图像缩略图，水印还是对大型图像文件进行格式化，Intervention Image都可以帮助您以最少的代码行轻松地管理每个任务。
该库遵循FIG标准PSR-2，以确保共享的PHP代码之间的高度互操作性，并且经过了完全的单元测试。

一、 环境要求

• PHP >=5.4
• Fileinfo Extension
• GD Library (>=2.0)
• Imagick PHP extension (>=6.5.7)

二、 安装及配置

• composer 安装

composer require intervention/image

• 在 app/config/app.php 添加 providers 数组中添加如下代码：

/*
 * Package Service Providers...
 */
Intervention\Image\ImageServiceProvider::class,

• 在 app/config/app.php 添加 aliases 数组中添加如下代码：

'Image' => Intervention\Image\Facades\Image::class,

• 发布扩展生成 config/image.php 配置文件

php artisan vendor:publish --provider="Intervention\Image\ImageServiceProviderLaravelRecent"

• 在 config/image.php 修改驱动为imagick

// Imagick 处理效果和效率比 GD 好
'driver' => 'imagick'

三、常用API 及用法

创建图像

• canvas() 创建一个空的画布

public Intervention\Image\ImageManager canvas(integer $width, integer $height, [mixed $bgcolor])

// 实例化一个空的 100*100 透明背景空 canvas 图像资源对象
$img =  Image::canvas(100, 100);  
// 实例化一个空的 100*100 背景色为 #ff0000  canvas 图像资源对象
$img =  Image::canvas(100,  100,  '#ff0000');

• make() 从给定图片实例化新图像实例

public static Intervention\Image\ImageManager make(mixed $source)

// 以 foo.jpg 资源文件实例化一个 Image 对象 
$img = Image::make('public/foo.jpg');

// 实例化一个 GD 创建的图象的 Image 对象
$img = Image::make(imagecreatefromjpeg('public/foo.jpg'));

// URL
$img = Image::make('http://example.com/example.jpg');

// 直接从 Laravel 文件上传资源实例化一个 Image 对象
$img = Image::make(Input::file('photo'));

改变图像尺寸的方法

• resize() 调整当前图像的大小

public Intervention\Image\Image resize (integer $width, integer $height, [Closure $callback])

// 将图像调整为固定大小
$img->resize(300, 200);
// 防止可能的尺寸变化
$img->resize(300, null, function ($constraint) {   
    $constraint->aspectRatio();   // 按比例调整图片大小
    $constraint->upsize();  // 这里如果宽度不足 300 时，保持原来尺寸
});

• widen()按给定宽度按比例调整图像大小

public Intervention\Image\Image widen(integer $width, [Closure $callback])

// 将图像宽度调整为 300px，注意：宽度缩放的时候，高度是按比例变化的
$img = Image::make('public/foo.jpg')->widen(300);

// 将图像宽度调整为 300px，如果调整宽度超过图像原始宽度时，就保持图像原始宽度不变
$img = Image::make('public/foo.jpg')->widen(300, function ($constraint) {
    $constraint->upsize();
});

heighten() 和 widen() 功能类似

• crop() 裁剪图像

public Intervention\Image\Image crop(int $width, int $height, [int $x, int $y])

$img = Image::make('public/foo.jpg');

// 将图像从坐标 (25, 25)为切口裁剪为 200 * 100 大小
$img->crop(200, 100, 25, 25);

$img->crop(200, 100);

• fit() 以智能的方式，结合裁剪和调整来格式化图片，该方法将会自动找到给定的宽、高的最佳宽高比，裁剪并调整到给定尺寸

public Intervention.mage.mage fit( int $width, [ [int $height], [Closure $callback, [ string $position ]] ])

$img = Image::make('public/foo.jpg');

// 按照 1:1 的比例裁剪，然后缩放大小为 100 * 100
$img->fit(100);

// 按照 5:6 的比例裁剪，然后缩放大小为 100 * 120，并防止图片放大
$img->fit(100, 120, function ($constraint) {
    $constraint->upsize();
});

• resizeCanvas() 调整图像的边界到给定的宽和高

public Intervention\Image\Image resizeCanvas (int $width, int $height, [string $anchor, [boolean $relative, [mixed $bgcolor]]])

$img = Image::make('public/foo.jpg');
// 调整图像画布的大小为 300 * 200 
$img->resizeCanvas(300, 200);
// 只调整画布的宽度为 300 ，高度不变
$img->resizeCanvas(300, null);
// 从右下角开始来调整画布的大小为 300 * 200
$img->resizeCanvas(300, 200, 'bottom-right');
// 在相对模式下调整画布的大小为 以原始图片中心点为锚点 ，宽度增加 10 ，高度减少 10 
$img->resizeCanvas(10, -10, 'center', true,);
// 设置背景色
$img->resizeCanvas(1280, 720, 'center', false, 'ff00ff');

绘画的方法

• text() 将文字写入到图片上

public Intervention\Image\Image text(string $text, [integer $x, [integer $y, [Closure $callback]]])

$img = Image::make(''public/foo.png');

$img->text('测试文字', 50,50, function($font) {
    $font->file('public/Alibaba-PuHuiTi-Light.ttf');
    $font->size(24);
    $font->color('#000');
    //$font->align('center');
    //$font->valign('top');
    //$font->angle(45);
});

• pixel() 绘制点（ 在给定的坐标上，以给定的颜色绘制单个像素点）

public Intervention\Image\Image pixel(mixed $color, integer $x, integer $y)

$img = Image::canvas(100, 100, '#ddd');
// 绘制一个坐标为 (32, 32)，颜色为蓝色的点
$img->pixel('#0000ff', 32, 32);

• line() 绘制线

public Intervention\Image\Image line(int $x1, int $y1, int $x2, int $y2, [Closure $callback])

$img = Image::make('public/foo.jpg');
// 绘制一条起点坐标为(10, 145)，终点坐标为(185, 145)，宽度为 5px 的红色线
$img->line(10, 145, 185, 145, function($draw){
    $draw->color('#f00');
    $draw->width(1);
});                    

• rectangle() 绘制矩形（左上角位于x，y点1，右下角位于x，y点2）

public Intervention\Image\Image rectangle(int $x1, int $y1, int $x2, int $y2, [Closure $callback])

$img = Image::make('public/foo.jpg');
// 绘制左上角点坐标为 (5, 95) 右下角点坐标 (190, 143) ，边框宽度为 2px颜色为红色 ，背景色为红色的矩形
$img->rectangle(5, 95, 190, 143, function($draw){
  //$draw->background('#FFF');
  $draw->border(2, '#f00');
});

• circle() 绘制圆

public Intervention\Image\Image circle( integer $diameter, integer $x, integer $y, [Closure $callback] )

$img = Image::canvas(300, 200, '#ddd');
// 绘制一个半径为 10px，圆心坐标为 (100, 100)，边框宽度为 1px ，边框颜色为红色，并填充颜色为蓝色的圆
$img->circle(10, 100, 100, function ($draw) {
    $draw->background('#0000ff');
    $draw->border(1, '#f00');
});

• ellipse() 绘制椭圆

public Intervention\Image\Image ellipse(int $width, int $height, int $x, int $y, [Closure $callback])

$img = Image::make('public/foo.jpg');
// 绘制宽度为 200，高度为 80，中心点为 (100, 118)，边框宽度为 1px 颜色为红色，背景色为蓝色的椭圆
$img->ellipse(200, 80, 100, 118, function ($draw) {
   // $draw->background('#0000ff');
    $draw->border(1, '#ff0000');
});

*polygon() 绘制多边形

public Intervention\Image\Image polygon(array $points, [Closure $callback])

$img = Image::canvas(800, 600, '#ddd');
// 绘制一个边框为红色，填充背景色为蓝色的多边形
$img->polygon([
      0, 0, 
      1100, 0, 
      1100, 250
], function ($draw) {
    $draw->background('#0000ff');
    $draw->border(1, '#ff0000');
});

图像的其它处理方法

• fill() 用颜色或图案填充图像

public Intervention\Image\Image fill(mixed $filling, [integer $x, integer $y])

如果指定了x、y坐标，则将基于此位置的颜色来填充，未指定坐标时填充整个图像
图形学中Flood Fill是 漫水填充，是用来填充区域的。就好比在一个地方一直倒水，水会往四周满延开，直到高地阻挡。Flood Fill就是从一个点开始往四周寻找相同的点填充，直到有不同的点为止。

$img = Image::canvas(800, 600);
// 用 #cccccc 填充图像
$img->fill('#cccccc');
//  用 tile.png 填充图像
$img->fill('tile.png');
// flood fill 填充
$img->fill('#ff00ff', 0, 0);

• insert() 插入图片

public Intervention\Image\Image insert(mixed $source, [string $position, [integer $x, integer $y]])

$img = Image::make('public/foo.jpg');
// 在右下角插入10像素偏移量的水印
$img->insert('public/watermark.png', 'bottom-right', 10, 10);

获取图像信息常用的方法

• width() 获取图像宽度

// 获取图像的宽度
$width = Image::make('public/foo.jpg')->width();

height() 功能和 width() 类比

输出图像数据的方法

• save() 保存图像，可指定路径和图像质量

• public Intervention\Image\Image save([string $path, [int $quality], [string $format]])

$img = Image::make('public/foo.jpg')->resize(300, 200);
$img->save('public/foo', 80, 'jpg');

• response() 直接作为HTTP响应

public Intervention\Image\Image response([string $format, [integer $quality]])

$img = Image::canvas(800, 600, '#ff0000');
// 直接输出
echo $img->response();

• encode() 图像进行编码

public Intervention\Image\Image encode([mixed $format, [int $quality]])

// 将 png 格式图像编码为 jpg 格式
$jpg = (string) Image::make('public/foo.png')->encode('jpg', 75);
// 将图像编码为base64 格式
$data = (string) Image::make('public/bar.png')->encode('data-url');

本作品采用《CC 协议》，转载必须注明作者和本文链接