[league/glide]两行代码实现一套强大的图片处理HTTP服务

只要两行代码，就能实现类似对象存储云提供的基于参数的图片处理，比如裁剪、放大、水印、旋转等等。

我们经常使用第三方的对象存储服务，比如七牛云或阿里云，他们都提供了“智能媒体服务”，其实就是在链接上加上各种参数，实现图片的裁剪、缩放等，可以便捷的实现缩略图，节省网络宽带，加快页面的访问。

原理很简单，就是接收参数然后处理呗。如果用PHP做的话，不难，但是却要写好多代码。操作GD库太麻烦了。但现在，只要两行代码就能实现一套强大的图片处理功能。

// 实例化
$server = League\Glide\ServerFactory::create([
    'source' => 'path/to/source/folder',
    'cache' => 'path/to/cache/folder',
]);

// 可以在第二个参数传入数组
$server->outputImage('users/1.jpg', ['w' => 300, 'h' => 400]);

// 更简单的做法，直接传入GET参数
$server->outputImage($path, $_GET);

功能预览表

glide可以接收26个参数，几乎可以涵盖所有的场景需求。

名称	功能参数	介绍
方向	or	旋转图像，支持0, 90, 180或者 270，同时支持auto，会根据图片的Exif 信息自动确定位置
翻转	flip	翻转图像，支持水平、垂直、圆心等
裁剪	crop	将图像裁剪到指定尺寸，支持居中、左上角、居左等10多个设置
宽度	w	设置图像的宽度，根据fit参数表现不同
高度	h	设置图像的高度，根据fit参数表现不同
尺寸效果	fit	设置图像如何适应新的尺寸，显示最大宽度、最小宽度、变形、裁剪等等6中效果
设备像素比	dpr	通过此参数可以生成不同像素比的图片，在苹果和安卓设备中有更好的表现，最大8
亮度	bri	调整图像亮度
对比度	con	调整图像对比度
伽马	gam	调整图像伽马值值
锐化	sharp	锐化图像
模糊	blur	为图像增加模糊效果
像素化	pixel	为图像增加像素化效果
滤镜	filt	能够指定使用那些滤镜处理图像，内置灰度和褐色，可以自定义。
水印路径	mark	给图像增加水印
水印宽度	markw	设置水印的宽度
水印高度	markh	设置水印的高度
水印偏移量X	markx	水印的X偏移量
水印偏移量Y	marky	水印的Y偏移量
水印的填充	markpad	水印的填充，padding
水印的定位	markpos	水印的位置，居左、居中等
水印的透明度	markalpha	设置水印的透明度
背景	bg	设置图片的背景色
边框	border	给图片增加边框
质量	q	设置输入的质量
格式	fm	设置图像的编码格式，jpg、png等

功能介绍

本文对几个重点的功能做个介绍。

尺寸效果 fit

设置图像如何适应新的尺寸。

支持的参数：

• contain： 默认。 调整图像大小以适应宽度和高度边界，而无需裁剪、扭曲或改变纵横比。
• max：调整图像大小以适应宽度和高度边界，而不会裁剪、扭曲或改变纵横比，如果图像小于输出尺寸，也不会增加图像的尺寸。
• fill：调整图像大小以适应宽度和高度边界，而不裁剪或扭曲图像，剩余空间用背景色填充。 生成的图像将匹配约束尺寸。
• fill-max：调整图像大小以适应宽度和高度边界而不裁剪，但如果图像较小则放大图像。 完成的图像将在宽度或高度上具有剩余空间（除非新图像的纵横比与旧图像的纵横比相同）。 剩余空间将用背景色填充。 生成的图像将匹配约束尺寸。
• stretch：拉伸图像以完全适合约束尺寸。 生成的图像将填充尺寸，并且不会保持输入图像的纵横比。
• crop：调整图像大小以填充宽度和高度边界并裁剪任何多余的图像数据。 生成的图像将匹配宽度和高度限制，而不会扭曲图像。

裁剪 crop

当尺寸效果设置为裁剪时，可以使用裁剪参数。

裁剪位置：

您还可以通过添加裁剪位置来设置裁剪图像的位置。 接受 crop-top-left, crop-top, crop-top-right, crop-left, crop-center, crop-right, crop-bottom-left, crop-bottom或者 crop-bottom-right. 默认是 crop-center, 并且与 crop.

作物焦点

除了裁剪位置之外，您还可以使用焦点更具体地确定确切的裁剪位置。 这是使用两个偏移百分比定义的： crop-x%-y%.

<img src="kayaks.jpg?w=300&h=300&fit=crop-25-75">

您还可以选择通过提供第三个值来放大您的焦点：一个介于 1 和 100 之间的浮点数。每个完整步长相当于 100% 缩放。 （例如。 x%-y%-2相当于以 200% 的比例查看图像）。 建议的范围是 1-10。

<img src="kayaks.jpg?w=300&h=300&fit=crop-25-75-2">

预裁剪

在任何其他调整大小操作之前将图像裁剪为特定尺寸。 要求的格式： width,height,x,y. 就像使用截图工具那样，在先在图片上截取一段。

<img src="kayaks.jpg?crop=100,100,915,155">

存储驱动

可以使用flysystem驱动，这意味着不仅可以操作本地的文件，还支持各类存储方式，比如SFTP、FTP、对象存储等等。

// 图片地址
$source = new League\Flysystem\Filesystem(
    new League\Flysystem\Local\LocalFilesystemAdapter('path/to/source/folder')
);

// 缓存地址
$cache = new League\Flysystem\Filesystem(
    new League\Flysystem\Local\LocalFilesystemAdapter('path/to/cache/folder')
);

$server = new League\Glide\Server(
    $source,
    $cache,
);

标准返回Response

可以通过getImageResponse方法获取标准的PSR-7响应对象，同时官方提供了laravel等框架的扩展响应对象。

默认配置

可以设置默认的图片处理设置。

$server = League\Glide\ServerFactory::create([
    'defaults' => [
        'mark' => 'logo.png',
        'markw' => '30w',
        'markpad' => '5w',
    ]
]);

预设

可以提前将各种参数设置好，然后直接传入预设的名称即可。比如下面的代码：

<?php

$server = League\Glide\ServerFactory::create([
    'presets' => [
        'small' => [
            'w' => 200,
            'h' => 200,
            'fit' => 'crop',
        ],
        'medium' => [
            'w' => 600,
            'h' => 400,
            'fit' => 'crop',
        ]
    ]
]);

然后直接使用预设就可以了：

<img src="kayaks.jpg?p=small">

也可以同时使用多个预设：

<img src="kayaks.jpg?p=small,watermarked">

甚至可以使用带有附加参数的预设：

<img src="kayaks.jpg?p=small,watermarked&filt=sepia">

图像驱动

支持GD库和Imagick库。

$server = League\Glide\ServerFactory::create([

    // 默认使用GD
    'driver' => 'gd',

    // 使用ImageMagick
    'driver' => 'imagick',
]);

安装

使用compsoer安装即可。

composer require league/glide

安全保护

glide提供了一套签名机制，通过私钥（一长串字符）生成一个token，只有携带了这个token 才能调用参数，避免人们通过大量的图像调整参数攻击服务器。

配置

<?php

use League\Glide\Signatures\SignatureFactory;
use League\Glide\Signatures\SignatureException;

try {
    // 设置秘钥
    $signkey = 'v-LK4WCdhcfcc%jt*VC2cj%nVpu+xQKvLUA%H86kRVk_4bgG8&CWM#k*b_7MUJpmTc=4GFmKFp7=K%67je-skxC5vz+r#xT?62tT?Aw%FtQ4Y3gvnwHTwqhxUh89wCa_';

    // 验证访问
    SignatureFactory::create($signkey)->validateRequest($path, $_GET);

} catch (SignatureException $e) {
    // 处理异常
}

生成URL

<?php

use League\Glide\Urls\UrlBuilderFactory;

// 上面的那个秘钥
$signkey = 'v-LK4WCdhcfcc%jt*VC2cj%nVpu+xQKvLUA%H86kRVk_4bgG8&CWM#k*b_7MUJpmTc=4GFmKFp7=K%67je-skxC5vz+r#xT?62tT?Aw%FtQ4Y3gvnwHTwqhxUh89wCa_';

// 实例化
$urlBuilder = UrlBuilderFactory::create('/img/', $signkey);

// 生成url
$url = $urlBuilder->getUrl('cat.jpg', ['w' => 500]);

// 使用url
echo '<img src="'.$url.'">';

// 输入预览
<img src="/img/cat.jpg?w=500&s=af3dc18fc6bfb2afb521e587c348b904">

总结

只要简单的几行代码，就实现了一套健全的图片处理HTTP服务，当你有类似的需求的时候，抓紧用上吧。

原文标题：[league/glide]两行代码实现一套强大的图片处理HTTP服务

原文地址：https://phpreturn.com/index/a64084605c3759.html

原文平台：PHP武器库

版权声明：本文由phpreturn.com（PHP武器库官网）原创和首发，所有权利归phpreturn（PHP武器库）所有，本站允许任何形式的转载/引用文章，但必须同时注明出处。