萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 啟用 GD2 擴展圖文教程:php.ini 設定與驗證步驟

前言

GD2 是 PHP 內建的圖形處理擴展,支援 JPEG、PNG、GIF、WebP 等格式的建立、縮放、裁切、水印等操作。預設安裝時可能未啟用,本文提供詳細的啟用步驟與驗證方法。

一、確認 php.ini 位置

  1. 建立 phpinfo.php:<?php phpinfo(); ?>
  2. 瀏覽器開啟,尋找 Loaded Configuration File 欄位,即為生效的 php.ini 完整路徑。
  3. 或在 CLI 執行:php --ini

二、編輯 php.ini 啟用 GD2

  1. 用文字編輯器(VS Code、Notepad++、vim)開啟 php.ini
  2. 搜尋 extension=gd 或 extension=php_gd2.dll(PHP 7.2 以前)
  3. 將行首分號 ; 移除:
; Before
;extension=gd

; After (PHP 7.2+)
extension=gd

; After (PHP 5.6 / 7.0 / 7.1)
extension=php_gd2.dll
  1. 儲存檔案

三、重新啟動 Web 伺服器 / PHP-FPM

環境重啟指令
Apache (Linux)systemctl restart httpd 或 apachectl restart
Nginx + PHP-FPMsystemctl restart php-fpm(或 php7.4-fpm 等特定版本)
Windows (IIS/Apache)重啟對應服務,或重啟電腦
Dockerdocker restart <container> 或重建映像

四、驗證 GD2 是否啟用成功

方法 1:phpinfo()

重新整理 phpinfo.php,搜尋 gd 區塊,應顯示:

  • GD Support: enabled
  • GD Version: bundled (2.1.0 compatible) 或系統版本
  • FreeType Support: enabled(若有安裝)
  • JPEG/PNG/GIF/WebP Support: enabled

方法 2:命令列檢查

php -m | grep -i gd
# 輸出:gd

方法 3:撰寫測試腳本

<?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() 等強大圖形函數,實現縮圖、水印、驗證碼等功能。

copyright © 萬盛學電腦網 all rights reserved