萬盛學電腦網

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

PHP 圖片縮放實作:等比例縮放、多格式支援、品質控制

核心函數 imageZoom()

<?php
/**
 * 圖片等比例縮放
 * @param string $srcPath 來源圖片路徑
 * @param int $maxWidth 最大寬度
 * @param int $maxHeight 最大高度
 * @param string $dstPath 輸出路徑(可選,預設覆蓋原檔加前綴 s_)
 * @param int $quality JPEG 品質 0-100
 * @return bool|array 成功回傳 ['width'=>, 'height'=>, 'path'=>],失敗回傳 false
 */
function imageZoom($srcPath, $maxWidth, $maxHeight, $dstPath = null, $quality = 85) {
    if (!is_file($srcPath)) return false;
    
    $info = getimagesize($srcPath);
    if (!$info) return false;
    
    [$srcW, $srcH, $type] = $info;
    $mime = $info['mime'] ?? '';
    
    // 計算縮放比例(取較小者,確保完整放入框內)
    $ratio = min($maxWidth / $srcW, $maxHeight / $srcH);
    
    // 若原圖已小於目標尺寸,不放大(可選)
    if ($ratio >= 1) {
        $ratio = 1;
    }
    
    $dstW = (int)round($srcW * $ratio);
    $dstH = (int)round($srcH * $ratio);
    
    // 建立來源圖片資源
    $srcImg = match($type) {
        IMAGETYPE_GIF => imagecreatefromgif($srcPath),
        IMAGETYPE_JPEG => imagecreatefromjpeg($srcPath),
        IMAGETYPE_PNG => imagecreatefrompng($srcPath),
        IMAGETYPE_WEBP => imagecreatefromwebp($srcPath),
        default => false,
    };
    
    if (!$srcImg) return false;
    
    // 建立目標畫布(真彩色)
    $dstImg = imagecreatetruecolor($dstW, $dstH);
    
    // PNG/GIF 保持透明度
    if ($type === IMAGETYPE_PNG || $type === IMAGETYPE_GIF) {
        imagealphablending($dstImg, false);
        imagesavealpha($dstImg, true);
        $transparent = imagecolorallocatealpha($dstImg, 255, 255, 255, 127);
        imagefill($dstImg, 0, 0, $transparent);
    }
    
    // 重採樣縮放(品質優於 imagecopyresized)
    imagecopyresampled($dstImg, $srcImg, 0, 0, 0, 0, $dstW, $dstH, $srcW, $srcH);
    
    // 輸出路徑
    $dstPath = $dstPath ?? dirname($srcPath) . '/s_' . basename($srcPath);
    
    // 依格式輸出
    $success = match($type) {
        IMAGETYPE_GIF => imagegif($dstImg, $dstPath),
        IMAGETYPE_JPEG => imagejpeg($dstImg, $dstPath, $quality),
        IMAGETYPE_PNG => imagepng($dstImg, $dstPath, 9), // PNG 壓縮等級 0-9
        IMAGETYPE_WEBP => imagewebp($dstImg, $dstPath, $quality),
        default => false,
    };
    
    // 釋放資源
    imagedestroy($srcImg);
    imagedestroy($dstImg);
    
    return $success ? ['width' => $dstW, 'height' => $dstH, 'path' => $dstPath] : false;
}

// 使用範例
$result = imageZoom('gg.jpg', 100, 200);
if ($result) {
    echo "縮放成功:{$result['width']}x{$result['height']} → {$result['path']}";
} else {
    echo "縮放失敗";
}
?>

關鍵技術點解析

技術點說明
imagecopyresampled vs imagecopyresizedresampled 使用雙立方插值,品質顯著優於 resized(最近鄰插值)
透明度處理PNG/GIF 需關閉混色、啟用 alpha 通道保存,並填充透明背景
不放大原圖if ($ratio >= 1) $ratio = 1; 避免小圖放大模糊
記憶體管理大圖處理後必須 imagedestroy() 釋放 GD 資源
錯誤處理檢查 getimagesize() 回傳值、imagecreatefrom* 回傳值

進階:批次縮放生成多種尺寸(響應式圖片)

<?php
function generateResponsiveImages($srcPath, $sizes = []) {
    // $sizes = [['w'=>320,'h'=>240,'suffix'=>'_sm'], ['w'=>800,'h'=>600,'suffix'=>'_md']]
    $results = [];
    foreach ($sizes as $size) {
        $dstPath = preg_replace('/\.\w+$/', $size['suffix'] . '$0', $srcPath);
        $results[$size['suffix']] = imageZoom($srcPath, $size['w'], $size['h'], $dstPath);
    }
    return $results;
}

// 使用
generateResponsiveImages('photo.jpg', [
    ['w' => 320, 'h' => 240, 'suffix' => '_thumb'],
    ['w' => 800, 'h' => 600, 'suffix' => '_medium'],
    ['w' => 1920, 'h' => 1080, 'suffix' => '_large'],
]);
?>

現代替代方案

  • ImageMagick (imagick):效能更好、格式支援更多、濾鏡更豐富。$imagick->resizeImage()
  • Intervention Image:Laravel 常用封裝,語法優雅:Image::make($path)->fit(300, 200)->save($out)
  • WebP 轉換:現代網站建議輸出 WebP 格式,體積縮減 30%+。
copyright © 萬盛學電腦網 all rights reserved