使用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 -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
登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制登录后复制之外,第二个必看的地方。
排查这些问题时,耐心和细致是关键。一步步来,总能找到症结所在。
以上就是PHP命令怎样查看已安装的PHP扩展 PHP命令查看扩展的基础教程的详细内容,更多请关注php中文网其它相关文章!