答案：config.platform.php用于伪装PHP版本以确保依赖兼容目标环境，require.php声明项目所需PHP版本；前者影响依赖解析时的环境判断，后者定义实际运行时的版本要求。结合使用可避免“本地正常、线上报错”问题，推荐在composer.json中固定platform.php并合理设置require.php以保障环境一致性。
在使用 Composer 管理 PHP 项目依赖时，经常会遇到需要模拟不同 PHP 环境的场景。比如开发环境是 PHP 8.2，但生产环境是 PHP 8.0，这时候如何确保安装的依赖兼容目标环境？config.platform 和 require.php 都能影响 PHP 版本的判断，但它们的作用机制完全不同。
1. config.platform.php：伪装当前平台版本
这个配置的作用是告诉 Composer：即使我本地运行的是高版本 PHP，也假装我在一个指定版本下运行。它不会添加依赖约束，只是改变 Composer 分析依赖时所“看到”的 PHP 版本。
例如：
{ "config": { "platform": { "php": "8.0.0" } } }设置了这个之后，即使你在 PHP 8.2 下执行 composer install，Composer 也会只安装那些声明支持 PHP 8.0 的包。这在团队开发或 CI/CD 中非常有用——确保所有人安装的依赖都基于统一的“目标”环境。
立即学习“PHP免费学习笔记（深入）”；
你可以用命令全局或项目级设置：
-
composer config platform.php 8.0.0（项目级） - 这个值会覆盖实际 PHP 版本，用于依赖解析
2. require.php：声明项目对 PHP 的硬性依赖
这是典型的依赖声明，就像你 require monolog/monolog 一样，require.php 是你项目对 PHP 核心版本的显式要求。
例如：
{ "require": { "php": "^8.0.0" } }它表示：任何安装这个项目的环境，PHP 版本必须满足 ^8.0.0。如果当前 PHP 是 7.4，Composer 就会报错，拒绝安装或更新。
这个字段会被其他包用来判断是否兼容你的项目。比如某个包 require 的 PHP 是 ^8.1，而你的 require.php 是 ^8.0，那这个包仍可能被安装；但如果它的 PHP 要求是 ^8.3，就会冲突。
3. 两者结合使用的典型场景
假设你的生产环境是 PHP 8.0，但你本地是 PHP 8.2：
- 用 require.php: "^8.0" 明确声明项目需要 PHP 8.0+
- 用 config.platform.php: "8.0.0" 强制 Composer 安装与 PHP 8.0 兼容的依赖版本（比如避免安装仅支持 8.1+ 的扩展包）
这样既能保证依赖正确，也能防止意外引入高版本特性导致线上报错。
4. 常见误区与建议
- 不要只设 require.php 而忽略 platform：虽然声明了 PHP 要求，但如果你本地是高版本，Composer 可能仍会选一个为高版本优化的依赖版本（如 ext-soap:^3.0），结果在线上低版本无法加载。
- platform 设置不会阻止你运行代码：它只是影响依赖选择，不验证实际环境。
- 推荐在
composer.json中固定 platform.php，尤其在部署流程中。
基本上就这些。合理使用这两个配置，能有效避免“本地正常、线上报错”的经典问题。关键是：require.php 是“我说我需要什么”，platform.php 是“我假装我有什么”。
