Composer报“PHP版本不满足约束”的本质是CLI的php -v版本与composer.json中require.php声明不匹配；需先核对二者版本，再检查config.platform.php是否被硬编码干扰，最后按场景选择升级PHP、降级依赖或谨慎使用--ignore-platform-req=php。
Composer 报“PHP 版本不满足约束”，本质是它在解析依赖时发现：你当前 CLI 下运行的 PHP 版本（php -v 输出）和 composer.json 中 require.php 字段声明的版本要求 对不上。这不是 Composer 坏了，也不是网络问题，而是环境与项目需求不匹配的明确提醒。
确认真实 PHP 版本和项目要求
别跳步骤，先做这两件事：
- 在终端运行 php -v，记下输出的完整版本号（例如 PHP 7.4.33 或 PHP 8.2.10）——Composer 只看这个，Web 服务器用的 PHP 完全无关；
- 打开项目根目录下的 composer.json，找到
"require": { "php": "..." }这一行，比如"php": "^8.1"或"php": ">=8.2.0"； - 对比两者：若本地是 7.4 而要求 ^8.1，或本地是 8.0 而要求 ^8.2，就直接命中问题。
检查 Composer “认为”的平台版本
Composer 不一定按你预期读取 PHP 版本，它可能被配置干扰：
- 运行 composer show --platform，查看它当前“认定”的 PHP 版本；
- 如果输出和 php -v 不一致，大概率是因为 composer.json 中 config.platform.php 被硬编码了（例如
"platform": { "php": "7.4.33" }）； - 删掉或修正这个配置，让它回归真实环境；否则即使你升级了 PHP，Composer 仍会按旧值校验。
选择合适解法，避免埋雷
根据你的实际场景选一条路走，别乱用 --ignore-platform-req=php：
立即学习“PHP免费学习笔记（深入）”；
-
开发环境能升级 PHP：优先切换 CLI 默认版本（macOS 用
brew link php@8.2，Ubuntu 用update-alternatives --config php），再验证 php -v 和 composer show --platform 一致； -
必须用低版本 PHP（如 7.4）且不能升级：不要伪造 platform，而是回退到兼容该版本的包大版本，例如 Laravel 9（支持 PHP 8.0+）或 Symfony 5.4（支持 PHP 7.2+），通过
composer create-project laravel/laravel myapp "9.*"显式指定； -
临时验证逻辑或跑 demo：可用
composer install --ignore-platform-req=php，但务必清楚——这不会让 PHP 7.4 解析enum或match，运行时仍会报错； - CI/CD 或生产部署：严禁忽略检查，必须确保系统 PHP 版本、config.platform.php（如有）、require.php 三者严格对齐。
验证与收尾动作
改完之后，别直接 composer install：
- 先运行 composer install --dry-run，看是否还报相同错误；
- 若用
config.platform.php修改了目标版本，必须紧接着执行 composer update --lock，否则 lock 文件仍保留旧版本组合； - 如果之前装过但失败，
vendor/和composer.lock可能残留冲突状态，可删vendor/和composer.lock后重试（仅当确认配置已修正）。
