composer 2.5.0+ 已彻底移除 self-update 命令，执行必报“command 'self-update' is not defined”；唯一有效升级方式是通过官方安装脚本重装：curl -ss https://getcomposer.org/installer | php，再移至 $home/.local/bin/composer 并确保 php ≥ 8.0。

composer self-update 不是“升级 Composer 的通用方法”，而是仅对官方 PHAR 安装方式有效的自我替换命令；它在 2.5.0+ 版本中已被彻底移除，现在执行只会报 Command "self-update" is not defined。

composer self-update 命令在哪还能用？

只有满足以下全部条件时，composer self-update 才可能成功运行：

• 你用的是官方脚本安装（curl -sS https://getcomposer.org/installer | php），且二进制文件是直接可执行的 composer.phar（不是 Homebrew/apt 的 wrapper 脚本）
• 当前 Composer 版本 ≤ 2.4.9 —— 2.5.0 及之后所有版本（包括 2.5.x、2.6.x、2.7.x、2.9.6）都已删除该命令
• which composer 输出的是一个真实可写的 PHAR 文件路径（如 $HOME/.local/bin/composer），而非 /usr/bin/composer 这类系统软链接

如果你运行 composer self-update 得到 Command "self-update" is not defined，这不是网络或权限问题，是命令本身已不存在。别换镜像、别加 sudo、别重试 —— 直接放弃。

为什么 composer self-update 报 Permission denied？

报错 file_put_contents(): failed to open stream: Permission denied 的本质是：你没有写入 $(which composer) 所指文件的权限。常见于：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 用 sudo curl 装到 /usr/local/bin/composer，但当前用户不是 root
• Homebrew 安装的 /opt/homebrew/bin/composer 是只读 wrapper，self-update 试图改它却失败
• Windows 下正在运行的 composer.phar 被系统锁定，无法覆盖

硬加 sudo composer self-update 会把新二进制属主设为 root，后续 composer install 生成的 vendor/ 目录也归 root，CI 流水线直接崩。正确做法是：用 php composer-setup.php --install-dir=$HOME/bin --filename=composer 重装到用户目录，并确保 $HOME/bin 在 $PATH 前置位置。

现在怎么升级到 Composer 2.9.6 或更高版？

2026 年当前稳定版是 Composer 2.9.6，升级必须走官方重装流程，且有硬性前提：

• PHP 版本必须 ≥ 8.0（php -v 检查），否则新版运行即报 ParseError: syntax error, unexpected Attribute
• 先清理旧版：mv $(which composer) $(which composer).bak
• 下载并安装：curl -sS https://getcomposer.org/installer | php → 生成 composer.phar
• 移到可执行路径：mv composer.phar $HOME/.local/bin/composer（确保 $HOME/.local/bin 在 $PATH 中）
• 验证：composer --version 应输出 Composer version 2.9.6，末尾带 commit hash 和日期，不含 snapshot 或 beta

重装后记得恢复镜像源：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ —— 这步容易漏，不设就会回退到慢速官方源。

v2 升 v3 为什么总失败？

composer self-update --3 在 2.5.0+ 已不可用，且 v3 是破坏性大版本：lock 文件结构变更、移除 content-hash、require-dev 信息默认不写入 lock。即使你绕过限制强行装了 v3，首次 composer install 就会报 The lock file does not contain require-dev information。唯一解法是删掉 composer.lock 重建 —— 这意味着依赖解析逻辑已变，不能简单“升级”了事。生产环境目前仍应坚守 2.9.6，v3 尚未正式发布（截至 2026 年 6 月）。