Composer报错Unsupported version是因PHP与Composer版本不匹配：PHP过新而Composer太旧（最常见），或PHP过旧而Composer要求过高；需用php $(which composer) --version确认真实版本，再按PHP版本选择对应Composer版本升级或降级。
Composer 报错 Unsupported version，基本就是当前 Composer 版本不支持你正在运行的 PHP 版本——不是 PHP 太新，就是 Composer 太旧（更常见），也可能是你手动装了预发布版 Composer 而 PHP 环境没跟上。
怎么确认是 PHP 和 Composer 版本不匹配？
先看报错上下文。如果错误信息里带 requires PHP >= 8.1.0 或类似提示，而你运行 php -v 输出的是 PHP 7.4.33，那就坐实了不兼容。Composer 的每个稳定版本都硬性声明了支持的 PHP 版本范围，不满足就直接拒绝启动。
- 运行
composer --version查看当前 Composer 版本（如Composer version 2.5.8） - 查官方支持表：
Composer 2.5+要求PHP >= 8.0.2；Composer 2.2–2.4支持PHP 7.2.5–8.1；Composer 1.x最高只到PHP 7.4 - 别信
which composer的路径——有些环境会残留旧二进制或 alias，用php $(which composer) --version才能绕过 shell wrapper 看真实执行版本
升级 Composer 到匹配 PHP 的版本
如果你用的是较新 PHP（比如 8.2 或 8.3），但 Composer 还卡在 2.2，就得升级。官方推荐用 curl 方式重装，避免包管理器缓存旧版。
- 执行
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" - 再运行
php -r "if (hash_file('sha384', 'composer-setup.php') === 'e6ceff1999a53de9164e3c4d79a4b9f9a7a2e3a4b9f9a7a2e3a4b9f9a7a2e3a4b9f9a7a2e3a4b9f9a7a2e3a4b9f9a7a2') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"（注意替换为官网最新校验值） - 最后
php composer-setup.php --install-dir=/usr/local/bin --filename=composer - 验证：
composer --version应输出类似Composer version 2.7.7（适配 PHP 8.2+）
降级 Composer（仅当 PHP 无法升级时）
生产环境锁死在 PHP 7.4？那必须用 Composer 2.2.22 或 Composer 1.10.22。Composer 2.3+ 已彻底放弃对 PHP 7.4 的支持。
立即学习“PHP免费学习笔记（深入）”；
- 下载指定版本：
php -r "copy('https://getcomposer.org/download/2.2.22/composer.phar', 'composer.phar');" - 设为可执行：
chmod +x composer.phar - 临时使用：
php composer.phar install；全局替换则sudo mv composer.phar /usr/local/bin/composer - 注意：降级后不要运行
composer self-update，它会无视 PHP 版本强制拉最新版
为什么 composer self-update 有时没用？
因为该命令默认只升级到「当前主版本的最新补丁」，比如你在用 Composer 2.2.0，self-update 只会升到 2.2.22，不会跳到 2.3.0——但如果你原本就是 2.3.0，它也不会帮你退回去。更麻烦的是，某些 Linux 发行版（如 Ubuntu）通过 apt 安装的 Composer 是打包时冻结的版本，self-update 根本不生效。
- 检查是否被系统包管理器接管：
dpkg -l | grep composer（Debian/Ubuntu）或rpm -qa | grep composer（RHEL/CentOS） - 若存在，优先卸载：
sudo apt remove composer，再用官方 phar 方式安装 -
self-update --rollback可退回上一个版本，但仅限最近一次更新，且不解决跨主版本问题
最常被忽略的一点：Docker 容器里跑的 PHP 和宿主机的 Composer 版本毫无关系——你本地升级了也没用，得进容器里单独处理。还有 CI 环境（如 GitHub Actions）默认用的 Composer 版本可能滞后，需要显式指定 composer-setup-php action 的 composer-version 参数。
