PHP GD 圖像函式完整分類參考：建立、繪圖、文字、色彩、輸出、進階處理

前言

GD 是 PHP 內建圖形處理擴展，支援 PNG、JPEG、GIF、WBMP、WebP、XBM、XPM 等格式。需安裝 php-gd 並啟用 extension=gd。現代專案建議考慮 ImageMagick (imagick) 功能更強、效能更好。

一、資訊與建立

二、從檔案/字串載入

三、色彩管理

四、繪圖基礎

五、填充與樣式

六、文字繪製

中文繪製關鍵：使用 TTF 字型

<?php
$im = imagecreatetruecolor(400, 100);
$white = imagecolorallocate($im, 255, 255, 255);
$black = imagecolorallocate($im, 0, 0, 0);
imagefill($im, 0, 0, $white);

// 需要 .ttf 字型檔（如微軟正黑體 msjh.ttc）
$font = __DIR__ . '/fonts/msjh.ttc';
$text = '你好，PHP GD！';
$bbox = imagettfbbox(24, 0, $font, $text);
$textWidth = $bbox[2] - $bbox[0];
$x = (400 - $textWidth) / 2;
$y = 60;

imagettftext($im, 24, 0, $x, $y, $black, $font, $text);

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

七、圖片複製與縮放

縮圖產生器範例

<?php
function createThumbnail(string $srcPath, string $dstPath, int $maxW, int $maxH, int $quality = 85) {
    list($srcW, $srcH, $type) = getimagesize($srcPath);
    $createFunc = ['', 'imagecreatefromgif', 'imagecreatefromjpeg', 'imagecreatefrompng', '', '', '', 'imagecreatefromwebp'][$type] ?? null;
    if (!$createFunc) throw new Exception('Unsupported format');
    
    $src = $createFunc($srcPath);
    $ratio = min($maxW / $srcW, $maxH / $srcH);
    $dstW = (int)($srcW * $ratio);
    $dstH = (int)($srcH * $ratio);
    
    $dst = imagecreatetruecolor($dstW, $dstH);
    
    // 保持 PNG 透明
    if ($type === IMAGETYPE_PNG || $type === IMAGETYPE_GIF) {
        imagealphablending($dst, false);
        imagesavealpha($dst, true);
        $transparent = imagecolorallocatealpha($dst, 0, 0, 0, 127);
        imagefill($dst, 0, 0, $transparent);
    }
    
    imagecopyresampled($dst, $src, 0, 0, 0, 0, $dstW, $dstH, $srcW, $srcH);
    
    // 輸出
    switch ($type) {
        case IMAGETYPE_JPEG: imagejpeg($dst, $dstPath, $quality); break;
        case IMAGETYPE_PNG:  imagepng($dst, $dstPath, 9); break;
        case IMAGETYPE_GIF:  imagegif($dst, $dstPath); break;
        case IMAGETYPE_WEBP: imagewebp($dst, $dstPath, $quality); break;
    }
    
    imagedestroy($src);
    imagedestroy($dst);
}

八、輸出與儲存

九、進階效果

十、PS 字型（舊功能，少用）

imagepsloadfont, imagepstext, imagepsbbox, imagepsencodefont, imagepsextendfont, imagepsslantfont, imagepsfreefont —— PostScript Type 1 字型支援，PHP 7.0+ 已移除。

十一、格式轉換工具函式

常見坑點與最佳實踐

1. 記憶體洩漏： 所有 imagecreate* 必須配對 imagedestroy()。
2. PNG 透明： 輸出前 imagealphablending($im, false); imagesavealpha($im, true);。
3. 中文亂碼： 必須用 imagettftext + TTF 字型檔，內建字型不支援中文。
4. 大圖處理： ini_set('memory_limit', '512M')，或改用 ImageMagick 串流處理。
5. 錯誤處理： GD 函式失敗回傳 false，需檢查並 error_log。
6. 安全性： 使用者上傳圖片處理前，先 getimagesize 驗證類型，避免惡意檔案。

GD vs ImageMagick 選擇指南

1. 上一篇文章： PHP Stream 函式完整分類參考：上下文、過濾器、Socket、封裝協議
2. 下一篇文章： Eclipse PHP 開發環境設定：以空格取代 Tab 鍵的完整指南

PHP 綜合知識

jQuery + PHP 實作擲骰子抽獎遊戲：完整前後端程式碼解析

結合 jQuery 動畫特效與 PHP 後端機率控制，打造一

Yii Framework 教程（18）：CTextHighlighter 程式碼高亮顯示範例

CTextHighlighter 用於格式化顯示程式碼，目前

瀏覽器關閉後 PHP 是否會繼續執行？深度實驗與原理解析

前言：一個經典的 PHP 運行機制疑問 在典型的 LNMP

深入解析 PHP foreach 循環的引用陷阱與底層機制

前言 PHP 4 引入 foreach，提供遍歷數組的便捷語