直接升级PHP-CLI需先确认which php和php -v指向目标版本，Ubuntu用apt安装phpX.X-cli后update-alternatives切换，macOS用brew install php@X.X并调整PATH；切完验证php -m关键扩展，并重装Composer以避免语法错误。
直接升级 PHP-CLI，不是 Composer 本身，也不是改 composer.json 就能绕过去的。
确认到底是哪个 PHP 在跑 Composer
Composer 启动时只看 php 命令指向的 CLI 版本，和 Web 用的 PHP（如 FPM）完全无关。常见错误是：Web 页面显示 PHP 8.2，但终端里 php -v 还是 7.4 —— 那 Composer 一定报错。
- 运行
php -v和which php，看输出是否匹配你预期的版本 - 运行
composer diagnose，重点关注 “PHP version” 行，它显示 Composer 实际调用的版本 - 如果
which php指向/usr/bin/php（系统旧版），而新 PHP 安装在/opt/homebrew/bin/php或/usr/bin/php8.2，就必须切换
Linux/macOS 下切换默认 PHP-CLI 的实操要点
别手动 ln -sf，容易漏掉扩展或破坏包管理器维护。用系统级工具接管更稳：
- Ubuntu/Debian：
sudo apt install php8.2-cli php8.2-mbstring php8.2-xml php8.2-zip php8.2-curl，再sudo update-alternatives --config php选 8.2 - macOS Homebrew：
brew install php@8.2，然后把/opt/homebrew/bin（Apple Silicon）或/usr/local/bin（Intel）加到$PATH最前面，再source ~/.zshrc - 切完立刻验证：
php -m | grep -E "(mbstring|xml|curl)"，缺任一模块，Composer 都可能在 SSL 或 autoload 阶段失败
升级 PHP 后必须重装 Composer
PHP 8.2+ 的语法变更会让旧版 Composer 直接崩溃，比如报 Required parameter $xxx follows optional parameter $yyy。这不是警告，是致命错误。
立即学习“PHP免费学习笔记（深入）”；
- 删旧二进制：
rm /usr/local/bin/composer（Linux/macOS）或del %PROGRAMDATA%\ComposerSetup\bin\composer.phar（Windows） - 用当前新 PHP 下载安装：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"，再php composer-setup.php --install-dir=/usr/local/bin --filename=composer - 验证：
composer --version输出应带 “2.5+”，且composer --help不报 ParseError
为什么 --ignore-platform-req=php 不是解法
它只跳过依赖解析，不解决运行时问题。PHP 7.4 执行含 match、enum、联合类型或构造器属性提升的代码，必然 Fatal error: Uncaught Error 或 ParseError。
-
--ignore-platform-req=php适合临时调试，不能进 CI/CD，也不能提交到团队仓库 -
config.platform.php是更隐蔽的坑：它连require-dev工具链（如 PHPUnit、PHPStan）也一起骗，结果测试跑不通、静态分析失效 - 真正兼容的路径只有一条：查 Packagist 上目标包各版本的
requires php字段，锁死一个你 PHP 能跑的版本，比如"laravel/framework": "^8.75"
最常被忽略的一点：Docker、CI runner、IDE 内置终端，各自有独立的 PATH 和 shell 缓存。在一个地方修好了，不代表其他地方也生效。每次换 PHP 版本后，都要在对应环境里单独验证 php -v 和 composer diagnose。
