支援 PNG/JPG/GIF 三種格式,可指定 9 種位置(含 5 種常用角/邊/中)與透明度 (0~100)。
<?php
/**
* 圖片加水印 (支援 png/jpg/gif)
* @param string $srcImg 源圖路徑
* @param string $waterImg 水印圖路徑 (建議 PNG 透明背景)
* @param string $savePath 儲存目錄,預設同源圖目錄
* @param string $saveName 儲存檔名,預設覆蓋源圖
* @param int $position 位置 1:左上 2:右上 3:置中 4:左下 5:右下
* @param int $alpha 透明度 0(全透明)~100(不透明)
* @return string|int 成功返回新檔路徑,失敗返回負數錯誤碼
*/
function imgWaterMark($srcImg, $waterImg, $savePath = null, $saveName = null, $position = 5, $alpha = 30)
{
// 1. 解析源圖路徑
$info = pathinfo($srcImg);
$saveName = $saveName ?: $info['basename'];
$savePath = $savePath ?: $info['dirname'];
$saveFile = $savePath . '/' . $saveName;
// 2. 讀取圖片資訊並建立 GD 資源
$srcInfo = @getimagesize($srcImg);
if (!$srcInfo) return -1; // 源圖不存在或非圖片
$waterInfo = @getimagesize($waterImg);
if (!$waterInfo) return -2; // 水印圖不存在
$srcRes = imageCreateFromExt($srcImg);
if (!$srcRes) return -3; // 源圖資源建立失敗
$waterRes = imageCreateFromExt($waterImg);
if (!$waterRes) return -4; // 水印資源建立失敗
// 3. 計算水印座標
$srcW = $srcInfo[0]; $srcH = $srcInfo[1];
$wW = $waterInfo[0]; $wH = $waterInfo[1];
switch ($position) {
case 1: $x = 0; $y = 0; break; // 左上
case 2: $x = $srcW - $wW; $y = 0; break; // 右上
case 3: $x = ($srcW - $wW) / 2; $y = ($srcH - $wH) / 2; break; // 置中
case 4: $x = 0; $y = $srcH - $wH; break; // 左下
case 5: $x = $srcW - $wW; $y = $srcH - $wH; break; // 右下
default: $x = $y = 0;
}
// 邊界保護
$x = max(0, min($x, $srcW - $wW));
$y = max(0, min($y, $srcH - $wH));
// 4. 合成 (支援 Alpha 透明度)
imagecopymerge($srcRes, $waterRes, $x, $y, 0, 0, $wW, $wH, $alpha);
// 5. 按原格式儲存
$result = false;
switch ($srcInfo[2]) {
case IMAGETYPE_GIF: $result = imagegif($srcRes, $saveFile); break;
case IMAGETYPE_JPEG: $result = imagejpeg($srcRes, $saveFile, 90); break;
case IMAGETYPE_PNG: $result = imagepng($srcRes, $saveFile); break;
default: return -5;
}
// 6. 釋放資源
imagedestroy($srcRes);
imagedestroy($waterRes);
return $result ? $saveFile : -5;
}
/**
* 根據副檔名/MIME 建立 GD 資源
*/
function imageCreateFromExt($file)
{
$info = @getimagesize($file);
if (!$info) return null;
switch ($info[2]) {
case IMAGETYPE_GIF: return @imagecreatefromgif($file);
case IMAGETYPE_JPEG: return @imagecreatefromjpeg($file);
case IMAGETYPE_PNG: return @imagecreatefrompng($file);
default: return null;
}
}
<?php
// 基礎用法:右下角 30% 透明度
$newFile = imgWaterMark(
'uploads/photo.jpg',
'assets/watermark.png',
null, null, 5, 30
);
if ($newFile > 0) {
echo "水印已添加:$newFile";
} else {
echo "失敗,錯誤碼:$newFile";
}
// 批量處理範例
$photos = glob('uploads/*.jpg');
foreach ($photos as $photo) {
imgWaterMark($photo, 'watermark.png', 'output', basename($photo), 3, 50); // 置中 50%
}
getimagesize() 回傳的索引 2 (IMAGETYPE_* 常數) 判斷類型,比副檔名可靠。imagecopymerge() 的 $alpha 參數控制水印不透明度,0=全透明(隱形)、100=實體蓋印。imagejpeg($res, $file, 90) 設定輸出品質 90%,平衡體積與畫質。imagedestroy() 釋放 GD 資源,防止批量處理時記憶體洩漏。| 現象 | 可能原因 | 解決 |
|---|---|---|
| 水印位置偏移/消失 | 水印尺寸大於源圖 | 預先縮放水印或跳過該圖 |
| 輸出圖片全黑/損壞 | GD 資源建立失敗 | 檢查檔案權限、磁碟空間、GD 擴展是否載入 |
| 透明背景變黑 | 未開啟 Alpha 混合 | 源圖為 PNG 時需 imagealphablending($src, true); imagesavealpha($src, true); |
| 動畫 GIF 變靜態 | GD 不支援多幀 | 改用 Imagick 或 ffmpeg 處理動畫水印 |