PHP 圖片等比縮放函數實作：imagecopyresampled 高質量、支援 JPEG/PNG/GIF、最大尺寸限制

通用 PHP 圖片縮放函數，支援按最大寬高等比縮放、優先使用 imagecopyresampled 高質量重採樣、自動處理 JPEG/PNG/GIF 格式、保持透明度、輸出到檔案。適合頭像上傳、縮略圖生成、圖片壓縮場景。

核心函數

 $maxWidth) || ($maxHeight && $srcH > $maxHeight)) {
        // 計算縮放比例
        $widthRatio  = ($maxWidth && $srcW > $maxWidth)  ? $maxWidth / $srcW  : 1;
        $heightRatio = ($maxHeight && $srcH > $maxHeight) ? $maxHeight / $srcH : 1;
        $ratio = min($widthRatio, $heightRatio); // 取較小比例，確保不超限

        $dstW = (int)($srcW * $ratio);
        $dstH = (int)($srcH * $ratio);

        // 建立目標圖片 (真彩色支援透明度)
        if (function_exists('imagecreatetruecolor')) {
            $dst = imagecreatetruecolor($dstW, $dstH);
            // 保持 PNG/GIF 透明度
            if ($filetype === '.png' || $filetype === '.gif') {
                imagealphablending($dst, false);
                imagesavealpha($dst, true);
                $transparent = imagecolorallocatealpha($dst, 0, 0, 0, 127);
                imagefill($dst, 0, 0, $transparent);
            }
            imagecopyresampled($dst, $im, 0, 0, 0, 0, $dstW, $dstH, $srcW, $srcH);
        } else {
            // 老版本 GD 降級
            $dst = imagecreate($dstW, $dstH);
            imagecopyresized($dst, $im, 0, 0, 0, 0, $dstW, $dstH, $srcW, $srcH);
        }

        // 輸出
        switch ($filetype) {
            case '.jpg': case '.jpeg': imagejpeg($dst, $name . $filetype, 90); break;
            case '.png': imagepng($dst, $name . $filetype, 6); break;
            case '.gif': imagegif($dst, $name . $filetype); break;
        }
        imagedestroy($dst);
    } else {
        // 原圖直接輸出
        switch ($filetype) {
            case '.jpg': case '.jpeg': imagejpeg($im, $name . $filetype, 90); break;
            case '.png': imagepng($im, $name . $filetype, 6); break;
            case '.gif': imagegif($im, $name . $filetype); break;
        }
    }
    imagedestroy($im);
}

// 使用範例
$source = 'upload/photo.jpg';
$im = imagecreatefromjpeg($source);
resizeImage($im, 800, 600, 'thumb/photo', '.jpg'); // 最大 800x600
?>

關鍵技術細節

GD 庫格式支援歷史

• GD 1.6.2 以前：支援 GIF (LZW 專利)
• GD 1.6.2~2.0.28：移除 GIF 支援
• GD 2.0.28+：恢復 GIF 讀寫支援
• 現代 PHP：extension=gd 統一支援 JPEG/PNG/GIF/WebP

Linux 環境編譯 GD 支援

# 安裝依賴
yum install libpng-devel libjpeg-devel freetype-devel
# PHP 編譯參數
./configure --with-gd \
    --with-jpeg-dir \
    --with-png-dir \
    --with-freetype-dir \
    --enable-gd-native-ttf

進階擴展建議

• WebP 支援：imagecreatefromwebp、imagewebp (PHP 5.5+)
• 裁剪模式：新增 $mode 參數 (fit/fill/cover) 控制縮放策略
• 水印疊加：縮放後疊加 Logo/文字水印
• 批次處理：目錄遍歷 + 多進程並發 (pcntl/swoole)
• 雲端儲存：輸出流直接上傳 S3/OSS，不落地磁碟