Composer 报扩展缺失错误？先别急着折腾 Composer，问题根源在 PHP 环境
遇到 Composer 报错提示缺少某个 PHP 扩展，先明确一个核心逻辑：这通常不是 Composer 本身的问题，而是它作为一个依赖管理器，在执行前检测到你的 PHP 运行环境缺少必要的“零件”。 所以，你得先让 PHP 自己能加载那个扩展，Composer 才能顺利工作。
第一步：快速定位问题，别在错误的方向上浪费时间
错误信息通常长这样：Package phpunit/phpunit requires ext-dom *，或者更笼统的 Your requirements could not be resolved to an installable set of packages.，下面跟着一串 ext-xxx 不满足的列表。看到这个，先别慌，也别急着去安装，得确认清楚两件事：
- 这个扩展（比如
dom、xml）是真的没装，还是仅仅因为命令行（CLI）模式和 Web 服务器模式使用了不同的php.ini配置文件？ - 运行
php -m | grep dom（Linux/macOS）或者php -m后在列表里手动查找（Windows），检查 CLI 模式下扩展是否已加载。记住，Composer 默认使用命令行接口的 PHP，不是你 Apache 或 Nginx 里跑的那个。 - 执行
php --ini命令，看看 CLI 当前读取的是哪个php.ini文件，确保后续修改的是对的配置文件。 - 有个细节容易混淆：像
dom、simplexml这类扩展，很多时候是 PHP 编译时内置的，并不单独提供.so或.dll文件。它们可能只是被禁用了，而不是“没有安装”。
Ubuntu/Debian 系统：安装扩展其实很简单
在这类系统上，安装 PHP 扩展的包名格式和你的 PHP 版本强相关，漏掉版本号大概率会失败。以 PHP 8.2 为例，操作流程如下：
- 首先，确认当前 CLI 的 PHP 版本：
php -v。 - 更新软件包源：
sudo apt update。 - 安装所需扩展，注意包名格式：
sudo apt install php8.2-gd php8.2-curl php8.2-mbstring php8.2-xml php8.2-zip。 - 这些扩展包安装后，通常会自动在
/etc/php/8.2/cli/conf.d/目录下生成对应的配置文件，一般无需你手动修改主php.ini。 - 最后，用
php -m | grep gd这样的命令验证一下，有输出就代表成功了。
CentOS/RHEL/Rocky Linux 系统：注意内置扩展的启用
在这些基于 Red Hat 的发行版上，情况稍有不同。像 XML 相关的功能通常被打包在 php-xml 这个包里，但安装后不一定自动启用——尤其是 dom 和 simplexml 这类扩展，它们依赖于 xml 扩展才能工作。
立即学习“PHP免费学习笔记（深入）”；
- 先安装基础的 XML 支持包：对于 PHP 8.0+ 用
sudo dnf install php-xml，旧版本则用sudo yum install php-xml。 - 检查是否自动生成了启用文件：
ls /etc/php.d/*xml*.ini，常见的文件名类似20-xml.ini。 - 如果没有自动生成，可以手动在
/etc/php.d/目录下创建一个文件，比如15-dom.ini，内容只需一行：extension=dom。 - 修改配置后，别忘了重启 PHP-FPM 或 Apache 服务：
sudo systemctl restart php-fpm或sudo systemctl restart httpd。 - 再次运行
php -m | grep dom确认，必须在 CLI 模式下看到输出才算真正可用。
Windows 环境：路径和配置是关键
Windows 用户最容易在这里踩坑：扩展的 DLL 文件明明存在，但 php.ini 没配对，或者路径设置不对。
- 首先，确认 CLI 正在读取哪个
php.ini：php --ini。 - 用文本编辑器打开这个
php.ini，找到类似;extension=mbstring的行，去掉行首的分号来取消注释。 - 确保
extension_dir这个配置项指向了正确的目录。例如，extension_dir = "ext"（这是相对于 PHP 安装根目录的相对路径），或者使用绝对路径如"C:/php/ext"。 - 去
ext/目录下核实一下，php_mbstring.dll这类文件是否确实存在，文件名必须完全匹配（注意大小写）。 - 保存修改后，务必在命令行中运行
php -m来验证，不要只依赖浏览器里查看phpinfo()的结果。
最后，分享一个最常被忽略的经验：Composer 只认命令行（CLI）的 PHP 配置。 你在浏览器里通过 phpinfo() 看到的环境，和 Composer 使用的环境，很可能不是一回事。所以，每次修改完扩展配置，一定要在终端里用 php -m 和 php -v 来验证，这才是最可靠的确认方式。
