yzh52521/think-glide

ThinkPHP6 的 Glide 图像处理库适配器

v2.0.0 2023-03-09 04:44 UTC

This package is auto-updated.

Last update: 2024-09-09 08:23:11 UTC


README

Glide 是一个可以帮助你根据指定参数动态生成图片内容供浏览器使用的图片操作库,从而实现图片动态裁剪、添加水印等功能。本库对 Glide 进行了一些友好的封装和扩展,屏蔽了原生库的一些底层抽象,使得 ThinkPHP 用户可以在 ThinkPHP6 项目中更好地添加图片的动态裁剪功能。

安装

执行以下命令进行安装

$ composer require yzh52521/think-glide

使用方法

快速入门

  • ThinkPHP6 及以上版本使用 middleware 注册:

    打开 application/middleware.php 文件(如果不存在,可以创建),注册 middleware:

    return [
        //...
    
        \think\glide\middleware\Glide::class
    ];

生成配置

系统安装后会自动在 config 目录中生成 glide.php 的配置文件。如果系统未生成,可以在命令行执行:

php think glide:config 

快速生成配置文件

参数说明

source 是你本地图片文件夹的位置。假设该目录下有图片 user.jpg,打开浏览器访问以下链接:

http://youdomain.com/images/user.jpg?w=100&h=100

即可得到缩小的图片。

安全签名

在不开启安全签名的情况下,用户可以调整 query 中的参数自行对图片进行裁剪。如果你不打算这么做,你可以通过 signKey 进行校验,

在这种情况下,用户自行调整参数将会无效;生成安全的 URL

echo glide_url('user.jpg', ['w' => 100, 'h' => 100]);
或
echo app('glide_builder')->getUrl('user.jpg', ['w' => 100, 'h' => 100]);

//你会得到如下链接:/images/user.jpg?w=100&h=100&sign=af3dc18fc6bfb2afb521e587c348b904

异常处理

如果用户访问了一张不存在的图片或者没有进行安全校验,系统会抛出异常。你可以通过修改配置文件中的 onException 进行替换默认行为:

return [
    //...

    'onException' => function(\Exception $exception, $request, $server){
    
        if ($exception instanceof \League\Glide\Signatures\SignatureException) {
            $response = response('签名错误', 403);
        } else {
            $response = response(sprintf('你访问的资源 "%s" 不存在', $request->path()), 404);
        }
        
        return $response;
    }
])

nginx 配置

location ~* /images/(.*)$ {
  try_files $uri $uri/ /index.php/$request_uri;
}

注意该闭包必须返回一个 think\Response 实例;

快速参考

不仅支持裁剪,Glide 还支持其他操作。只需传递相应的参数即可。参考这里查看支持的参数:

http://glide.thephpleague.com/2.0/api/quick-reference/

许可证

MIT