如何解决Debian11上Yii2项目Composer提示PHP版本不满足要求的报错

故障根因 #

这个问题常见有两类核心原因：

1. 命令行调用Composer时用的PHP版本，和你php -v看到的版本不一致
2. Composer更新后拉取了依赖高PHP版本的包，而你的站点Web服务绑定的PHP版本低于8.0

修复步骤 #

第一步：先确认Composer实际运行的PHP版本

执行以下命令查看Composer运行时使用的PHP版本：

# 查看Composer的启动脚本头部，确认默认调用的PHP路径
head -n1 $(which composer)
# 手动指定PHP8.0运行Composer，验证是否还报错
/usr/bin/php8.0 $(which composer) update --dry-run

如果手动指定PHP8.0运行正常，说明Composer默认绑定了旧版PHP，两种修复方式可选：

• 每次运行Composer都手动指定PHP8.0路径，例如/usr/bin/php8.0 $(which composer) update
• 修改Composer启动文件的首行shebang，将路径改为你的PHP8.0可执行文件路径，例如#!/usr/bin/php8.0

第二步：检查Composer的平台配置

执行以下命令查看是否存在强制锁定的PHP版本配置：

composer config --list | grep platform.php

如果返回了低于8.0的版本号，执行以下命令删除锁定配置：

# 删除项目级配置
composer config --unset platform.php
# 如果是全局配置就加--global参数
composer config --global --unset platform.php

你也可以主动在composer.json的config段添加固定版本配置，强制Composer按你当前环境的PHP版本做检查：

"config": {
    "process-timeout": 1800,
    "platform": {
        "php": "8.0.10"
    },
    "github-oauth": {}
}

第三步：确认站点Web服务的PHP版本

如果执行composer update时命令行没有报错，只有浏览器访问站点时报错，说明你的Web服务（Nginx/Apache）绑定的PHP-FPM/模块版本低于8.0：

• Nginx环境：找到站点配置里的fastcgi_pass配置项，修改为php8.0-fpm的socket地址，例如fastcgi_pass unix:/run/php/php8.0-fpm.sock;，修改后重载Nginx配置
• Apache环境：执行a2dismod php7.4 && a2enmod php8.0 && systemctl restart apache2切换启用的PHP版本

第四步：清理旧依赖重新安装（可选）

如果上述步骤都执行后仍报错，先备份composer.lock文件和vendor目录，再执行以下命令重新生成依赖：

rm -rf composer.lock vendor
composer update

内容的提问来源于stack exchange，提问作者Jorge Palacios Zaratiegui