萬盛學電腦網

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

PHP GD 生成圖片縮略圖:等比縮放、畫質控制、多格式支援完整封裝

基於 GD2 擴展的圖片縮略圖生成是 PHP 經典剛需。本文封裝一個 make_thumb() 函數:自動檢測源圖格式(JPEG/PNG/GIF/WebP)、等比計算目標高度、真彩色畫布繪製、輸出質量可配、目錄自建、錯誤異常化。

完整函數

function make_thumb(string $src, string $dest, int $desiredWidth, int $quality = 85): bool {
    // 1. 檢測源文件
    if (!is_file($src) || !is_readable($src)) throw new InvalidArgumentException("源文件不可讀: $src");
    $info = getimagesize($src);
    if (!$info) throw new RuntimeException("非有效圖片或格式不支援: $src");
    [$srcW, $srcH, $type] = $info;

    // 2. 計算目標高度(等比)
    $desiredHeight = (int)round($srcH * ($desiredWidth / $srcW));

    // 3. 創建源圖資源
    $createFrom = match ($type) {
        IMAGETYPE_JPEG => 'imagecreatefromjpeg',
        IMAGETYPE_PNG  => 'imagecreatefrompng',
        IMAGETYPE_GIF  => 'imagecreatefromgif',
        IMAGETYPE_WEBP => 'imagecreatefromwebp',
        default => throw new RuntimeException("不支援的圖片類型: $type"),
    };
    $source = $createFrom($src);
    if (!$source) throw new RuntimeException("GD 無法解碼圖片: $src");

    // 4. 創建真彩色目標畫布
    $thumb = imagecreatetruecolor($desiredWidth, $desiredHeight);

    // 5. 保持透明度(PNG/GIF/WebP)
    if (in_array($type, [IMAGETYPE_PNG, IMAGETYPE_GIF, IMAGETYPE_WEBP], true)) {
        imagealphablending($thumb, false);
        imagesavealpha($thumb, true);
        $transparent = imagecolorallocatealpha($thumb, 0, 0, 0, 127);
        imagefill($thumb, 0, 0, $transparent);
    }

    // 6. 高質量重採樣縮放
    imagecopyresampled($thumb, $source, 0, 0, 0, 0, $desiredWidth, $desiredHeight, $srcW, $srcH);

    // 7. 確保目標目錄存在
    $destDir = dirname($dest);
    if (!is_dir($destDir)) mkdir($destDir, 0755, true);

    // 8. 輸出(根據目標副檔名或源類型決定格式)
    $destType = $type;
    $destExt = strtolower(pathinfo($dest, PATHINFO_EXTENSION));
    $saveFunc = match ($destType) {
        IMAGETYPE_JPEG => fn() => imagejpeg($thumb, $dest, $quality),
        IMAGETYPE_PNG  => fn() => imagepng($thumb, $dest, (int)round($quality / 10 * 9)), // PNG 壓縮級 0-9
        IMAGETYPE_GIF  => fn() => imagegif($thumb, $dest),
        IMAGETYPE_WEBP => fn() => imagewebp($thumb, $dest, $quality),
        default => throw new RuntimeException("目標格式不支援輸出"),
    };
    $ok = $saveFunc();

    // 9. 釋放資源
    imagedestroy($source);
    imagedestroy($thumb);

    return $ok;
}

使用範例

// 生成 300px 寬縮略圖,質量 80
make_thumb('uploads/photo.jpg', 'thumbs/photo_300.jpg', 300, 80);

// 批量處理上傳目錄
foreach (glob('uploads/*.{jpg,png,gif,webp}', GLOB_BRACE) as $file) {
    $name = basename($file);
    make_thumb($file, "thumbs/{$name}", 400);
    make_thumb($file, "thumbs/small_{$name}", 150);
}

GD vs Imagick 選型指南

維度GD (內建)Imagick (擴展)
安裝部署PHP 核心編譯參數 --with-gd,幾乎全環境可用需安裝 ImageMagick 庫 + pecl imagick,版本兼容性較麻煩
格式支援JPEG/PNG/GIF/WebP/BMP/XBM200+ 格式(HEIC、AVIF、TIFF、PSD、RAW...)
性能純 C 實現,中等多線程、SIMD 優化,大圖快 2-5 倍
高級功能基礎繪圖、濾鏡、文字✓ 圖層、蒙版、向量、色彩空間轉換、EXIF 保留、PDF 渲染
記憶體管理PHP 進程內,受 memory_limit 限制ImageMagick 獨立進程/共享內存,可配置 MAGICK_MEMORY_LIMIT
推薦場景簡單縮略圖、水印、驗證碼、低併發高併發、複雜圖像處理、多格式、色彩管理關鍵場景

常見坑點與修復

  1. 內存耗盡:大圖 (如 4000×3000) 解碼需 ~48MB 記憶體。調大 memory_limit 或改用 Imagick 流式處理。
  2. JPEG 方向標籤 (EXIF Orientation):GD 不自動旋轉。需讀取 EXIF Orientation 手動 imagerotate 或用 Imagick autoOrientImage()。
  3. 透明背景變黑:PNG/GIF 必須 imagealphablending(false) + imagesavealpha(true) + 填充透明色。
  4. 輸出質量參數:JPEG/WebP 0-100,PNG 0-9(壓縮級,非質量),GIF 無損無參數。

現代專案建議:簡單縮略圖用 GD(零依賴)、複雜處理/高併發用 Imagick、極致性能用 libvips + php-vips(輕量、流式、多核並行)。

copyright © 萬盛學電腦網 all rights reserved