应优先切换本地php cli版本至8.1+（如macos用brew link php@8.2，ubuntu用update-alternatives），而非加--ignore-platform-req=php；该参数仅跳过php版本校验，不解决运行时语法错误，且不改变composer.lock中的平台约束。
composer install 报 “requires php ^8.1” 但本地是 PHP 7.4 怎么办
这不是 Composer 故意卡你，而是它在严格执行 composer.json 里声明的 PHP 最低版本底线。报错行通常长这样：Your requirements could not be resolved，接着带一句 Root composer.json requires php ^8.1 but your php version (7.4.33) does not satisfy that requirement。
实操建议：
- 先确认终端当前 PHP CLI 版本：
php -v——注意不是 Web 服务器用的 PHP，是命令行执行时实际调用的那个 - 检查
composer.json顶层require段里的"php": "^8.1"字段，这是源头约束 - 不要直接删
composer.lock或硬改composer.json降成"^7.4"：Laravel 10、Symfony 6、monolog 3 等包已彻底放弃 7.x，降了也会在运行时报ParseError: unexpected token "enum" - 优先切换本地 CLI 的 PHP 版本（macOS 用
brew link php@8.2，Ubuntu 用update-alternatives --config php），比加参数更可靠
临时绕过 PHP 版本检查但不破坏扩展校验
--ignore-platform-reqs 是“全关”，会跳过 ext-mbstring、ext-xml 等所有平台依赖，极易导致后续运行时报错；而 --ignore-platform-req=php 只跳 PHP 版本，其他扩展仍被校验，安全边界更清晰。
适用场景：
- 临时调试老项目在新环境能否跑通（比如拉 Laravel 6 项目到 PHP 8.2）
- CI 流水线中已明确控制 PHP 运行时版本，仅需跳过 lock 文件里残留的旧约束
- 执行
composer create-project laravel/laravel myapp --ignore-platform-req=php解决初始化卡住
注意：--ignore-platform-req=php 不会修改 composer.lock 中记录的 PHP 兼容性元信息，下次别人拉代码仍按原规则校验。
为什么加了 --ignore-platform-req=php 还是报错？
常见于两种情况：一是锁文件里某个包（比如 symfony/console）在 require 中写了 "ext-posix": "*"，而 Windows 没这个扩展；二是 config.platform 被错误写进 composer.json，且值与实际环境不符（如写 "php": "8.2.10" 却在 8.1 下运行）。
排查步骤：
- 运行
composer diagnose，它会直接标出缺失的扩展（如ext-posix missing） - 查谁引入了 POSIX：
composer show --tree | grep posix，再决定移到require-dev或加--ignore-platform-req=ext-posix -
config.platform只影响composer update，对install无效——别指望它能“骗过” install 阶段
CI/CD 里 composer install 失败最常漏掉的一件事
不是镜像慢、不是 token 过期，而是 composer.lock 根本不是用目标平台生成的。比如开发机是 macOS + PHP 8.2，lock 文件里锁了 ext-pcntl，但 CI 用的是 Alpine Linux 容器，压根没这个扩展。
安全写法只有一条：
- CI 脚本开头确保
composer install --no-dev --optimize-autoloader - 绝不能出现
--ignore-platform-reqs或--force - 上线前必须确认
composer.lock是在和生产环境一致的 PHP 版本 + 扩展集下生成的（例如用docker run --rm -v $(pwd):/app -w /app composer:2.5 install）
真正难处理的从来不是报错本身，而是 lock 文件背后隐含的平台假设——它不声不响，直到部署那一刻才炸开。
