唯一有效方式是将"php": "^8.1"等合法格式写入composer.json的require块内，其他位置或写法均无法在composer install时硬性拦截低版本PHP，删锁文件后重装可验证是否生效。
composer install 时怎么卡住低版本 PHP 环境
唯一有效方式是把 php 字段写进 composer.json 的 require 段，例如 "php": "^8.1"。其他任何位置（config、require-dev、命令行参数）都不能阻止低版本 PHP 下的 composer install 执行成功——它只会让你在上线后遇到 Fatal error: Uncaught ParseError。
常见错误现象：
- PHP 8.0 机器上运行
composer install成功，但项目一启动就报语法错误（比如用了match表达式） -
composer.json里写了"php": "8.1"或"php": "8.1.*"，但校验完全没触发 - 删了
composer.lock后重装仍不报错，说明require.php根本没被识别
合法写法只有这些：
-
"php": "^8.1"（推荐，语义明确，兼容 8.1.0–8.999.999） -
"php": ">=8.1.0"（更稳妥，避免 minor 版本策略变动干扰） -
"php": "~8.1.0"（限定在 8.1.x 小版本内）
以下写法会被忽略或解析失败：
立即学习“PHP免费学习笔记（深入）”；
-
"php": "8.1"→ 被当作精确匹配，PHP 8.1.10 不满足 -
"php": "8.1.*"→ 语法非法，Composer 直接跳过校验 -
"php": "^8.1.0"→ Composer 不支持补零写法，解析失败
为什么 --platform=php:x.x 不能替代 require.php
--platform=php:8.1 只影响依赖解析逻辑，不构成运行门槛。它告诉 Composer “假装我跑在 PHP 8.1”，但不会阻止你在 PHP 7.4 上执行 composer install，也不会让项目代码突然兼容更低版本。
典型误用场景：
- CI 流水线只配了
"config": {"platform": {"php": "8.1.10"}}，没写require.php→ 构建通过，上线报错 - 本地 PHP 8.3，设
--platform=php:8.0安装，结果包里含str_contains()→ PHP 8.0 运行时报Function not found - 以为
--platform能绕过本地版本限制，实际它连校验都不触发
这个参数真正适合的场景是：
- CI 中临时覆盖平台版本，配合
--no-interaction确保构建一致性 - 验证某个旧版 PHP 下能否解析出可用依赖（用
composer update --dry-run） - 为跨环境部署生成适配的
composer.lock，但必须搭配require.php使用
composer create-project 怎么提前卡 PHP 版本
如果目标项目的 composer.json 没声明 require.php，你又想在拉取时就强制拦截低版本环境，不能靠全局配置，得用 --platform 参数临时注入解析约束。
正确命令示例：
composer create-project myorg/myapp ./myapp --no-interaction --platform=php:8.2
注意两点：
- 它只影响本次安装的依赖选择逻辑，不会自动写入新项目的
composer.json - 后续必须手动补上
"require": {"php": "^8.2"}，否则下一次composer update可能又拉错包
错误做法：
-
COMPOSER_PLATFORM_CHECK=0 composer create-project→ 关掉检查，不是设置版本 - 只加
--ignore-platform-req=php→ 跳过所有 PHP 校验，极度危险
锁文件残留导致版本校验失效
如果项目已有 composer.lock，且它是在高版本 PHP 下生成的，composer install 会直接按锁文件还原依赖，跳过 require.php 的 PHP 版本检查。
这意味着：
- PHP 8.0 机器上执行
composer install仍会成功，哪怕composer.json写了"php": "^8.1" - 真正校验只发生在
composer update或首次生成锁文件时
验证是否生效的实操步骤：
- 删掉
composer.lock和vendor/ - 在目标低版本 PHP 下运行
composer install --no-interaction - 应看到错误：
The requested PHP version is >=8.1.0, but your system has 8.0.30. - 若没报错，说明
require.php位置错、语法错，或被注释掉了
最易被忽略的一点：require.php 是硬性契约，但它的效力完全依赖锁文件是否重新生成。很多团队只改了 composer.json 却忘了清锁文件，导致约束形同虚设。
