必须升级PHP-CLI版本，因Composer仅依赖shell中php命令指向的CLI解释器，与Web用PHP无关；需执行php -v和which php确认版本与路径一致，再用系统工具切换（如Ubuntu用update-alternatives、macOS用brew install php@8.2并调整PATH），随后重装Composer及vendor目录。
必须升级 PHP-CLI 版本，不是 Composer 本身的问题，也不是改 composer.json 就能绕过去。 Composer 启动时只认 php 命令指向的 CLI 解释器，和 Web 用的 PHP（如 FPM）完全无关。常见错误是：浏览器里 phpinfo() 显示 PHP 8.2，但终端里 php -v 还是 7.4 —— 那 composer install 一定失败。
怎么确认 Composer 实际在用哪个 PHP 版本
跳过这步就操作等于白干。执行以下两条命令，缺一不可：
-
php -v：看输出版本号是否匹配项目要求（比如^8.2） -
which php：看路径是否指向你预期的安装位置（如/usr/bin/php8.2，而不是模糊的/usr/bin/php）
如果两者不一致，说明 shell 没生效或被缓存了。Linux/macOS 可试 hash -r；Windows 用户建议新开 CMD/PowerShell。别信 composer config platform.php 的输出——它只影响依赖解析，不改变运行时解释器。
Linux/macOS 下切换默认 PHP-CLI 的实操要点
别手动 ln -sf，容易漏扩展或破坏包管理器维护。用系统级工具接管更稳：
立即学习“PHP免费学习笔记（深入）”；
- 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 阶段失败。
为什么重装 Composer 是硬性要求
PHP 8.2+ 的语法变更会让旧版 Composer 直接崩溃，比如报 Required parameter $xxx follows optional parameter $yyy。这不是警告，是致命错误。
- 删旧二进制：
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
vendor 目录也必须重装：切换 PHP 版本后，autoload_static.php 等文件生成逻辑已变，不删 vendor 和 composer.lock，后续 autoload 必然出错。
多项目共存时最稳妥的调用方式
别依赖全局 composer 命令，直接指定 PHP 路径跑 composer.phar：
- Linux/macOS：
/usr/bin/php8.2 composer.phar install - macOS Homebrew：
/opt/homebrew/bin/php@8.2 -d memory_limit=-1 /usr/local/bin/composer.phar install - Windows：
"C:\php\php-8.2.12\php.exe" composer.phar install（路径带引号）
COMPOSER_PHP 环境变量也行（Composer 2.2+ 原生支持），但要注意：如果 which composer 返回的是 shell 脚本（开头是 #!/usr/bin/env php），那这个变量就无效——得换成上面的完整路径写法。
