下面由thinkphp教程欄目給大家介紹在thinkphp項目里添加圖片尺寸動態裁剪功能,希望對需要的朋友有所幫助!
在 ThinkPHP 項目里添加圖片尺寸動態裁剪功能
ThinkPHP 圖片動態裁剪縮放庫
首先附上項目地址: https://github.com/top-think/think-glide
Glide 是一個可以幫助你根據指定參數動態的生成圖片內容給瀏覽器的圖片操作庫,從而實現
圖片動態裁剪,打水印等,本庫對 Glide 進行了一些友好的包裝與擴展,屏蔽了原生庫的一些底層抽象從而使得 ThinkPHP 用戶可以在 ThinkPHP 項目中
更好的添加圖片的動態裁剪功能。
立即學習“PHP免費學習筆記(深入)”;
Installation
執行下面命令安裝:
$ composer require slince/think-glide
Usage
Quick start
由于從 ThinkPHP 5.1.6 開始添加了中間件的功能,所以在
-
ThinkPHP 5.1.6 及以上版本使用 middleware 注冊:
打開 application/middleware.php 文件(如果不存在創建即可),注冊 middleware:
return [ //... SlinceGlideGlideMiddleware::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 = SlinceGlideGlideMiddleware::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 進行校驗,
SlinceGlideGlideMiddleware::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 進行替換默認行為:
SlinceGlideGlideMiddleware::factory([ 'source' => __DIR__ . '/../img', 'signKey' => 'v-LK4WCdhcfcc%jt*VC2cj%nVpu+xQKvLUA%H86kRVk_4bgG8&CWM#k*', 'onException' => function(Exception $exception, $request, $server){ if ($exception instanceof LeagueGlideSignaturesSignatureException) { $response = new Response('簽名錯誤', 403); } else { $response = new Response(sprintf('你訪問的資源 "%s" 不存在', $request->path()), 404); } return $response; } ])
注意該閉包必須返回一個 thinkResponse 實例;
Quick reference
不止支持裁剪,glide還支持其它操作,只要傳遞對應參數即可,參考這里查看支持的參數:
http://glide.thephpleague.com/1.0/api/quick-reference/
相關推薦:最新的10個thinkphp視頻教程