PHP如何检测扩展是否加载

本文深入解析了PHP中`extension_loaded()`函数的正确用法与常见陷阱：它仅能准确判断通过php.ini显式启用的动态扩展（如curl、pdo_mysql），对JSON、mbstring等编译为内置模块的扩展始终返回false，即便相关函数可正常调用；同时强调CLI与Web环境使用独立的php.ini配置，导致检测结果不一致是部署故障的高发原因；文章还提供了更可靠的替代方案——用`function_exists()`验证功能可用性、`get_loaded_extensions()`批量检查、`zend_extension_loaded()`专检Zend扩展，并提醒开发者在容器化或跨环境部署时务必统一配置并重启对应服务。

怎么用 extension_loaded 检查扩展是否启用

直接调用 extension_loaded，传入扩展名字符串（不带 .so 或 .dll 后缀），返回布尔值：true 表示已加载，false 表示未加载或不存在。

常见错误是传错名字——比如查 mysqli 写成 mysql 或 mysqli.so；又或者在 CLI 和 Web SAPI 下环境不一致，导致本地测试通过、线上报错。

• extension_loaded('curl') ✅ 正确（小写，无后缀）
• extension_loaded('CURL') ❌ 大小写敏感，Windows 下可能侥幸通过，Linux 下必失败
• extension_loaded('gd.so') ❌ 后缀多余，永远返回 false
• 在 php.ini 里启用了 opcache，但没重启 PHP-FPM —— extension_loaded('opcache') 仍为 false

为什么 extension_loaded 返回 false 却能用函数

有些扩展（如 json、mbstring）在 PHP 8+ 中被编译为“常驻内置模块”，即使没显式启用，函数也能调用；但 extension_loaded 仍返回 false。这不是 bug，是 PHP 的模块加载机制差异。

典型场景：Docker 官方镜像默认编译了 json，但没在 php.ini 里写 extension=json，所以 extension_loaded('json') 是 false，而 json_encode() 照常工作。

• 判断“能否调用某函数”更稳妥的方式是 function_exists('json_encode')
• 判断“是否显式启用扩展”才用 extension_loaded，比如做配置校验或安装向导
• extension_loaded 对 pdo_mysql 这类需手动启用的扩展才可靠，对 json、hash 等易产生误判

CLI 和 Web 环境下结果不一致怎么办

根本原因是 CLI 和 Apache/FPM 使用的是两套 php.ini 文件，扩展启用状态彼此独立。运行 php --ini 和 phpinfo() 输出的配置路径往往不同。

最容易被忽略的是：你改了 /etc/php/8.2/apache2/php.ini，却用 php -m | grep curl（走 CLI 配置）验证，自然对不上。

• CLI 下查加载项：php -m 或 php -r "var_dump(extension_loaded('curl'));"
• Web 下查加载项：建个 info.php，内容为 ，浏览器打开看 “Loaded Extensions”
• 想统一行为？在所有 php.ini 文件中都加同一行：extension=curl，然后重启对应服务（systemctl restart php8.2-fpm 或 apache2）

替代方案：get_loaded_extensions 更适合批量检查

当你要确认多个扩展是否就位（比如框架启动前校验依赖），用 get_loaded_extensions() 拿到全量数组，再用 in_array() 查，比反复调 extension_loaded 更轻量、也更清晰。

注意它返回的是小写扩展名列表，且不含 Zend 扩展（如 opcache 不在其中，得用 zend_extension_loaded 单独查）。

• $loaded = get_loaded_extensions(); in_array('redis', $loaded) ✅ 推荐用于初始化检查
• extension_loaded('opcache') ❌ 总是 false，正确姿势是 zend_extension_loaded('opcache')
• 某些容器环境（如 alpine + apk 安装）会把扩展名映射为别名（如 pgsql 实际注册为 pdo_pgsql），得按 php -m 输出的真实名称匹配

实际部署时，最麻烦的不是不会写这行代码，而是没意识到 CLI 和 Web 的 php.ini 是两回事，以及内置模块和动态扩展在 extension_loaded 眼里根本不是一回事。

今天关于《PHP如何检测扩展是否加载》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！