您现在的位置：程式碼之家 >> 編程語言 > >> 網頁程式設計 >> PHP 程式設計 >> PHP 綜合知識

ThinkPHP 3.2 Image 類別生成縮圖完整教學

編輯：PHP 綜合知識

前言

ThinkPHP 3.2 內建的 Image 類別（位於 ThinkPHP/Extend/Library/ORG/Util/Image.class.php）提供簡單易用的圖片處理功能，包含縮圖生成、圖片資訊獲取、水印添加等。本文詳細說明縮圖功能的使用方法與注意事項。

基本引入與實例化

<?php
// 1. 匯入類別（ThinkPHP 3.2 命名空間前綴為 ORG）
import("ORG.Util.Image");

// 2. 實例化
$image = new Image();

// 3. 設定圖片路徑（相對於入口檔 index.php）
$imagePath = './Public/Uploads/photo.jpg'; // 假設專案結構

// 4. 獲取圖片資訊（寬、高、類型、大小、MIME 等）
$info = $image::getImageInfo($imagePath);
print_r($info);
/*
輸出範例：
Array
(
    [width] => 800
    [height] => 600
    [type] => 2
    [size] => 124580
    [mime] => image/jpeg
)
*/
?>

縮圖生成核心方法：thumb2()

<?php
/**
 * 生成縮圖
 * 
 * @param string $srcPath 原圖路徑
 * @param string $destPath 縮圖儲存路徑（含檔名）
 * @param string $type 圖片類型（jpg、png、gif 等）
 * @param int $maxWidth 最大寬度
 * @param int $maxHeight 最大高度
 * @return bool 成功與否
 */
$result = $image::thumb2(
    $imagePath,           // 原圖路徑
    './Public/Thumbs/photo_thumb.jpg', // 縮圖路徑
    'jpg',                // 圖片類型
    300,                  // 最大寬度
    200                   // 最大高度
);

if ($result) {
    echo "✅ 縮圖生成成功！";
} else {
    echo "❌ 縮圖生成失敗";
}
?>

關鍵參數說明與限制

參數	說明	注意事項
`$maxWidth`	縮圖最大寬度	不能大於原圖寬度，否則生成失敗
`$maxHeight`	縮圖最大高度	不能大於原圖高度，否則生成失敗
`$type`	輸出格式	需與原圖格式相容，建議保持一致
等比縮放	自動保持長寬比	實際尺寸可能小於設定的最大值

常見失敗原因排查

尺寸超過原圖： 確保 $maxWidth <= 原圖寬 且 $maxHeight <= 原圖高
目錄權限： 縮圖儲存目錄需可寫入（Linux: chmod 755 或 chown www:www）
GD 擴充未安裝： 執行 php -m | grep gd 確認，或 phpinfo() 查看
路徑錯誤： 使用 realpath() 驗證絕對路徑，避免相對路徑混淆
記憶體不足： 大圖處理需調整 memory_limit（如 256M）

進階用法：批量生成多種尺寸

<?php
$sizes = [
    'thumb' => [150, 150],   // 正方形縮圖
    'medium' => [400, 300],  // 中等尺寸
    'large' => [800, 600],   // 大尺寸（不超過原圖）
];

$originalPath = './Public/Uploads/photo.jpg';
$info = $image::getImageInfo($originalPath);
$origW = $info['width'];
$origH = $info['height'];

foreach ($sizes as $name => [$maxW, $maxH]) {
    // 跳過超過原圖尺寸的規格
    if ($maxW > $origW || $maxH > $origH) {
        echo "⚠️ {$name} 尺寸({$maxW}x{$maxH})超過原圖({$origW}x{$origH})，略過\n";
        continue;
    }
    
    $destPath = "./Public/Thumbs/photo_{$name}.jpg";
    $result = $image::thumb2($originalPath, $destPath, 'jpg', $maxW, $maxH);
    echo $result ? "✅ {$name} 生成成功\n" : "❌ {$name} 生成失敗\n";
}
?>