Windows系统下CRAFT CMS项目运行composer install报错如何解决

步骤1：确认CLI模式下PHP已正确加载soap扩展 #

很多用户会误改Web服务对应的php.ini配置，而Composer调用的是命令行模式的PHP，二者加载的配置文件可能不一致：

• 执行命令php -m查看已加载的扩展列表，确认列表中是否存在soap
• 如果没有soap，执行php --ini查看CLI模式实际加载的php.ini文件路径，修改对应文件，取消extension=soap前的注释符号
• 额外检查：确保PHP根目录下存在libxml2.dll依赖文件，且PHP根目录已加入系统环境变量PATH，否则php_soap.dll会加载失败

步骤2：临时跳过Composer平台检查 #

如果确认soap扩展已正确加载，但Composer仍报错，可以通过参数跳过平台扩展校验完成安装：

• 执行安装命令：composer install --ignore-platform-req=ext-soap
• 如果仍有问题，可以执行全量忽略命令：composer install --ignore-platform-reqs

注意：该方案仅为本地开发临时绕过方案，生产环境部署前请确保所有依赖扩展正常安装，避免运行时报错。

步骤3：替换不需要的依赖包（可选） #

如果你项目中不需要使用craftcms/commerce的vat相关功能，可以通过composer配置强制替换依赖：

• 编辑项目根目录的composer.json文件，新增replace配置项：

{
    "replace": {
        "ibericode/vat": "*"
    }
}

• 保存后重新执行composer install即可

步骤4：升级Composer版本（可选） #

旧版Composer存在平台检测异常的已知问题，可以将Composer升级到最新版本后重试：

• 执行升级命令：composer self-update

内容的提问来源于stack exchange，提问作者borisM