萬盛學電腦網

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

PHP 圖片水印類:支持 PNG/JPG/GIF、九大位置、透明度控制

功能特性

  • 支持源圖/水印圖:PNG、JPG、GIF 三大格式自動識別。
  • 9 種預設位置:四角、四邊中、居中(參數 1-5,默認右下角)。
  • 透明度 0-100 可調(0 全透明,100 不透明)。
  • 自動保存為源圖格式,返回新文件路徑;錯誤碼區分 5 種失敗原因。

核心函數:img_water_mark()

/**
 * 圖片加水印
 * @param string $srcImg      源圖路徑
 * @param string $waterImg    水印圖路徑
 * @param string $savepath    保存目錄(默認源圖目錄)
 * @param string $savename    保存文件名(默認源圖文件名)
 * @param int    $positon     位置 1-5(1左上 2右上 3居中 4左下 5右下)
 * @param int    $alpha       透明度 0-100
 * @return string|int 成功返回新文件路徑,失敗返回負數錯誤碼
 */
function img_water_mark($srcImg, $waterImg, $savepath = null, $savename = null, $positon = 5, $alpha = 30) {
    // 1. 解析源路徑
    $temp = pathinfo($srcImg);
    $name = $temp['basename'];
    $path = $temp['dirname'];
    $exte = $temp['extension'];
    $savename = $savename ?: $name;
    $savepath = $savepath ?: $path;
    $savefile = $savepath . '/' . $savename;

    // 2. 獲取圖片信息並創建 GD 資源
    $srcinfo = @getimagesize($srcImg);
    if (!$srcinfo) return -1; // 源文件不存在或非圖片
    $waterinfo = @getimagesize($waterImg);
    if (!$waterinfo) return -2; // 水印文件不存在

    $srcImgObj = image_create_from_ext($srcImg);
    if (!$srcImgObj) return -3; // 源圖資源創建失敗
    $waterImgObj = image_create_from_ext($waterImg);
    if (!$waterImgObj) return -4; // 水印資源創建失敗

    // 3. 計算貼合座標
    switch ($positon) {
        case 1: $x = $y = 0; break; // 左上
        case 2: $x = $srcinfo[0] - $waterinfo[0]; $y = 0; break; // 右上
        case 3: $x = ($srcinfo[0] - $waterinfo[0]) / 2; $y = ($srcinfo[1] - $waterinfo[1]) / 2; break; // 居中
        case 4: $x = 0; $y = $srcinfo[1] - $waterinfo[1]; break; // 左下
        case 5: $x = $srcinfo[0] - $waterinfo[0]; $y = $srcinfo[1] - $waterinfo[1]; break; // 右下
        default: $x = $y = 0;
    }

    // 4. 合成(支持透明度)
    imagecopymerge($srcImgObj, $waterImgObj, $x, $y, 0, 0, $waterinfo[0], $waterinfo[1], $alpha);

    // 5. 按原格式保存
    switch ($srcinfo[2]) {
        case IMAGETYPE_GIF:  imagegif($srcImgObj, $savefile); break;
        case IMAGETYPE_JPEG: imagejpeg($srcImgObj, $savefile); break;
        case IMAGETYPE_PNG:  imagepng($srcImgObj, $savefile); break;
        default: return -5; // 保存失敗
    }

    imagedestroy($srcImgObj);
    imagedestroy($waterImgObj);
    return $savefile;
}

// 輔助:根據類型創建 GD 資源
function image_create_from_ext($imgfile) {
    $info = getimagesize($imgfile);
    switch ($info[2]) {
        case IMAGETYPE_GIF:  return imagecreatefromgif($imgfile);
        case IMAGETYPE_JPEG: return imagecreatefromjpeg($imgfile);
        case IMAGETYPE_PNG:  return imagecreatefrompng($imgfile);
    }
    return null;
}

使用示例

// 基礎用法(右下角,30% 透明度)
$newFile = img_water_mark('photo.jpg', 'logo.png');
if ($newFile > 0) {
    echo "水印已生成:$newFile";
} else {
    echo "失敗,錯誤碼:$newFile";
}

// 進階:居中、50% 透明度、自定義輸出路徑
$newFile = img_water_mark(
    'uploads/avatar.png',
    'watermark.png',
    'output/',
    'avatar_wm.png',
    3, // 居中
    50 // 50% 透明度
);

常見問題與優化

擴展方向

  • 文字水印:imagettftext() 繪制文本,支持字體、大小、顏色、旋轉。
  • 平鋪水印:雙層循環 imagecopymerge 覆蓋整圖。
  • 動態水印:根據用戶 ID 生成唯一水印(防盜圖溯源)。

總結

封裝格式識別、座標計算、透明合成、格式保存為單一函數,錯誤碼語義化,開箱即用。生產環境建議加入圖片尺寸限制、類型白名單、異常日志記錄。

copyright © 萬盛學電腦網 all rights reserved
問題解決方案
PNG 透明背景變黑創建真彩色圖像 imagecreatetruecolor() + imagesavealpha($img, true) + 分配透明色填充
水印圖過大遮擋主體預先縮放水印圖(imagescale())或限制水印寬度 ≤ 源圖 30%
中文路徑讀取失敗確保 PHP 文件編碼 UTF-8,或用 iconv('UTF-8','GBK',$path) 轉碼(Windows 環境)
內存耗盡大圖處理前 ini_set('memory_limit', '256M'),處理後及時 imagedestroy()