gd库检测失败主因是php运行时未加载或加载失败，需通过phpinfo()、php -m或gd_info()函数确认真实状态，而非依赖探针显示。
PHP探针检测不到 GD 库，绝大多数情况不是 GD 没装，而是 PHP 运行时没加载或加载失败——直接查 phpinfo() 或命令行 php -m | grep gd 才能确认真实状态。
为什么探针页面不显示 GD 模块？
探针（如 phpinfo.php）本质是调用 phpinfo() 函数输出 PHP 运行环境信息。它只反映当前 Web SAPI（如 Apache 模块或 FPM）加载的扩展，和 CLI 下看到的可能完全不同。
- Web 服务器用的是
php-fpm，但你用php -m查的是 CLI 版本的配置，两者php.ini路径不同 -
gd扩展在php.ini中被注释（;extension=gd）或写错路径（如extension=gd.so但实际是gd.so不存在，或应为extension=gd） - GD 依赖的系统库缺失（如
libjpeg、libpng），导致扩展加载失败，错误被静默忽略（尤其在某些旧版探针中）
如何快速定位 GD 是否真正可用？
绕过探针，直击 PHP 运行时：
php -r "var_dump(extension_loaded('gd'));"
// 输出 bool(true) 表示 CLI 下 GD 已加载
php -r "var_dump(gd_info());" // 若报错或返回 false，说明 GD 加载失败或被禁用
对 Web 环境，新建一个 test-gd.php 放到 Web 目录下访问：
立即学习“PHP免费学习笔记（深入）”；
<?php
if (extension_loaded('gd')) {
echo "GD loaded.\n";
print_r(gd_info());
} else {
echo "GD not loaded.";
}
?>
注意：这个结果才代表探针该看到的内容。如果这里都失败，探针当然看不到。
常见修复操作（按优先级排序）
确认 Web 使用的 php.ini 路径（通过 phpinfo() 页面搜索 “Loaded Configuration File”）：
- 打开对应
php.ini，取消注释：extension=gd（PHP 8+）或extension=gd.so（Linux） /extension=php_gd2.dll（Windows） - 检查扩展文件是否存在：
ls -l $(php-config --extension-dir)/gd*（Linux/macOS）；若无，需重装 GD（如apt install php-gd或brew install php-gd） - 重启对应服务：
sudo systemctl restart php*-fpm（FPM）或sudo systemctl restart apache2（Apache） - 若仍报
undefined symbol: jpeg_read_header类错误，说明系统缺少 JPEG/PNG 支持库，需安装：apt install libjpeg-dev libpng-dev libfreetype6-dev，再重新编译或重装 GD 扩展
探针本身也有兼容性问题
部分老旧探针（如某些中文版 PHP 探针）硬编码过滤了模块名，或只扫描 extension_loaded() 返回 true 的扩展，却忽略 gd_info() 是否可调用。更隐蔽的问题是：GD 被启用，但 gd.jpeg_ignore_warning 或 gd.jpeg_quality 等 ini 设置异常，导致 gd_info() 内部初始化失败，整个模块在探针里“消失”。此时 var_dump(gd_info()) 会返回 false，而非报错。
别迷信探针显示，gd_info() 的返回值才是 GD 功能是否真正就绪的唯一依据。
