萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> CMS 教學

徹底解決 DEDECMS 縮略圖變形/失真:按比例裁剪生成多規格完美方案

痛點分析

  • 後台僅生成單一規格縮略圖,前台多處調用同一張圖,CSS 強制寬高導致拉伸變形。
  • 原圖含水印,無法直接用原圖裁剪,必須基於已生成的縮略圖二次處理。

解決思路:以現有縮略圖為源,按需裁剪生成多規格緩存文件

  1. 後台附件設置:縮略圖默認寬/高設為全站最大調用尺寸(如 800×600),確保源圖夠大。
  2. 前端調用時指定目標尺寸,系統自動裁剪/填充生成 原文件名_寬_高.副檔名 緩存,二次調用直接讀取緩存。

核心代碼: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)'/]

參數對照表

參數類型說明
$imgurlstring原縮略圖 URL(含/不含域名均可)
$widthint目標寬度(像素)
$heightint目標高度(像素)
$bgbooltrue=留白填充至矩形(默認),false=純等比縮放

實際效果

  • 無變形: 所有調用位置圖片比例完美,無拉伸壓扁。
  • 高性能: 首次請求生成緩存,後續直接靜態文件響應,無 PHP 開銷。
  • 靈活: 同一源圖可生成無數規格(列表圖 300×200、詳情圖 800×600、手機端 100×100),互不干擾。

避坑指南

源縮略圖太小
後台附件設置務必設大,否則放大模糊。建議設為最大調用尺寸的 1.5~2 倍。
權限問題
uploads/ 目錄需 Web 進程寫入權限,否則緩存生成失敗靜默返回原圖。
遠程附件/雲存儲
需修改 file_exists 與 ImageResize* 為對應雲存儲 SDK 操作,或改用圖片處理服務(如阿里云 OSS 圖片處理參數)。
copyright © 萬盛學電腦網 all rights reserved