extension_loaded()是最直接的运行时扩展检测方法,返回布尔值,扩展名须小写且无后缀;phpinfo()适合调试环境快速查看全部已加载扩展;get_loaded_extensions()返回扩展名数组,适用于批量判断。

用 extension_loaded() 判断扩展是否已启用
这是最直接、最常用的方法,适用于运行时检查。它返回布尔值,true 表示扩展已加载,false 表示未加载或名称拼写错误。
注意:扩展名是小写的,且不含 .so(Linux)或 .dll(Windows)后缀;比如 openssl,不是 openssl.so 或 OpenSSL。
-
extension_loaded('curl')检查 cURL 是否可用 -
extension_loaded('mbstring')检查多字节字符串支持 - 若扩展依赖其他扩展(如
pdo_mysql依赖pdo),需分别检查两者 - 在 CLI 和 Web SAPI 下行为一致,但配置文件可能不同,实际结果可能不一致
用 phpinfo() 快速查看全部已加载扩展
执行 phpinfo() 会输出完整的 PHP 配置快照,其中 “Loaded Extensions” 区域列出所有已启用的扩展。适合调试环境快速确认。
注意:phpinfo() 输出信息量大,建议配合浏览器搜索(Ctrl+F)查找扩展名;生产环境应禁用该函数或限制访问,避免敏感信息泄露。
- 在 Web 环境中,新建
info.php文件,内容为<?php phpinfo(); ?>,然后通过浏览器访问 - CLI 下运行
php -i | grep -i "extension"可筛选关键词(Linux/macOS) - 部分扩展(如
opcache)会在独立区块显示详细配置,不只是出现在扩展列表里
用 get_loaded_extensions() 获取扩展名数组并搜索
该函数返回一个索引数组,包含所有已加载扩展的名称(全小写)。适合需要批量判断、动态启用逻辑或写检测脚本的场景。
相比 extension_loaded(),它多一次数组遍历,但能一次性获取全部状态,适合做兼容性预检。
-
in_array('gd', get_loaded_extensions())等价于extension_loaded('gd'),但略慢 - 扩展名大小写敏感,
'GD'或'Gd'都不会匹配 - 某些 ZTS(线程安全)构建中,部分扩展可能只在特定 SAPI 下加载,
get_loaded_extensions()的结果取决于当前执行上下文
常见失败原因和验证盲点
即使配置了 extension=xxx.so,扩展仍可能未加载——问题往往不出在检测逻辑,而出在加载环节本身。
-
php -m显示扩展名,但extension_loaded()返回false?很可能是 CLI 和 Web 使用了不同php.ini文件 - 扩展 .so/.dll 文件路径错误、权限不足、依赖库缺失(如
libpng缺失导致gd加载失败),此时错误通常记录在 Web 服务器错误日志中,而非 PHP 错误页面 -
disable_functions不影响扩展加载,但enable_dl被设为Off时,无法在运行时用dl()加载(不过该函数 PHP 8.0+ 已移除) - Docker 或容器化环境中,
docker exec -it xxx php -v查到的版本和扩展,未必等同于 Web 容器内实际生效的配置
扩展是否加载,本质是 ini 配置 + 扩展文件 + 运行时环境三者共同作用的结果;检测只是最后一步,真正卡住的地方,往往在 php.ini 路径或扩展文件本身的可执行性上。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











