使用php -m列出已加载的扩展，php -i查看详细配置信息，结合grep过滤目标扩展，通过php --ini定位配置文件，检查extension_dir路径、版本兼容性及CLI与Web环境差异，并查阅错误日志排查加载失败问题。
查看PHP已安装的扩展，最直接的方式就是通过命令行工具。这不仅能让你快速掌握当前PHP环境的概况，也是排查扩展加载问题时的首要步骤。
解决方案
要查看PHP已安装或已加载的扩展，你可以使用两个核心的PHP命令行参数：
php -m和
php -i。
php -m会列出所有已加载的PHP模块（扩展）。这是一个非常简洁的列表，只包含扩展的名称，非常适合快速概览。
如果你需要更详细的信息，比如某个扩展的具体配置参数、版本号，甚至是PHP本身的编译信息，那么
php -i就派上用场了。它会输出一个非常详尽的PHP配置信息页面，类似你在浏览器中访问
phpinfo()页面看到的内容，只不过是在命令行里。
立即学习“PHP免费学习笔记（深入）”；
如何快速列出所有已加载的PHP扩展？
我个人就经常用
php -m来快速确认某个扩展是否已经成功加载。这个命令非常轻量，执行起来也很快。你只需要在终端里输入：
php -m
执行后，你会看到一个按字母顺序排列的扩展列表，比如
Core,
date,
libxml,
openssl,
pdo_mysql等等。这个列表直接告诉你，当前PHP CLI环境下，哪些扩展是“活”着的。
有时候，你可能只想看看某个特定的扩展有没有加载。这时候，结合
grep命令会非常方便。比如，我想知道
GD扩展有没有，我会这样敲：
php -m | grep gd
如果输出里有
GD，那就说明它已经加载了。如果没有，那可能就是没安装，或者安装了但没在
php.ini里启用。这种组合用法，在日常的开发和运维中，简直是我的效率利器。它能避免我翻阅冗长的
php -i输出，直接命中目标。
深入了解PHP扩展的详细信息：php -i
的妙用
如果
php -m只是告诉你“有没有”，那么
php -i就是告诉你“有什么细节”。当你需要深入了解一个扩展的配置、它的版本、甚至它依赖的库路径时，
php -i是不可或缺的。
输入以下命令：
php -i
你会看到一大段输出，里面包含了PHP的编译选项、服务器API（SAPI）信息、加载的
php.ini文件路径、以及每个已加载扩展的详细配置。例如，如果你想查看
MySQLi扩展的具体配置，你可以在
php -i的输出中找到一个专门的
MySQLi部分，里面会列出它的客户端库版本、是否支持SSL等信息。
当然，直接看
php -i的全部输出可能会让人眼花缭乱。所以，通常我们会结合
grep来过滤信息，就像这样：
php -i | grep -i pdo_mysql
或者，如果你想看所有与
MySQL相关的配置，可以更宽泛一些：
php -i | grep -i mysql
这样做，就能迅速定位到你关心的那个扩展或配置项，避免在海量信息中迷失。这对于调试那些奇怪的扩展行为，或者验证某个配置是否生效，是极其有用的。比如，我曾经遇到过PDO扩展连接数据库失败，后来发现是
php -i显示的客户端库版本和服务器不兼容，这种细节只有
php -i能告诉我。
PHP扩展加载失败或未按预期工作？排查常见问题
有时候，我们明明安装了扩展，
php -m却没看到它，或者
php -i显示的信息不对劲。这通常意味着扩展没有正确加载，或者存在一些配置问题。这里有几个我常遇到的坑和排查思路：
-
php.ini
配置问题： PHP加载扩展需要extension=
或zend_extension=
指令。你需要找到当前PHP实例实际加载的php.ini
文件。使用php --ini
可以告诉你PHP正在使用哪些配置文件。php --ini
输出会列出
Loaded Configuration File
（已加载的主配置文件）以及Scan for additional .ini files in:
（额外扫描的目录）。很多时候，扩展的ini
文件就放在这些额外扫描的目录里。确保你的extension=xxx.so
(Linux/macOS) 或extension=xxx.dll
(Windows) 行是正确的，并且没有被注释掉。 扩展文件路径不正确：
extension_dir
配置项指定了PHP查找扩展的目录。如果你的扩展文件（.so
或.dll
）不在这个目录里，或者你提供的路径不对，PHP就找不到它。你可以在php -i
的输出中找到extension_dir
的值。PHP版本或架构不兼容： 编译好的PHP扩展通常是针对特定PHP版本和系统架构（32位/64位）的。如果你安装的扩展是为PHP 7.x编译的，而你的PHP是8.x，那很可能就无法加载。同样，32位PHP不能加载64位扩展，反之亦然。这在升级PHP版本后尤其常见。
CLI与Web SAPI差异： 值得注意的是，你通过
php -m
或php -i
看到的是PHP CLI（命令行接口）的扩展情况。如果你是在Web服务器（如Apache或Nginx + PHP-FPM）环境下运行PHP应用，它们可能加载的是不同的php.ini
文件，因此扩展列表和配置也可能不同。务必检查Web服务器使用的PHP配置。通常，Web服务器会有自己的PHP信息页面（比如phpinfo.php
文件），那才是Web环境下的真实情况。错误日志： 当扩展加载失败时，PHP通常会在错误日志中记录详细信息。查看PHP-FPM的日志（比如
/var/log/php-fpm/error.log
）或Web服务器的错误日志（如Apache的error_log
，Nginx的error.log
），往往能找到关键的线索，比如“undefined symbol”或者“module not found”之类的错误。这是我排查问题时，除了php -i
之外，第二个必看的地方。
排查这些问题时，耐心和细致是关键。一步步来，总能找到症结所在。
