README

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

安装

执行以下命令进行安装：

$ composer require slince/think-glide

用法

快速入门

由于从 ThinkPHP 5.1.6 开始添加了中间件的功能，所以在

• ThinkPHP 5.1.6 及以上版本使用 middleware 注册：

  打开 application/middleware.php 文件（如果不存在则创建），注册 middleware：

  return [
      //...
  
      \Slince\Glide\GlideMiddleware::factory([
          'source' => __DIR__ . '/../img',
      ])
  ];

  这种方式比较简单，也是推荐的方式；

• ThinkPHP 5.1.0 以上 5.1.6 以下版本：

  不支持 middleware，所以启用过程要复杂一点，我们用以下方式来妥协：

  // 在 /route/route.php 注册下面路由
  Route::get('images/:file', 'index/handleImageRequest');
  
  //在控制器 index 里创建action
  public function handleImageRequest()
  {
      $middleware = \Slince\Glide\GlideMiddleware::factory([
          'source' => App::getRootPath() . '/img',
      ]);
      
      return $middleware(app('request'), function(){
          return app('response');
      });
  }

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

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

即可得到缩小后的图片。

参数说明

安全签名

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

\Slince\Glide\GlideMiddleware::factory([
    'source' => __DIR__ . '/../img',
    'signKey' => 'v-LK4WCdhcfcc%jt*VC2cj%nVpu+xQKvLUA%H86kRVk_4bgG8&CWM#k*'
])

异常处理

echo app('glide.url_builder')->getUrl('user.jpg', ['w' => 100, 'h' => 100]);

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

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

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

\Slince\Glide\GlideMiddleware::factory([
    'source' => __DIR__ . '/../img',
    'signKey' => 'v-LK4WCdhcfcc%jt*VC2cj%nVpu+xQKvLUA%H86kRVk_4bgG8&CWM#k*'，
    'onException' => function(\Exception $exception, $request, $server){
    
        if ($exception instanceof \League\Glide\Signatures\SignatureException) {
            $response = new Response('签名错误', 403);
        } else {
            $response = new Response(sprintf('你访问的资源 "%s" 不存在', $request->path()), 404);
        }
        
        return $response;
    }
])

注意

快速参考

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

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

变更日志

查看 CHANGELOG.md

许可证

查看 MIT。