Composer 仅依据 composer.json 中 "php" 字段的显式约束校验版本，不自动推断；写错、漏写或与实际 CLI 环境（php -v）脱节，将导致 install 中断或运行时 ParseError。
Composer 不会自动推断你项目该跑在哪个 PHP 版本上，它只认 composer.json 里白纸黑字写的约束；写错、漏写、或和实际运行环境脱节，vendor/autoload.php 就会在第一次 require 时直接报 ParseError 或 Fatal error。
require.php 是唯一生效的运行时门槛
这个字段不是建议，是安装闸门。Composer 在执行 composer install 或 composer update 时，会拿它和当前 CLI 的 php -v 输出硬比对，不满足就中断，不生成 vendor/。
-
"php": "^8.1"等价于">=8.1.0 ，但无法表达“支持 8.1 和 8.2，但不支持 8.3”这种交集逻辑 -
"php": ">=8.1.0, !=8.2.5"才能排除已知有严重 bug 的次版本（比如某个ext-opcache崩溃问题） - 别写
"php": "8.1"——这是精确匹配，php -v输出8.1.10就会被拒绝 - 写
"php": "^7.4 || ^8.1"是无效的，Composer 解析器不支持||，会静默忽略整个约束
config.platform.php 是构建期“伪装”，不是运行时补丁
它只影响依赖解析过程，不改变任何代码能否执行的事实。你在 PHP 7.4 上设 "platform": {"php": "8.2.0"}，composer update 可能成功，但只要代码里出现 match 或 readonly，运行时立刻崩。
- 必须写完整小版本号，如
"8.2.10"；写"^8.2"或"8.2"会被 Composer 忽略 - 修改后必须删掉
composer.lock并执行composer update --lock，否则旧锁文件仍按原平台解析 - CI 构建部署包时才适用：本地是 PHP 8.3，但目标服务器是 8.1，靠它提前筛出兼容包
- 切勿提交到团队仓库——队友用 PHP 8.1 装完 vendor，一跑
new DateTime('now', new DateTimeZone('UTC'))就可能因ext-intl版本错配而挂
为什么 vendor/autoload.php 还是报错？查这三处
即使 composer install 成功、composer show -p | grep php 显示版本正确，运行时仍出错，大概率是以下某处没对齐：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
立即学习“PHP免费学习笔记（深入）”；
- 某个已安装的依赖包自身用了高版本语法，比如
monolog/monologv3.x 要求 PHP 8.1+，但你的composer.json没锁死"monolog/monolog": "2.9.0" -
composer.lock里记录的包版本，是在旧 PHP 环境下解析的，没经过新版本重校验；PHP 升级后应执行composer update --with-all-dependencies，而非仅composer update - 扩展缺失：比如
ext-gd或ext-xml没启用，composer install可能成功（因未显式声明ext-gd），但运行时调用imagecreatefrompng()就报Call to undefined function
CI/CD 中真正卡住 PHP 版本的姿势
光靠 composer.json 不够，CI 脚本必须主动验证。GitHub Actions、GitLab CI 都支持指定 PHP 运行时，但更可靠的是让构建流程自己失败：
- 加一行
php -v | head -n1 | grep -q "8\.1\." || (echo "PHP version mismatch"; exit 1)，确保 CLI 环境真实匹配 - 用
composer install --platform=php:8.1.10（Composer 2.2+）替代硬编码config.platform，避免污染项目配置 - 禁用
--ignore-platform-reqs—— 它跳过所有检查，装出来的vendor/很可能在生产机上根本起不来 - 静态分析工具如
phpstan应配<phpversion></phpversion>，和 Composer 约束形成双重防线
最常被忽略的一点：Composer 的 require.php 约束只管“能不能装”，不管“装完能不能跑”。哪怕所有配置都对，只要某行代码用了 str_contains() 而你还在 PHP 7.4 上执行，错误就在所难免。
