ServBay 中的 GD 模組：PHP 圖像處理指南

ServBay 是一款專為 macOS 設計的強大在地 Web 開發環境，已內建並預設啟用 PHP 的 GD 圖像處理模組。GD 函式庫是一個被廣泛應用於 Web 開發領域的開源圖形函式庫，使開發者能夠透過 PHP 程式碼動態創建與操作圖像。本指南將詳細介紹 ServBay 上 GD 模組的使用方式、驗證步驟以及常見應用場景。

GD 模組簡介

GD 函式庫（Graphics Draw）是一個功能強大的開源圖形函式庫，專為動態生成與處理圖像而設計。在 Web 開發領域，尤其是 PHP 應用中，GD 函式庫是處理圖像相關任務（如生成縮圖、加上浮水印、建立驗證碼、繪製圖表等）的關鍵工具。

主要功能特色

**支援多種圖像格式：**GD 函式庫能夠讀取與寫入多種主流圖像格式，包括 JPEG、PNG、GIF、WBMP、XPM 等。
豐富的圖像處理功能： 提供一系列功能強大的函式，可用於創建圖像、縮放、裁切、旋轉、合併、添加文字、繪製圖形等各種操作。
高效性能： 圖像處理經過優化，效能表現良好，適合大量處理或即時生成圖像需求。
易於整合和使用： GD 作為 PHP 的標準擴充套件，API 直觀且好上手，可輕鬆整合至 PHP 腳本中直接調用。

ServBay 對 GD 模組的支援

ServBay 支援多個 PHP 版本，且在所有支援的 PHP 版本中，GD 模組皆已預先安裝並預設啟用。這表示使用者不需額外編譯或調整任何設定，即可在 PHP 專案中直接運用 GD 函式庫的功能。如此預設組態，大大簡化了在地開發環境中圖像處理功能的設定流程。

如何確認 GD 模組已啟用

雖然 GD 模組在 ServBay 中預設啟用，有時開發者也可能需要進一步確認其狀態，或參考具體設定資訊。最常見的驗證方法是利用 phpinfo() 函數。

於您的 ServBay 網站根目錄（例如 /Applications/ServBay/www/servbay.demo/）建立一個全新 PHP 檔案，名稱如 info.php。
將以下 PHP 程式碼貼入 info.php 檔案中：
php
```
<?php
phpinfo();
?>
```
1
2
3
透過瀏覽器開啟該檔案，例如輸入 http://servbay.demo/info.php。
在開啟的頁面中搜尋 "gd"。若 GD 模組正常啟用，會看到名為 "gd" 的章節，內有 GD 版本資訊與支援的圖像格式等詳盡設定。

如在 phpinfo() 輸出頁面中找到 "gd" 相關內容，即代表 GD 模組運作正常。

在 PHP 程式中使用 GD

當 GD 模組已啟用後，便可於 PHP 程式碼中自由利用 GD 函式庫所提供的各項方法進行圖像處理。以下是一個簡易範例，示範如何建立新的 PNG 圖像，並於圖中加上文字 "ServBay"。

在您的 ServBay 網站根目錄（如 /Applications/ServBay/www/servbay.demo/）建立一個新 PHP 檔案，如 generate_image.php。

將以下範例程式碼複製進 generate_image.php 檔案：

php

<?php
// 設定圖像尺寸
$width = 400;
$height = 200;

// 建立一個空白圖像
// imagecreatetruecolor 建立一個真彩色圖像
$image = imagecreatetruecolor($width, $height);

// 配置顏色
// imagecolorallocate 為圖像分配顏色並返回顏色識別碼
$backgroundColor = imagecolorallocate($image, 200, 200, 200); // 淺灰色背景
$textColor = imagecolorallocate($image, 0, 0, 128); // 深藍色文字

// 填滿背景
// imagefill 以指定顏色填滿圖像
imagefill($image, 0, 0, $backgroundColor);

// 設定字型路徑（可選，若使用系統字型或指定字型檔案）
// 注意：imagestring 使用內建字型，不需指定字型檔
// 若用 imagettftext 則需指定字型文件路徑

// 新增文字水印
$text = 'Powered by ServBay & GD';
$fontSize = 5; // imagestring 支援字型大小 (1-5)
$x = 20; // 文字起始 X 座標
$y = 90; // 文字起始 Y 座標

// imagestring 於圖像繪製一行文字
imagestring($image, $fontSize, $x, $y, $text, $textColor);

// 設定 HTTP 標頭，通知瀏覽器為 PNG 圖像輸出
header('Content-Type: image/png');

// 輸出圖像至瀏覽器
imagepng($image);

// 可選：將圖像存檔
// imagepng($image, 'output_image.png'); // 將圖像以 output_image.png 存於當前腳本目錄

// 釋放記憶體
// imagedestroy 銷毀圖像資源，釋放記憶體
imagedestroy($image);
?>

以瀏覽器訪問該檔案（如 http://servbay.demo/generate_image.php），即可看到由 PHP 動態生成並內含指定文字的圖像。

這個範例展示了 GD 函式庫的基本應用：創建圖像、分配顏色、填滿背景與繪製文字。您可依據這些基礎操作，結合 GD 提供的其他函式來完成更進階的圖像處理需求。

常見 GD 應用情境

在 Web 開發中，GD 函式庫通常用於以下幾種情境：

生成縮圖： 自動為上傳圖片建立不同尺寸的縮圖。
加上浮水印： 在圖片上附加文字或圖形浮水印，提升版權保護或品牌識別。
建立驗證碼： 生成具隨機字元及干擾線條的圖片驗證碼，提升網站安全性。
繪製圖表： 根據數據動態產生簡易柱狀圖、折線圖等視覺化圖表。
圖像格式轉換： 將圖片於不同格式間互轉。
簡易圖片編輯： 執行裁切、旋轉、調整亮度／對比等基本處理。

結論

ServBay 為 PHP 開發者預載並預設啟用 GD 模組，讓在在地環境下進行圖像處理設定變得更加簡單。透過 ServBay，您可輕鬆發揮 GD 函式庫的強大功能，於 PHP 網頁專案中實現各式圖像生成與編輯任務。結合 ServBay 所提供完善的在地開發環境，您可高效打造並測試具圖像處理需求的應用程式。

ServBay 中的 GD 模組：PHP 圖像處理指南 ​

GD 模組簡介 ​

主要功能特色 ​

ServBay 對 GD 模組的支援 ​

如何確認 GD 模組已啟用 ​

在 PHP 程式中使用 GD ​

常見 GD 應用情境 ​

結論 ​