在PHP应用开发与部署过程中，确认某个PHP扩展是否已经被正确加载，是保证程序正常运行的基础工作。如果代码依赖如curl、gd、mbstring等扩展却未启用，运行时会抛出致命错误。因此，我们需要在代码层或环境层面对扩展加载状态做出准确判断。
使用extension_loaded函数检测
最直接且常用的方式是在PHP脚本中调用extension_loaded函数。该函数接收一个扩展名称字符串，若扩展已加载则返回true，否则返回false。扩展名不区分大小写，但通常推荐使用官方文档中的小写写法。
这种方法的优势在于性能开销极低，适合写进框架的启动文件或业务代码的依赖检查逻辑里。比如在执行图片处理前，先确认gd扩展存在，避免后续调用不存在的函数。下面的示例展示了如何封装一个简易的检测辅助函数：
<?php
// 检测指定PHP扩展是否加载
function checkExtension($name) {
if (extension_loaded($name)) {
return true;
}
return false;
}
// 实际使用示例
if (!checkExtension('curl')) {
die('当前环境未加载curl扩展，请先安装并启用');
}
echo 'curl扩展已加载，可正常使用';
?>
从上述代码可以看出，extension_loaded非常适合做运行时的条件判断。如果扩展未加载，我们可以给出友好提示或切换到兼容实现，而不是让程序直接崩溃。
需要注意的是，某些扩展在PHP编译时静态内置，也会被视为已加载；而通过php.ini动态加载的共享扩展同样能被该函数识别。因此无论部署形态如何，此方法都可靠。
通过get_loaded_extensions获取全部列表
当我们想一次性了解环境中所有已启用的扩展，可以使用get_loaded_extensions函数。它返回一个索引数组，包含当前PHP进程加载的全部扩展名称。
配合in_array判断，也能实现类似extension_loaded的效果，但前者在只查单个扩展时效率更高。下面示例演示如何打印所有扩展并检测特定项：
<?php
// 获取所有已加载扩展
$extensions = get_loaded_extensions();
// 输出扩展数量
echo '已加载扩展总数：' . count($extensions) . "n";
// 检测mbstring是否在列表中
if (in_array('mbstring', $extensions, true)) {
echo 'mbstring扩展可用';
} else {
echo 'mbstring扩展未加载';
}
?>
这种方式在写环境探测脚本或安装向导时非常实用，因为可以遍历并生成完整的依赖报告。不过如果仅为了判断一个扩展，反复调用get_loaded_extensions会产生不必要的数组构造开销。
另外，该函数有一个可选参数$zend_extensions，设为true时可单独返回Zend引擎扩展，例如opcache，这对区分普通扩展和引擎级扩展很有帮助。
利用phpinfo与命令行工具
在非代码层面，最直观的办法是访问phpinfo()函数生成的页面。在脚本中写入<?php phpinfo(); ?>并访问，浏览器会展示包括已加载扩展在内的详尽配置。但该函数会暴露大量环境信息，生产环境严禁保留。
在服务器终端，则可以使用命令行快速查看。CLI模式下执行php -m会列出当前命令行PHP加载的模块；若想确认web服务用的PHP，需对应其php.ini路径。示例如下：
# 查看CLI模式加载的扩展模块 php -m # 筛选是否包含指定扩展 php -m | grep -i sockets
命令行方式对运维人员十分友好，能在不写脚本的情况下完成巡检。但它依赖shell环境，不能嵌入PHP业务逻辑中做动态判断。
综合来看，代码内检测优先选extension_loaded；环境排查用phpinfo或php -m；批量审计用get_loaded_extensions。根据场景选用，才能既准确又高效。
常见误区与注意事项
一个常见误区是认为function_exists能等同于扩展检测。虽然多数扩展会注册特定函数，但少数扩展仅提供类或常量，函数不存在不代表扩展未加载。因此应以extension_loaded为准。
另一个问题是区分PHP版本差异。部分扩展在PHP 7以后被移入核心或废弃，检测逻辑需要结合版本判断。如下示例展示更健壮的写法：
<?php
$ext = 'json';
if (extension_loaded($ext)) {
echo $ext . ' 扩展已加载';
} else {
// 某些旧版可能需判断函数
if (function_exists('json_encode')) {
echo '通过函数判定 json 支持存在';
} else {
echo 'json 功能不可用';
}
}
?>
这样能够在复杂环境中提供兜底逻辑，避免因检测方式单一导致误判。同时建议在项目文档中明确标注所需扩展，配合持续集成中的环境检测步骤，从源头减少部署故障。
最后提醒，修改php.ini启用扩展后必须重启Web服务或PHP进程，否则运行中的旧进程不会生效，这也是很多开发者反馈“明明已配置却检测不到”的根本原因。
PHPextension_loadedget_loaded_extensions修改时间：2026-08-06 18:39:34