需先检查PHP版本与Composer要求是否匹配，如PHP≥8.1对应Composer 2.5+；再验证扩展兼容性，禁用mysql、移除mcrypt；推荐包管理器升级PHP并重装Composer；最后确认CLI/Web SAPI配置一致。
检查当前PHP版本和Composer要求是否匹配
Composer新版本普遍要求PHP ≥ 8.1，比如composer install报错Your requirements could not be resolved to an installable set of packages，往往不是依赖冲突，而是底层直接拒绝运行。先确认手头的PHP版本：php -v；再查你用的Composer版本支持的最低PHP：composer --version（如2.5.x要求PHP 8.0+）。旧版Composer（如1.x）虽支持PHP 7.2，但已停止维护，且无法安装现代包（如Laravel 11、Symfony 7）。
升级PHP前必须验证扩展兼容性
PHP升级不是改个版本号就完事。常见踩坑点：PHP 8.0+默认禁用mysql扩展（已被mysqli和PDO_mysql替代），mcrypt在7.2起废弃、8.0彻底移除。升级前务必检查项目中是否硬依赖这些函数：grep -r "mcrypt_" .、grep -r "mysql_connect" .。还要确认Web服务器（Apache/Nginx）加载的PHP模块是否同步更新——有时CLI是新版，但FPM还是旧版，导致命令行能跑、网页报500。
用系统包管理器升级PHP比编译更稳妥
手动编译PHP容易漏掉openssl、curl、mbstring等Composer必需扩展，且后续升级麻烦。推荐方式：
- 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切换默认版本 - macOS（Homebrew）：
brew install php@8.2，然后把/opt/homebrew/bin（Apple Silicon）或/usr/local/bin（Intel）加到$PATH最前面 - Windows（XAMPP/MAMP）：直接换新版套件，别试图只替换
php.exe，扩展DLL路径极易出错
升级后运行php -m | grep -E "(mbstring|xml|zip|curl)"确认关键扩展已加载。
立即学习“PHP免费学习笔记（深入）”；
Composer自身也要跟着PHP版本对齐
PHP升级后，旧版Composer可能无法启动（报Deprecated: Required parameter $xxx follows optional parameter $yyy之类错误）。必须重装Composer：
- 删掉旧二进制：
rm /usr/local/bin/composer（Linux/macOS）或del %PROGRAMDATA%\ComposerSetup\bin\composer.phar（Windows） - 用官方安装脚本：
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.x或更高，且composer diagnose输出OK
特别注意：某些共享主机或Docker镜像里，composer被软链到composer.phar，而该文件可能仍指向旧PHP解释器，需用head -n1 /usr/local/bin/composer检查shebang行是否为#!/usr/bin/env php——否则要重写为#!/usr/bin/env php8.2。
真正卡住的地方，往往是PHP CLI和Web SAPI用的不是同一套配置，或者composer.json里"platform"字段锁死了低版本PHP，让人误以为升级没生效。这种细节不打日志、不报明确错误，只能一层层which php、php --ini、composer config platform.php去抠。
