PHP的GD扩展不可用通常因未启用或依赖缺失，而非漏装；应先检查是否已安装但未启用，再确认libjpeg/libpng/freetype等开发包是否齐全，最后按需启用或编译。
PHP 安装后 gd 扩展不可用，不是“漏装”，而是默认不启用或依赖未满足——手动编译添加前，先确认是否真需要从源码编译。
检查 GD 是否已安装但未启用
很多情况下 gd 库其实已随系统包安装，只是没在 php.ini 中启用。运行以下命令验证：
php -m | grep gd php -i | grep -i gd
如果输出为空，再查扩展文件是否存在：
-
ls /usr/lib/php/*/gd.so（Debian/Ubuntu） -
ls /usr/lib64/php/modules/gd.so（CentOS/RHEL）
若文件存在但未启用，在 php.ini 里加一行：extension=gd，然后重启 Web 服务（如 systemctl restart apache2 或 systemctl restart php-fpm）。
立即学习“PHP免费学习笔记（深入）”；
缺少 libjpeg / libpng / freetype 等编译依赖
GD 编译失败最常见的原因是底层图像库缺失，而非 PHP 源码问题。不同系统需安装对应开发包：
- Ubuntu/Debian：
sudo apt install libjpeg-dev libpng-dev libfreetype6-dev - CentOS/RHEL 8+：
sudo dnf install libjpeg-devel libpng-devel freetype-devel -
macOS（Homebrew）：
brew install jpeg png freetype
注意：必须安装 -dev 或 -devel 后缀的包，仅装运行时库（如 libjpeg）会导致 configure 阶段报 configure: error: jpeglib.h not found。
源码编译时启用 GD 的正确参数
如果你确实是从 PHP 源码编译（如 ./configure），GD 不是独立扩展，而是通过 --with-gd 控制，且需显式指定依赖路径（尤其当库装在非标准位置时）：
./configure \ --with-gd \ --with-jpeg-dir=/usr \ --with-png-dir=/usr \ --with-freetype-dir=/usr \ --with-webp-dir=/usr \ ...其他参数...
关键点：
-
--with-gd必须存在，否则不会构建 GD 支持 -
--with-jpeg-dir等路径要指向包含include/jpeglib.h和lib/libjpeg.so的父目录（不是/usr/include） - 较新 PHP（8.0+）默认启用 WebP，若系统无
libwebp-dev，可加--without-webp避免报错
已安装 PHP 但想追加 GD（无需重装整个 PHP）
可以只编译 GD 扩展模块，前提是 PHP 源码和 phpize 可用：
cd /path/to/php-src/ext/gd phpize ./configure --with-gd --with-jpeg-dir=/usr --with-png-dir=/usr make && sudo make install
完成后在 php.ini 加 extension=gd.so。注意：make install 输出的路径（如 /usr/lib/php/20220829/）要和 extension_dir 一致，否则会提示 Unable to load dynamic library 'gd.so'。
真正卡住的往往不是编译步骤，而是依赖路径写错、开发头文件包没装全、或 phpize 对应的 PHP 版本与当前运行版本不匹配——这三个点比“怎么敲命令”重要得多。
