phpinfo() 中看不到扩展通常因 php 未找到或加载失败扩展文件,需先确认实际加载的 php.ini 路径,检查 extension_dir、文件名大小写、依赖库、apache 与 cli 配置分离、zts/版本匹配、ld_library_path 及模块加载顺序等问题。

phpinfo() 里看不到扩展名,但 extension=xxx.so 已写在 php.ini 中
这通常不是配置没生效,而是扩展文件根本没被 PHP 找到或加载失败。先确认 PHP 实际读取的是哪个 php.ini:运行 php --ini(CLI)或在 Web 环境中建个 info.php 输出 phpinfo(),重点看 “Loaded Configuration File” 行。
常见问题包括:
-
extension_dir路径错误(比如指向了旧版本的ext/目录,或用了相对路径但工作目录不一致) - 扩展文件名拼写错误,例如写成
extension=mysqli.so,但在某些系统上实际是mysqli.so(没错,名字对),但路径下其实是mysqli.so—— 看似一样,实则大小写敏感(Linux)或文件不存在(Windows) - 扩展依赖的共享库缺失,比如
gd.so启动时报undefined symbol: jpeg_read_header,说明系统缺 libjpeg
Apache + mod_php 下扩展加载失败,但 CLI 模式正常
这是最典型的环境错位问题:CLI 和 Apache 使用的是两套独立的 PHP 配置。Apache 的 PHP 模块(libphp.so 或 php_module)启动时,会用自己的 php.ini 路径(由编译参数或 PHPIniDir 指令指定),和你在终端执行 php -v 看到的不是一回事。
解决步骤:
立即学习“PHP免费学习笔记(深入)”;
- 在 Apache 的
httpd.conf或虚拟主机配置中检查是否设置了PHPIniDir,例如:PHPIniDir "/etc/php/8.2/apache2" - 确认该路径下存在有效的
php.ini,且其中extension_dir指向正确的扩展目录(如/usr/lib/php/8.2/extensions/no-debug-zts-20220829/) - 重启 Apache 后,务必用浏览器访问
phpinfo()页面验证 —— CLI 的php -m结果在这里完全不作数
启用扩展后 Apache 启动失败,报 httpd: Syntax error 或直接 segfault
这类错误往往出现在扩展与 PHP 版本、ZTS(线程安全)模式不匹配时。尤其常见于手动编译的扩展或第三方 PECL 包。
排查要点:
- 运行
php -v查看 PHP 版本号和 ZTS 状态(含zts字样表示启用了线程安全) - 检查扩展文件是否匹配:用
file xxx.so看架构,用php-config --extension-dir确认目标目录,再比对php-config --version和当前 PHP 版本 - 临时禁用可疑扩展(注释掉
extension=行),逐个启用并apachectl configtest && apachectl restart测试 - 若扩展依赖外部库(如
pdo_pgsql依赖libpq),确保LD_LIBRARY_PATH在 Apache 启动环境中已设置(可通过envvars文件或 systemd 的Environment=设置)
使用 phpenmod 或 phpdismod 后扩展仍不生效
这些命令只在 Debian/Ubuntu 系统的 php*-apache / php*-cli 包管理场景下有效,且仅作用于对应 SAPI 的配置片段(如 /etc/php/8.2/apache2/conf.d/20-mysqli.ini)。它们不会修改主 php.ini,也不会影响非包管理安装的 PHP。
注意点:
- 确认你操作的是正确的 PHP 版本分支(
phpenmod -v 8.2 mysqli),否则可能改了 CLI 的配置却期望 Apache 生效 - 检查生成的
.ini文件是否真的被包含:在phpinfo()的 “Additional .ini files parsed” 区域查看路径列表 - 如果用了 Ondrej PPA,注意它默认为 Apache 和 CLI 分别维护两套配置,
phpenmod默认只处理 CLI;加-s apache2才能写入 Apache 配置目录
最常被忽略的一点:Apache 的模块加载顺序。如果某个扩展(如 opcache)必须早于其他扩展加载,而你把它放在了 php.ini 底部,就可能因依赖未就绪而静默失败 —— 此时日志里未必有明确报错,phpinfo() 里也只显示“未加载”。











