痛點分析
- 後台僅生成單一規格縮略圖,前台多處調用同一張圖,CSS 強制寬高導致拉伸變形。
- 原圖含水印,無法直接用原圖裁剪,必須基於已生成的縮略圖二次處理。
解決思路:以現有縮略圖為源,按需裁剪生成多規格緩存文件
- 後台附件設置:縮略圖默認寬/高設為全站最大調用尺寸(如 800×600),確保源圖夠大。
- 前端調用時指定目標尺寸,系統自動裁剪/填充生成
原文件名_寬_高.副檔名 緩存,二次調用直接讀取緩存。
核心代碼:include/extend.func.php 新增 thumb() 函數
function thumb($imgurl, $width, $height, $bg = true) {
global $cfg_mainsite, $cfg_multi_site;
// 統一路徑:去除域名前綴,獲取相對路徑
$thumb = eregi("https://", $imgurl) ? str_replace($cfg_mainsite, '', $imgurl) : $imgurl;
// 解析文件名與副檔名
list($thumbname, $extname) = explode('.', $thumb);
if (!$thumbname || !$extname) return $imgurl;
// 目標緩存文件路徑
$newthumb = $thumbname . '_' . $width . '_' . $height . '.' . $extname;
// 源文件不存在直接返回原圖
if (!file_exists(DEDEROOT . $thumb)) return $imgurl;
// 緩存不存在則生成
if (!file_exists(DEDEROOT . $newthumb)) {
include_once DEDEINC . '/image.func.php';
if ($bg) {
// 等比縮放 + 留白填充至指定畫布
ImageResizeNew(DEDEROOT . $thumb, $width, $height, DEDEROOT . $newthumb);
} else {
// 純等比縮放,不填充(可能不滿目標尺寸)
ImageResize(DEDEROOT . $thumb, $width, $height, DEDEROOT . $newthumb);
}
}
// 返回可訪問 URL(支援多站點)
return $cfg_multi_site == 'Y' ? $cfg_mainsite . $newthumb : $newthumb;
}
模板調用示例
{dede:arclist row='10' typeid='5'}
<a href="[field:arcurl/]">
<img src="[field:picname function='thumb(@me, 300, 200)'/]"
alt="[field:title/]" width="300" height="200" />
</a>
{/dede:arclist}
{-- 不填充背景,保留原比例 --}
[field:picname function='thumb(@me, 300, 200, false)'/]
參數對照表
| 參數 | 類型 | 說明 |
$imgurl | string | 原縮略圖 URL(含/不含域名均可) |
$width | int | 目標寬度(像素) |
$height | int | 目標高度(像素) |
$bg | bool | true=留白填充至矩形(默認),false=純等比縮放 |
實際效果
- 無變形: 所有調用位置圖片比例完美,無拉伸壓扁。
- 高性能: 首次請求生成緩存,後續直接靜態文件響應,無 PHP 開銷。
- 靈活: 同一源圖可生成無數規格(列表圖 300×200、詳情圖 800×600、手機端 100×100),互不干擾。
避坑指南
- 源縮略圖太小
- 後台附件設置務必設大,否則放大模糊。建議設為最大調用尺寸的 1.5~2 倍。
- 權限問題
uploads/ 目錄需 Web 進程寫入權限,否則緩存生成失敗靜默返回原圖。
- 遠程附件/雲存儲
- 需修改
file_exists 與 ImageResize* 為對應雲存儲 SDK 操作,或改用圖片處理服務(如阿里云 OSS 圖片處理參數)。