在使用 Composer 时，可以通过 platform 配置来指定项目所运行环境的 PHP 版本，从而让依赖解析基于你设定的版本，而不是当前开发机器上的 PHP 版本。这在开发环境与生产环境 PHP 版本不一致时特别有用，能有效避免“本地可以运行，上线报错”的问题。

什么是 platform 配置？

Composer 的 config.platform 允许你“欺骗” Composer，让它认为当前系统运行的是某个特定版本的 PHP 或扩展。这样，在执行 composer install 或 composer update 时，它会根据你设定的平台环境选择兼容的依赖包版本。

如何设置 platform PHP 版本

在项目的 composer.json 文件中添加或修改 config 字段：

"config": {
    "platform": {
        "php": "8.1.0"
    }
}

例如，即使你在本地使用的是 PHP 8.3，但生产环境是 PHP 8.1，设置上述配置后，Composer 就会只安装支持 PHP 8.1 及以上、但在 8.1 环境下能正常工作的包版本。

实际应用场景

• 团队成员使用新版 PHP 开发，但服务器部署环境较旧
• CI/CD 流水线中需要确保依赖与目标环境一致
• 防止意外引入仅支持更高 PHP 版本的包

假设你未设置 platform，而某包的最新版要求 PHP 8.2+，Composer 可能会安装它。一旦部署到 PHP 8.1 的服务器，应用就会崩溃。通过锁定 platform PHP 版本，可提前发现此类问题。

AI高保真原型设计工具

查看当前 platform 设置

运行以下命令查看当前生效的 platform 配置：

composer config --list | grep platform

也可以查看完整解析后的平台信息：

composer show -p php

注意事项

• platform 设置不会改变实际运行的 PHP 版本，仅影响依赖解析
• 建议将该配置提交到版本控制，确保团队统一
• 除了 PHP，还可模拟扩展，如："ext-curl": "7.4.0"
• 若要临时忽略 platform，可用 --ignore-platform-reqs，但不推荐用于生产构建

基本上就这些。合理使用 platform 配置，能显著提升部署稳定性，避免因环境差异导致的依赖问题。