最直接可靠的方式是用 extension_loaded() 检查普通扩展,参数为小写内部名(如 'curl');Zend 扩展需通过函数或常量判断(如 opcache_get_status())。

用 extension_loaded() 检查扩展是否启用
最直接、最可靠的方式是调用 PHP 内置函数 extension_loaded(),它返回布尔值,无需解析配置或读文件。
注意:函数名区分大小写,参数是扩展的「内部名称」,不是 .so 或 .dll 文件名,也不是 php.ini 里写的 extension= 后半段(比如 mysqli 不是 php_mysqli.dll)。
-
extension_loaded('curl')✅ 正确(Windows/Linux 通用) -
extension_loaded('php_curl')❌ 错误(这是 Windows 下旧式 DLL 名) -
extension_loaded('gd2')❌ 错误(GD 扩展的内部名就是gd) -
extension_loaded('openssl')✅ 正确(即使php.ini写的是extension=php_openssl.dll)
if (extension_loaded('redis')) {
echo 'Redis 扩展已启用';
} else {
echo 'Redis 扩展未启用,请检查 php.ini 或安装';
}
用 get_loaded_extensions() 批量判断多个扩展
当探针需要一次性检查十几个扩展(如 mbstring、json、pdo_mysql)时,反复调用 extension_loaded() 效率低;更优做法是先获取全部已加载扩展列表,再用 in_array() 查找。
该函数返回索引数组,所有扩展名均为小写,不带版本后缀(如 intl 不是 intl-4.0.0)。
立即学习“PHP免费学习笔记(深入)”;
- 性能更好:只需一次内核扫描,后续是数组查找
- 避免大小写陷阱:统一转小写比对更安全
- 注意:
get_loaded_extensions(true)返回关联数组(按模块分类),探针中一般不用
$loaded = array_map('strtolower', get_loaded_extensions());
$required = ['curl', 'mbstring', 'json', 'pdo'];
foreach ($required as $ext) {
if (in_array($ext, $loaded)) {
echo "[✓] {$ext}\n";
} else {
echo "[✗] {$ext}\n";
}
}
别依赖 phpinfo() 或解析 php.ini
phpinfo() 虽能显示扩展状态,但输出是 HTML,不可靠用于程序判断——它可能被禁用(disable_functions=phpinfo),也可能因权限问题无法执行;而手动读取 php.ini 更危险:路径不确定(php --ini 输出多个)、格式不规范(分号注释、空格缩进、include 指令)、且「已写入」不等于「已生效」。
真实场景中常见坑:
- 开发环境启用了
opcache,但生产环境没重启 PHP-FPM,php.ini改了也没用 - 使用 Docker 时,
php.ini在容器内,探针脚本在宿主机运行,根本读不到 -
extension=xxx.so行前有空格或中文字符,导致解析失败
结论:只信运行时结果,不信配置文件内容。
注意 Zend 扩展(如 OPcache、Xdebug)不能用 extension_loaded()
Zend 扩展(zend_extension=)和普通扩展(extension=)加载机制不同,extension_loaded() 对它们始终返回 false。
正确检测方式是查 zend_ini_string() 或遍历 php_ini_scanned_files() 后手动解析,但最简单可靠的做法是检查其提供的函数或常量是否存在:
-
opcache_get_status()存在 → OPcache 已启用 -
function_exists('xdebug_info')或defined('XDEBUG_VERSION')→ Xdebug 已加载 -
extension_loaded('swoole')仍适用——Swoole 是普通扩展,不是 Zend 扩展
别硬套一个函数走天下,得看扩展类型。











