composer self-update 不依赖系统 PHP 解释器，而是直接替换 PHAR 文件；它仅通过 PATH 查找并更新 composer 可执行文件本身，与 php -v 输出无关，但 PHP 版本需 ≥ 8.0 才能运行更新后的 Composer 2.5+。
composer self-update 用的是哪个 PHP？
它根本不用你系统里“看起来最顺眼”的那个 PHP——composer self-update 是一个 PHAR 文件的自我替换操作，全程不经过 php 命令解释器。它只依赖当前 shell 的 PATH 找到 composer 可执行文件本身（比如 /usr/local/bin/composer），然后直接下载新版本覆盖它。
所以 PHP 多版本共存对 self-update 本身没影响，但容易混淆的是：你敲下命令时，终端可能调用的是某个 wrapper 脚本（比如 Homebrew 的 /opt/homebrew/bin/composer），而这个脚本内部又硬编码了某版 PHP 路径；或者你用 sudo composer self-update，root 的 PATH 和你用户不同，结果更新了错误位置的文件。
- 运行
which composer确认目标路径 - 运行
ls -l $(which composer)看它是 PHAR、软链接还是 wrapper 脚本 - 如果是 wrapper（如 Homebrew 安装），
self-update实际更新的是它背后引用的 PHAR，不是脚本本身 - 别信
php -v输出——它和self-update是否成功无关
为什么升级后 composer --version 还是旧版？
常见于 PATH 冲突或软链接套娃：你更新了 /usr/local/bin/composer，但 shell 实际执行的是 $HOME/bin/composer（因为它的目录在 PATH 更前）；或者 /usr/local/bin/composer 是个指向 /opt/composer.phar 的软链接，你更新的是前者，后者没动。
- 先执行
which composer，再执行composer --version，看输出的路径是否一致 - 如果
which composer返回/usr/local/bin/composer，但ls -l /usr/local/bin/composer显示它指向/opt/composer.phar，那你得确认/opt/composer.phar是否真被替换了 - Homebrew 用户注意：
brew upgrade composer才是正确升级方式，self-update可能无效甚至破坏 wrapper - Windows 用户尤其要检查是否被
C:\Windows\php.exe干扰——某些旧版安装包会把 php 放进系统目录并优先被调用
PHP 版本不兼容导致 self-update “成功却崩溃”
Composer 2.5.0+ 要求 PHP ≥ 8.0；如果你还在用 PHP 7.4，self-update 可能表面成功（返回 “Updated”），但紧接着 composer --version 就报 Fatal error: Attribute ——这不是更新失败，是新版根本跑不起来。
立即学习“PHP免费学习笔记（深入）”；
- 执行前先确认当前 CLI PHP 版本：
php -v，不是看 Web 环境或 IDE 里的版本 - 若 PHP curl -sS https://getcomposer.org/installer | php -- --version=2.4.4 锁定兼容版本
- 升级后首次运行任何 Composer 命令（哪怕只是
--version）都必须通过目标 PHP 执行验证，例如：/usr/bin/php8.1 /path/to/composer --version - CI/CD 中务必显式指定 PHP 路径，避免因 runner 默认 PHP 版本导致构建失败
Composer 2.5+ 报 “Command not defined” 怎么办
这不是 bug，是官方移除了该命令。所有 2.5.x 及之后版本（包括 2.6.x、2.7.x、2.9.6）都不再支持 self-update，无论你换源、加 sudo 还是重试，都会报 Command "self-update" is not defined。
- 唯一有效动作：用官方安装脚本重装，例如：
curl -sS https://getcomposer.org/installer | php -- --install-dir=$HOME/bin --filename=composer - 重装前先确认 PHP ≥ 8.0：
php -v，否则新脚本会拒绝执行 - Homebrew 用户请用
brew upgrade composer，不要试图用self-update - Linux 包管理器安装（apt/yum）用户应走系统升级通道，
self-update从一开始就不被支持
真正麻烦的从来不是命令怎么写，而是你敲下 composer self-update 时，到底想解决什么问题——是 PHP 版本错、权限不够、PATH 混乱，还是根本不知道自己用的是包管理器安装的 Composer。
