在composer.json中通过require指定PHP版本(如"php": "^8.1 || ^8.2")声明项目运行的最低要求,确保依赖兼容;使用config.platform可模拟特定PHP环境(如"platform": {"php": "8.1.0"}),用于CI/CD中保持依赖一致,避免“本地能跑线上报错”。

使用 require 配置 php 版本约束
最常用且推荐的方式是在 composer.json 的 require 字段中直接声明 PHP 版本:
{
"require": {
"php": "^8.1 || ^8.2"
}
}
这表示项目需要 PHP 8.1 或更高版本(但低于 9.0),支持 8.1 和 8.2 的特性。你也可以写得更具体:
-
"php": ">=8.1":PHP 8.1 及以上版本 -
"php": "~8.1.0":8.1.0 到 8.1.99 之间 -
"php": "8.1.*":任何 8.1.x 版本
这样,当你运行 composer install 时,Composer 会检查当前环境的 PHP 版本是否符合要求,不符合则报错。
使用 config.platform 强制平台版本
如果你希望在不同开发或部署环境中模拟特定的 PHP 版本(比如生产环境是 PHP 8.1,而你在本地用的是 8.3),可以使用 config.platform 来“锁定”平台版本:
立即学习“PHP免费学习笔记(深入)”;
{
"config": {
"platform": {
"php": "8.1.0"
}
}
}
这样 Composer 会假装系统运行的是 PHP 8.1.0,从而安装与该版本兼容的依赖,即使你本地是更新的 PHP 版本也不会装需要新版才支持的包。
注意:platform 设置会覆盖实际的 PHP 版本检测,适合用于构建或 CI/CD 环境中保持依赖一致性。
两者区别与使用建议
require.php 是声明项目的硬性依赖,属于项目运行的基本要求;config.platform 是配置 Composer 行为的工具,影响依赖解析时的环境判断。
- 始终在
require中定义最低 PHP 版本,这是保障项目可运行的关键 - 仅在需要统一依赖选择逻辑时使用
platform,如 Docker 构建、CI 脚本等 - 不要滥用
platform,否则可能掩盖真实环境问题











