Composer迁移PHP新版本需三步：先升级Composer至v2.2+（v2.5.0+支持PHP8.3），再调整composer.json中php平台约束（如"php": "^8.2"），最后用composer why-not php:8.2定位并替换不兼容依赖，完成后再删vendor与lock重装验证。
Composer 本身不绑定特定 PHP 版本，但项目能否在新 PHP 版本下正常 composer install 或 composer update，取决于 composer.json 中的 php 平台配置、依赖包的 PHP 兼容性声明，以及 Composer 自身版本是否支持目标 PHP 版本。
检查当前 Composer 版本是否支持目标 PHP 版本
旧版 Composer（如 v1.x）在 PHP 8.2+ 上会报错或无法运行；Composer v2.2+ 才完整支持 PHP 8.2/8.3。执行以下命令确认：
composer --version
若输出类似 Composer version 1.10.22，必须升级：
- 全局升级：
composer self-update（需确保本地 Composer 是通过官方安装脚本安装的） - 若使用 Homebrew（macOS）：
brew upgrade composer - 若用 Scoop（Windows）：
scoop update composer - PHP 8.3 用户注意：Composer v2.5.0+ 是首个正式支持 PHP 8.3 的稳定版，低于此版本可能跳过部分兼容性检查
验证 composer.json 中的 php 平台约束
composer.json 的 config.platform.php 或 require.php 字段会强制 Composer 模拟指定 PHP 版本解析依赖——如果它锁死在旧版本（如 "php": "^7.4"），即使你已切到 PHP 8.2，composer update 仍会拒绝安装 PHP 8+ 只能用的包（例如 laravel/framework ^10.0 要求 php >=8.1）。
立即学习“PHP免费学习笔记（深入）”；
检查并按需调整：
- 查看当前约束：
grep -A2 '"php"' composer.json - 若要适配 PHP 8.2，可设为：
"php": "^8.2"（宽松）或"php": "8.2.*"（严格） - 仅在 CI/部署等需要锁定平台行为时才用
config.platform.php；开发迁移阶段建议直接修改require.php - 改完后务必运行
composer update --dry-run验证是否还有冲突
识别并处理不兼容的依赖包
执行 composer update 时若报错如 Your requirements could not be resolved to an installable set of packages，大概率是某个依赖（或其子依赖）未声明支持新 PHP 版本。
快速定位方法：
- 运行：
composer why-not php:8.2（将8.2替换为目标版本），它会列出所有阻止升级的包及其原因 - 常见“钉子户”：老旧的
phpunit/phpunit（^9.5支持 PHP 8.2，但^8.5不支持）、doctrine/orm（v2.x 不支持 PHP 8.1+，需升 v3.x） - 对明确不维护的包，考虑用
composer require --dev phpstan/phpstan:^1.10等现代替代品，而非硬扛 - 慎用
--ignore-platform-req=php：它绕过检查，但运行时可能因语法/废弃函数崩溃（如 PHP 8.2 移除了create_function()）
实际迁移后的最小验证步骤
完成 composer install 后，不能只看“成功”，要验证运行时行为：
- 执行
php -d display_errors=1 -d error_reporting=-1 vendor/autoload.php—— 若报Fatal error: Cannot declare class或Deprecated:，说明某自动加载文件用了被移除的语法 - 运行
vendor/bin/phpunit（或你项目的测试命令），观察是否有ParseError或TypeError - 检查日志中是否出现
PHP Deprecated: Function xyz is deprecated（PHP 8.1+ 开始大量标记废弃） - 若项目含自定义
composer-plugin，确认其composer.json的require.composer-plugin-api是否匹配当前 Composer 版本（如 v2 插件不兼容 v1）
最易被忽略的是：某些包在 composer.lock 中记录了旧版 hash，但实际代码已随 PHP 版本切换悄悄失效——必须删掉 vendor/ 和 composer.lock，重新 composer install 才算真正迁移完成。
