PHP怎么检测扩展是否加载_extension_loaded函数用法【方法】-php教程-PHP中文网

extension_loaded('curl')返回true表示扩展已加载，需传小写无后缀名称；cli与web环境php.ini独立，内置模块（如json）即使未显式启用也可用函数但extension_loaded仍返回false。

php怎么检测扩展是否加载_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

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

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

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

根本原因是 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，内容为 <?php phpinfo(); ?>，浏览器打开看 “Loaded Extensions”
想统一行为？在所有 php.ini 文件中都加同一行：extension=curl，然后重启对应服务（systemctl restart php8.2-fpm 或 apache2）

当你要确认多个扩展是否就位（比如框架启动前校验依赖），用 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 输出的真实名称匹配