核心函數 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 imagecopyresized | resampled 使用雙立方插值,品質顯著優於 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%+。