启用 platform-check 后，composer 会在 install 前严格校验本地 php 版本及扩展是否满足 require 中的约束，不匹配则报错退出；需确保未配置 config.platform 且使用 install --platform-check 或已设 "config": {"platform-check": true}。
composer install 时跳过 platform-check 怎么办
默认情况下，composer install 不强制校验当前 PHP 环境是否匹配 composer.json 中声明的 platform（比如 "php": "8.2"），除非你显式启用了 platform-check。它不是默认开启的，所以很多人误以为“没生效”，其实是根本没开。
要让 Composer 在安装依赖前严格比对本地 PHP 版本、扩展是否满足 platform 要求，必须手动启用：
- 在项目根目录的
composer.json中添加：{"config": {"platform-check": true}} - 或全局启用（不推荐）：
composer config -g platform-check true - 临时启用（仅本次命令）：
composer install --platform-check
platform-check true 和 require php 版本冲突时会发生什么
当 platform-check 为 true，且 composer.json 的 require 区域写了 "php": ">=8.3"，但你本地是 PHP 8.2，Composer 会直接报错退出，而不是降级适配或忽略：
错误信息类似：Your platform does not satisfy the required version constraint for php (>=8.3)
- 这个检查发生在依赖解析前，所以不会下载任何包就中断
- 它只校验
require中的php和扩展（如ext-gd），不校验require-dev里的 platform 项 - 如果项目同时用了
config.platform.php（用于模拟环境），platform-check会优先以config.platform为准，而非真实 PHP 版本——这点容易被忽略
为什么设置了 platform-check true 却没报错
常见原因不是配置失效，而是条件未触发：
-
config.platform被显式设置（如"platform": {"php": "8.1.0"}），此时 Composer 会用这个“虚拟平台”做校验，而不是你本地的 PHP —— 它可能刚好吻合 - 你运行的是
composer update，而platform-check默认只对install生效；update需额外加--platform-check -
composer.json里压根没写require.php或扩展约束，那即使开了platform-check也无东西可校 - 某些旧版 Composer（platform-check，会静默忽略该配置
platform-check 对 CI/CD 和多环境部署的实际影响
它本质是把“运行时兼容性问题”提前到安装阶段暴露，但要注意副作用：
- CI 流水线中若用 Docker 构建镜像，必须确保构建环境的 PHP 版本和
config.platform.php一致，否则install直接失败 - 本地开发用 Valet/MAMP/XAMPP 等多版本共存工具时，
platform-check可能因 CLI PHP 和 Web PHP 版本不一致导致误报 - 它不解决扩展缺失的运行时错误（比如
ext-redis已声明但未启用），只检查是否已加载 —— 所以仍需配合php -m | grep redis手动确认
真正难处理的是 config.platform 和真实环境长期脱节：有人为了绕过报错，在 platform 里硬写了个低版本，结果上线后 runtime crash。这种“配置即谎言”的情况，比没开 platform-check 更危险。
