GD2 是 PHP 內建的圖形處理擴展,支援 JPEG、PNG、GIF、WebP 等格式的建立、縮放、裁切、水印等操作。預設安裝時可能未啟用,本文提供詳細的啟用步驟與驗證方法。
phpinfo.php:<?php phpinfo(); ?>php.ini 完整路徑。php --iniphp.iniextension=gd 或 extension=php_gd2.dll(PHP 7.2 以前); 移除:; Before
;extension=gd
; After (PHP 7.2+)
extension=gd
; After (PHP 5.6 / 7.0 / 7.1)
extension=php_gd2.dll
| 環境 | 重啟指令 |
|---|---|
| Apache (Linux) | systemctl restart httpd 或 apachectl restart |
| Nginx + PHP-FPM | systemctl restart php-fpm(或 php7.4-fpm 等特定版本) |
| Windows (IIS/Apache) | 重啟對應服務,或重啟電腦 |
| Docker | docker restart <container> 或重建映像 |
重新整理 phpinfo.php,搜尋 gd 區塊,應顯示:
php -m | grep -i gd
# 輸出:gd
<?php
// test_gd.php
if (extension_loaded('gd')) {
echo "GD 已啟用\n";
echo "GD 版本: " . gd_info()['GD Version'] . "\n";
echo "支援格式: ";
$info = gd_info();
$formats = [];
foreach (['JPEG', 'PNG', 'GIF', 'WBMP', 'XPM', 'WebP', 'BMP'] as $fmt) {
if (!empty($info[$fmt . ' Support'])) $formats[] = $fmt;
}
echo implode(', ', $formats) . "\n";
} else {
echo "GD 未啟用\n";
}
| 現象 | 可能原因 | 解決方向 |
|---|---|---|
| phpinfo 無 gd 區塊 | 修改錯誤的 php.ini、未重啟服務 | 確認 Loaded Configuration File、重啟 PHP-FPM/Apache |
啟用後報錯 Unable to load dynamic library 'gd' | 缺少系統庫(libpng, libjpeg, freetype) | Linux: apt install libpng-dev libjpeg-dev libfreetype6-dev 後重新編譯 PHP 或安裝 php-gd 套件 |
| Windows DLL 載入失敗 | PHP 目錄不在 PATH、缺少相依 DLL | 將 PHP 目錄加入系統 PATH,確認 libpng16.dll 等檔案存在 |
| imagecreatefromwebp() 找不到 | GD 編譯時未包含 WebP 支援 | 重新編譯 PHP 加入 --with-webp,或升級 PHP 版本 |
啟用 GD2 只需三步驟:找 php.ini → 取消註解 extension=gd → 重啟服務。若遇到系統庫缺失,請依作業系統安裝相對應的開發套件(libpng-dev、libjpeg-dev、freetype-dev)。驗證無誤後,即可使用 imagecreatetruecolor()、imagecopyresampled() 等強大圖形函數,實現縮圖、水印、驗證碼等功能。