PHP GD 圖像處理深度解析：從環境建置到動態圖片生成

GD 庫是 PHP 內建的圖形處理擴展，支援創建、編輯、輸出多種圖片格式 (JPEG、PNG、GIF、WebP、WBMP、XPM、BMP)。廣泛應用於驗證碼生成、圖片縮圖、水印添加、圖表繪製、頭像處理等場景。本文系統性介紹安裝配置、核心函數分類、常用操作模式與實戰範例。

環境安裝與驗證

PHP 配置啟用 GD

驗證安裝與支援格式

<?php
var_dump(gd_info());
/* 輸出範例：
array(12) {
  ["GD Version"]=> string(26) "bundled (2.1.0 compatible)"
  ["FreeType Support"]=> bool(true)
  ["GIF Read Support"]=> bool(true)
  ["GIF Create Support"]=> bool(true)
  ["JPEG Support"]=> bool(true)
  ["PNG Support"]=> bool(true)
  ["WBMP Support"]=> bool(true)
  ["XPM Support"]=> bool(false)
  ["XBM Support"]=> bool(true)
  ["WebP Support"]=> bool(true)
  ["BMP Support"]=> bool(true)
}
*/

核心函數分類速查

實戰範例集

1. 產生驗證碼圖片

<?php
session_start();
$width = 120; $height = 40;
$image = imagecreatetruecolor($width, $height);

// 背景
$bg = imagecolorallocate($image, 230, 230, 230);
imagefilledrectangle($image, 0, 0, $width, $height, $bg);

// 雜訊線條
for ($i = 0; $i < 5; $i++) {
    $color = imagecolorallocate($image, rand(100,200), rand(100,200), rand(100,200));
    imageline($image, rand(0,$width), rand(0,$height), rand(0,$width), rand(0,$height), $color);
}

// 驗證碼文字
$code = '';
for ($i = 0; $i < 4; $i++) $code .= chr(rand(65,90)); // A-Z
$_SESSION['captcha'] = $code;

$fontSize = 5;
$x = 15;
foreach (str_split($code) as $char) {
    $color = imagecolorallocate($image, rand(0,100), rand(0,100), rand(0,100));
    imagestring($image, $fontSize, $x, 10, $char, $color);
    $x += 22;
}

header('Content-Type: image/png');
imagepng($image);
imagedestroy($image);

2. 圖片縮圖 (保持比例、高品質)

function createThumbnail($srcPath, $destPath, $maxWidth, $maxHeight, $quality = 85) {
    list($srcW, $srcH, $type) = getimagesize($srcPath);
    if (!$srcW || !$srcH) return false;

    $ratio = min($maxWidth/$srcW, $maxHeight/$srcH);
    if ($ratio >= 1) return copy($srcPath, $destPath); // 無需縮小

    $dstW = (int)($srcW * $ratio);
    $dstH = (int)($srcH * $ratio);

    $srcImg = match($type) {
        IMAGETYPE_JPEG => imagecreatefromjpeg($srcPath),
        IMAGETYPE_PNG => imagecreatefrompng($srcPath),
        IMAGETYPE_GIF => imagecreatefromgif($srcPath),
        IMAGETYPE_WEBP => imagecreatefromwebp($srcPath),
        default => null
    };
    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);
        imagefilledrectangle($dstImg, 0, 0, $dstW, $dstH, $transparent);
    }

    imagecopyresampled($dstImg, $srcImg, 0, 0, 0, 0, $dstW, $dstH, $srcW, $srcH);

    $success = match($type) {
        IMAGETYPE_JPEG => imagejpeg($dstImg, $destPath, $quality),
        IMAGETYPE_PNG => imagepng($dstImg, $destPath, 9),
        IMAGETYPE_GIF => imagegif($dstImg, $destPath),
        IMAGETYPE_WEBP => imagewebp($dstImg, $destPath, $quality),
        default => false
    };

    imagedestroy($srcImg);
    imagedestroy($dstImg);
    return $success;
}

3. 添加文字水印

function addTextWatermark($srcPath, $destPath, $text, $fontFile, $fontSize = 20, $color = [255,255,255], $alpha = 50, $position = 'bottom-right', $margin = 10) {
    list($w, $h, $type) = getimagesize($srcPath);
    $src = imagecreatefromjpeg($srcPath); // 簡化：假設 JPEG

    $dst = imagecreatetruecolor($w, $h);
    imagecopyresampled($dst, $src, 0, 0, 0, 0, $w, $h, $w, $h);

    $textColor = imagecolorallocatealpha($dst, $color[0], $color[1], $color[2], $alpha);
    $box = imagettfbbox($fontSize, 0, $fontFile, $text);
    $textW = $box[2] - $box[0];
    $textH = $box[1] - $box[7];

    switch ($position) {
        case 'top-left': $x = $margin; $y = $margin + $textH; break;
        case 'top-right': $x = $w - $textW - $margin; $y = $margin + $textH; break;
        case 'bottom-left': $x = $margin; $y = $h - $margin; break;
        case 'bottom-right': $x = $w - $textW - $margin; $y = $h - $margin; break;
        case 'center': $x = ($w - $textW)/2; $y = ($h + $textH)/2; break;
    }

    imagettftext($dst, $fontSize, 0, $x, $y, $textColor, $fontFile, $text);
    imagejpeg($dst, $destPath, 90);
    imagedestroy($src); imagedestroy($dst);
}

4. 繪製簡單統計圖表 (長條圖)

function drawBarChart($data, $width = 600, $height = 400) {
    $img = imagecreatetruecolor($width, $height);
    $white = imagecolorallocate($img, 255, 255, 255);
    $gray = imagecolorallocate($img, 200, 200, 200);
    $blue = imagecolorallocate($img, 66, 133, 244);
    $dark = imagecolorallocate($img, 51, 51, 51);

    imagefilledrectangle($img, 0, 0, $width, $height, $white);

    $maxVal = max($data);
    $barCount = count($data);
    $barWidth = 40;
    $gap = ($width - $barCount * $barWidth) / ($barCount + 1);
    $scale = ($height - 80) / $maxVal;

    $x = $gap;
    foreach ($data as $label => $value) {
        $barH = (int)($value * $scale);
        $y = $height - 50 - $barH;
        imagefilledrectangle($img, $x, $y, $x + $barWidth, $height - 50, $blue);
        imagestring($img, 3, $x + 5, $height - 40, $label, $dark);
        imagestring($img, 3, $x + 5, $y - 20, $value, $dark);
        $x += $barWidth + $gap;
    }

    // 座標軸
    imageline($img, 30, 30, 30, $height - 50, $dark);
    imageline($img, 30, $height - 50, $width - 30, $height - 50, $dark);

    header('Content-Type: image/png');
    imagepng($img);
    imagedestroy($img);
}

// 使用
drawBarChart(['Jan'=>120, 'Feb'=>150, 'Mar'=>180, 'Apr'=>200]);

常見問題與最佳實務

GD vs ImageMagick 選擇指南

總結

GD 庫是 PHP 內建圖形處理的基石，掌握畫布建立、顏色管理、幾何繪製、文字渲染、圖片合成、輸出輸出等核心流程，即可實現驗證碼、縮圖、水印、圖表等常見需求。對於高階圖像處理，建議評估 ImageMagick 或雲端圖片處理服務 (Imgix, Cloudinary, AWS Lambda@Edge)。

1. 上一篇文章： PHP RESTful API 實戰教學：從零建立符合 REST 架構的 Web 服務
2. 下一篇文章： PHP 時區完整列表：支援的時區識別符與最佳實務設定指南

PHP 入門

PHP 檔案上傳完整教學：表單建立、驗證限制、儲存與安全防護

PHP 檔案上傳完整教學 檔案上傳是 Web 應用常見功能，

快速搭建 LAMP 環境：5 款優秀整合安裝包推薦

LAMP（Linux + Apache + MySQL +

PHP MySQL 預處理語句完整指南：防注入、效能優化與 MySQLi/PDO 實作

PHP MySQL 預處理語句深度解析：原理、防注入機制、綁

PHP+MySQL 本地開發環境搭建 (一)：ComsenzEXP — 康盛官方社區產品一鍵體驗包

ComsenzEXP 是康盛創想 (Discuz! 開發商)