在 ThinkPHP 項目裏添加圖片尺寸動態裁剪功能

ThinkPHP 圖片動態裁剪縮放庫

首先附上項目地址： https://github.com/top-think/think-glide

Glide 是一個能夠幫助你根據指定參數動態的生成圖片內容給瀏覽器的圖片操做庫，從而實現
圖片動態裁剪，打水印等，本庫對 Glide 進行了一些友好的包裝與擴展，屏蔽了原生庫的一些底層抽象從而使得 ThinkPHP 用戶能夠在 ThinkPHP 項目中
更好的添加圖片的動態裁剪功能。

Installation

執行下面命令安裝:

$ composer require slince/think-glide

Usage

Quick start

因爲從 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

便可獲得縮小後的圖片。

參數說明

參數名	類型	說明	是否必選
source	string	本地文件夾位置	是
cache	string	緩存文件位置，默認在 runtime/glide 下面	否
cacheTime	string	緩存時間，示例 +2 days, 緩存期間屢次請求會自動響應 304	否
signKey	string	安全簽名	否
onException	callable	異常處理handler	否
baseUrl	string	路由前綴，匹配到該前綴時中間件開始執行，默認是 /images	否

安全簽名

不開啓安全簽名的狀況下用戶能夠調整query裏面的參數自行對圖片進行裁剪，若是你不打算這麼作的話，你能夠經過
signKey 進行校驗，

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

這種狀況下用戶自行調整參數將會無效；生成安全的URL:

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

//你會獲得以下連接：/images/user.jpg?w=100&h=100&s=af3dc18fc6bfb2afb521e587c348b904

異常處理

若是用戶訪問了一張不存在的圖片或者沒有進行安全校驗，系統會拋出異常，你能夠經過 onException 進行替換默認行爲：

\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;
    }
])

注意該閉包必須返回一個 think\Response 實例；

Quick reference

不止支持裁剪，glide還支持其它操做，只要傳遞對應參數便可，參考這裏查看支持的參數：

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

Changelog

See CHANGELOG.md

License

See MIT.