Composer 不切换 PHP 版本，仅依据当前 PHP 解释器版本解析依赖；require.php 声明项目运行所需最低 PHP 版本（如 "^8.1"），用于安装时校验并报错，不控制运行时；config.platform.php 可模拟目标环境，二者需配合使用，避免部署失败。
Composer 本身不切换 PHP 版本，它只读取当前运行它的 PHP 解释器版本，并据此解析依赖。所谓“设置 PHP 版本”，本质是控制依赖安装时的兼容性判断逻辑——要么让 Composer 用你本地的 PHP 版本去校验（require.php），要么让它假装在另一个版本下工作（config.platform.php）。两者必须配合使用，漏掉任一环节都可能在部署时 runtime 报错或装错包。
composer.json 里 require.php 是启动闸门
这个字段声明项目代码实际运行所需的最低 PHP 版本，不是给 Composer 自己用的，而是告诉 Composer：“如果当前 PHP 版本不满足，就别往下走了”。
-
require.php值必须是语义化约束，比如"^8.1"或">=8.1.0"；写成"8.1"会被当作精确匹配，PHP 8.1.10 就不被接受 - 它只在校验阶段起作用：执行
composer install或composer update时触发，不满足会直接报错Your PHP version (7.4.33) does not satisfy that requirement - 它不影响运行时——哪怕你用 PHP 7.4 手动执行
vendor/autoload.php，也不会自动拦截 - 常见误配：
"php": "^7.4 || ^8.1"是无效写法，Composer 不支持||逻辑或，应改用交集式约束如">=7.4.0
config.platform.php 是依赖过滤器
这是解决“我在 PHP 8.2 上开发，但线上跑的是 PHP 8.1”这类问题的核心配置。它让 Composer 在解析依赖时忽略真实 PHP 版本，转而以你指定的版本为基准做兼容性判断。
- 必须写在
composer.json的config对象下，路径是config.platform.php，键名不能拼错（不是platform-php或php-platform） - 值必须是完整小版本号，例如
"8.1.10"；写"^8.1"或"8.1"会被忽略 - 修改后必须删掉
composer.lock和vendor/，再执行composer update --lock，否则旧锁文件仍按原平台解析 - 它也影响扩展检查，比如
"ext-mbstring": "*"，但不会帮你装扩展或验证是否启用——运行时报Call to undefined function mb_strlen()仍是你的事
命令行临时覆盖比改配置更安全
CI/CD 或快速验证时，优先用参数而非硬编码到 composer.json，避免污染项目配置。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
立即学习“PHP免费学习笔记（深入）”；
-
composer install --platform=php:8.1.10（Composer 2.2+）：等效于临时设置config.platform.php，不写入文件，每次都要带 -
composer install --ignore-platform-req=php：跳过所有 PHP 版本校验，危险，仅限调试，切勿进 CI 脚本 - 最稳的方式是显式调用目标 PHP：
/usr/bin/php8.1 /usr/local/bin/composer install，路径务必绝对，避免软链失效 - 验证当前 Composer 实际用的 PHP：
composer --version第一行会显示 PHP 路径；也可用composer exec 'echo PHP_VERSION;'
为什么改了配置还是装错包？先查这三处
配了 config.platform.php 却没生效，90% 是卡在这几个地方：
- 没删
composer.lock—— 它记录的是上次解析时的平台版本，不重生成就永远沿用旧逻辑 -
composer show php输出的不是你预期的版本？说明config.platform.php没写对位置或格式错误 - 本地有多个 PHP 共存，但
composer --version和php -v显示的路径不一致，说明 Composer 没走你设的环境变量 - CI 中用了
COMPOSER_IGNORE_PLATFORM_REQS=1环境变量，它会彻底关闭所有平台校验，包括config.platform
真正关键的不是“怎么写配置”，而是理解 require.php 和 config.platform.php 分别在哪一环起作用：一个拦安装，一个筛依赖。运行时是否真能跑，还得靠你手动在目标环境中验证扩展、INI 配置和函数可用性——Composer 从不替你做这件事。
