PHP命令怎样查看已安装的PHP扩展 PHP命令查看扩展的基础教程-php教程-PHP中文网

PHP命令怎样查看已安装的PHP扩展 PHP命令查看扩展的基础教程

WBOY

发布： 2025-08-18 23:02:01

原创

191人浏览过

使用php -m列出已加载的扩展，php -i查看详细配置信息，结合grep过滤目标扩展，通过php --ini定位配置文件，检查extension_dir路径、版本兼容性及CLI与Web环境差异，并查阅错误日志排查加载失败问题。

php命令怎样查看已安装的php扩展 php命令查看扩展的基础教程

查看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
```
登录后复制
之外，第二个必看的地方。