phpinfo() 中 Configure Command 未顯示 --with-gd 或 --enable-gd,gd 區塊缺失,function_exists('gd_info') 回傳 false。
| 原因 | 檢查方式 | 解決步驟 |
|---|---|---|
| php.ini 未啟用擴展 | php -m | findstr gd 無輸出 | 編輯 php.ini:extension=gd (PHP 7.2+)extension=php_gd2.dll (舊版) |
| DLL 檔案缺失/版本不符 | php -v 顯示 VC15 x64,但 dll 為 VC11 x86 | 下載與 PHP 版本、VC 編譯器、執行緒安全性 (TS/NTS) 完全一致的 DLL |
| 依賴 DLL 缺失 (libpng, freetype, jpeg, libwebp, libxpm) | 事件檢視器 / Dependency Walker 顯示缺失 | 將依賴 DLL 放入 PHP 目錄或系統 PATH |
| extension_dir 路徑錯誤 | php -i | findstr extension_dir | 設定正確絕對路徑,重啟服務 |
| CGI/FastCGI 快取舊配置 | 修改 ini 後未重啟 | 重啟 php-fpm / IIS / Apache |
| 權限問題 | PHP 進程無法讀取 dll/依賴 | 授予 IIS_IUSRS / 執行身份 讀取執行權限 |
<?php
// test_gd.php
if (!extension_loaded('gd')) {
die("GD 未載入\n");
}
$info = gd_info();
print_r($info);
// 實際繪圖測試
$im = imagecreatetruecolor(200, 100);
$white = imagecolorallocate($im, 255, 255, 255);
$black = imagecolorallocate($im, 0, 0, 0);
imagefilledrectangle($im, 0, 0, 199, 99, $white);
imagestring($im, 5, 50, 40, 'GD OK', $black);
header('Content-Type: image/png');
imagepng($im);
imagedestroy($im);
php-gd 純 PHP 版 (效能極差,僅限極簡場景)。php:8.2-apache 官方映像已內建 GD、完整依賴,避免 Windows 環境地獄。