萬盛學電腦網

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

PHP Imagick 給圖片加浮水印完整實作教學

需求場景

在內容平台、電商系統或版權保護場景中,需對上傳圖片自動加浮水印。Imagick 提供強大的 compositeImage() 方法,支援透明度、位置精確控制,是 PHP 端處理浮水印的首選方案。

完整程式碼實作

<?php
// 載入主圖
$image = new Imagick();
$image->readImage('original.jpg');

// 載入浮水印圖(建議使用 PNG 透明背景)
$watermark = new Imagick();
$watermark->readImage('/data/mark.png');

// 取得圖片尺寸
$iWidth  = $image->getImageWidth();
$iHeight = $image->getImageHeight();
$wWidth  = $watermark->getImageWidth();
$wHeight = $watermark->getImageHeight();

// 若浮水印大於主圖,等比縮小浮水印
if ($iHeight < $wHeight || $iWidth < $wWidth) {
    $watermark->scaleImage($iWidth, $iHeight);
    $wWidth  = $watermark->getImageWidth();
    $wHeight = $watermark->getImageHeight();
}

// 計算右下角座標(留 10px 邊距)
$x = $iWidth - $wWidth - 10;
$y = $iHeight - $wHeight - 10;

// 合成浮水印:COMPOSITE_OVER 表示正常疊加
$image->compositeImage($watermark, Imagick::COMPOSITE_OVER, $x, $y);

// 輸出圖片
header('Content-Type: image/' . $image->getImageFormat());
echo $image;
?>

關鍵技術點解析

1. 尺寸自適應邏輯

程式碼先比較主圖與浮水印尺寸,當浮水印超出主圖邊界時,呼叫 scaleImage() 等比縮放。此步驟確保浮水印永遠完整顯示於主圖範圍內。

2. 定位計算

$x = $iWidth - $wWidth - 10;  // 右下角 X 軸
$y = $iHeight - $wHeight - 10; // 右下角 Y 軸

減去 10px 邊距避免浮水印貼邊,視覺效果更佳。常見九宮格定位邏輯可擴充為配置參數。

3. 合成模式常數

Imagick::COMPOSITE_OVER 為預設疊加模式,保留浮水印 Alpha 通道透明度。其他常用模式:

  • COMPOSITE_DISSOLVE:可指定不透明度百分比
  • COMPOSITE_BLEND:混合模式
  • COMPOSITE_MODULATE:亮度/飽和度調變

進階擴充建議

支援文字浮水印

$draw = new ImagickDraw();
$draw->setFont('/path/to/font.ttf');
$draw->setFontSize(24);
$draw->setFillColor('rgba(255,255,255,0.5)');
$draw->setGravity(Imagick::GRAVITY_SOUTHEAST);
$image->annotateImage($draw, 10, 10, 0, 'Copyright © 2024');

批次處理優化

  • 使用 Imagick::setIteratorIndex() 處理多幀圖片(GIF/WebP)
  • 搭配 Imagick::writeImages() 輸出動畫浮水印
  • 大量圖片建議透過佇列非同步處理,避免阻塞 HTTP 請求

效能與記憶體考量

Imagick 操作會在記憶體中解壓完整像素資料,大圖處理易觸發 memory_limit。建議:

  • 設定 ini_set('memory_limit', '512M')
  • 處理完成後主動 $image->destroy() 釋放資源
  • 生產環境啟用 OPcache 減少編譯開銷

總結

Imagick 提供專業級圖片合成功能,配合尺寸自適應與精確定位,能滿足多數浮水印需求。實際部署時請注意記憶體管理與錯誤處理,並根據業務場景選擇同步或非同步處理架構。

copyright © 萬盛學電腦網 all rights reserved