Laravel升级时Composer识别PHP版本错误，如何强制用正确版本？

问题背景 #

尝试将Laravel 9升级到10，执行composer update时出现版本错误：

Composer detected issues in your platform: Your Composer dependencies require a PHP version ">= 8.1.0". You are running 8.0.28.

已修改composer.json的两处PHP版本配置：

"require": {
    "php": "^8.1.0",
},

"config": {
    "platform": {
        "php": "8.1.0"
    }
},

执行php -v显示当前CLI PHP版本为8.1.17，但composer -vvv about显示Composer仍在使用PHP 8.0.28，导致升级失败。

解决方法 #

1. 直接指定PHP路径执行Composer #

找到PHP 8.1的可执行文件路径（例如/usr/bin/php8.1），用该路径直接调用Composer：

/usr/bin/php8.1 /usr/local/bin/composer update

若不确定PHP 8.1路径，可执行which php8.1查询。

2. 调整系统环境变量优先级 #

修改PATH环境变量，让PHP 8.1的路径排在现有PHP路径之前：

export PATH=/path/to/php8.1/bin:$PATH

执行后直接运行composer update即可。如需永久生效，将该命令添加到~/.bashrc或~/.zshrc文件中，再执行source ~/.bashrc（对应shell配置文件）。

3. 使用Composer的--php参数（Composer 2.4+支持） #

如果你的Composer版本为2.4及以上，可直接通过参数指定PHP路径：

composer update --php=/path/to/php8.1

4. 重新安装Composer绑定PHP 8.1 #

若上述方法无效，重新下载安装Composer，使其默认绑定PHP 8.1：

php8.1 -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php8.1 composer-setup.php
php8.1 -r "unlink('composer-setup.php');"

内容的提问来源于stack exchange，提问作者user2519032