platform 配置可指定项目运行环境的 PHP 版本，1. 用于确保依赖解析基于设定版本而非本地版本；2. 在 composer.json 中设置 "config": { "platform": { "php": "8.1.0" } } 可避免生产环境因 PHP 版本低导致的兼容问题；3. 适用于开发与生产环境不一致、CI/CD 构建等场景；4. 可通过 composer config --list 查看配置；5. 建议提交至版本控制并避免使用 --ignore-platform-reqs。
在使用 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免费学习笔记（深入）”；
实际应用场景
- 团队成员使用新版 PHP 开发，但服务器部署环境较旧
- CI/CD 流水线中需要确保依赖与目标环境一致
- 防止意外引入仅支持更高 PHP 版本的包
假设你未设置 platform，而某包的最新版要求 PHP 8.2+，Composer 可能会安装它。一旦部署到 PHP 8.1 的服务器，应用就会崩溃。通过锁定 platform PHP 版本，可提前发现此类问题。
查看当前 platform 设置
运行以下命令查看当前生效的 platform 配置：
composer config --list | grep platform
也可以查看完整解析后的平台信息：
composer show -p php
注意事项
- platform 设置不会改变实际运行的 PHP 版本，仅影响依赖解析
- 建议将该配置提交到版本控制，确保团队统一
- 除了 PHP，还可模拟扩展，如：
"ext-curl": "7.4.0" - 若要临时忽略 platform，可用
--ignore-platform-reqs，但不推荐用于生产构建
基本上就这些。合理使用 platform 配置，能显著提升部署稳定性，避免因环境差异导致的依赖问题。
