Composer 2.11.2 发布安全更新:修复多个任意命令执行与凭据泄露漏洞,并新增下载停转超时
Composer 2.11.2 发布,修复通过 composer.lock 加载可调用传输选项触发的任意命令执行、压缩包符号链接越权写入、跨域重定向重发认证头等问题,并新增下载停转超时与分支排除选项。使用第三方仓库的 PHP 项目建议尽快升级。
Composer 2.11.2 修复锁文件触发的任意命令执行
Composer 2.11.2 修复了经锁文件触发的任意命令执行、压缩包符号链接越权写入与跨域重定向泄露凭据等安全漏洞。 同时补上了下载超时与仓库配置方面的能力。
命令执行与越权写入
最严重的一项是通过 composer.lock 或 vendor/composer/installed.json 加载 prevent url access 的可调用传输选项,从而执行任意命令。官方原文称:“Security: Fixed arbitrary command execution via the prevent url access callable transport option being loaded from composer.lock / vendor/composer/installed.json”。(来源:Composer 官方发布说明)
压缩包解压回退到 ZipArchive 时,恶意 zip 里的符号链接条目可能把文件写到包目录之外,这一版也做了拦截。
凭据与重定向处理
构造过的锁文件可让仓库内联的 HTTP 凭据被发送到其他主机的 dist 镜像;跨域重定向时,请求选项里设置的 Authorization 与 Cookie 头也会被重发。两者都已修复。此外,项目 auth.json 与 COMPOSER_AUTH 中的非认证配置、项目 composer.json 里的 home 配置现在会被忽略并给出警告。
超时与仓库选项
新增 30 秒停转超时:服务器接受连接却一直不响应时,下载会中止并重试,而不是挂满 300 秒,可通过 COMPOSER_HTTP_STALL_TIMEOUT 环境变量调整或关闭。VCS 仓库新增 exclude-branches 用于跳过机器人维护的分支,GitLab、Bitbucket 与 Forgejo 可把 allow-git-fallback 设为 false,遇 API 错误时直接失败。
供应链风险收窄,关闭 git 回退让 CI 更早失败
使用私有包、第三方镜像或依赖 VCS 仓库的 PHP 项目受影响最大,CI 也可能因为失败策略变化而提前报错。
供应链风险收窄
被拦截的几类问题都依赖构造过的锁文件或压缩包。从官方描述看,攻击面来自依赖来源而非项目代码本身,及时升级就能关闭这些路径。
CI 失败更早暴露
关闭 git 回退后,仓库 API 出错会直接失败,而不是悄悄克隆源码。这样能更早发现镜像或令牌配置问题,但也可能让原本能跑通的流水线报错。
依赖获取更稳定
停转超时避免了长时间挂起,重试逻辑由 Composer 统一处理。仓库底层仍依赖 git 的 VCS 能力,相关安全修复可以对照 Git 2.56.1 的安全更新。
使用 Composer 2.11 的项目应尽快升级到 2.11.2
所有使用 Composer 2.11 的 PHP 项目都建议尽快升级到 2.11.2,涉及私有仓库的项目优先级更高。
怎么升级
按你现有的 Composer 安装方式升级到 2.11.2 即可。本次没有列出需要手动修改的配置项,新增选项按需启用。
验证建议
升级后重新执行一次 composer install,确认凭据、镜像与重定向配置符合预期。若 CI 因关闭 git 回退而失败,先检查仓库 API 的令牌与权限。官方未披露回退步骤。
常见问题
- Composer 2.11.2 修复了哪些安全问题?
- 包括任意命令执行、压缩包越权写文件、跨域重定向重发认证头与 IP 拦截时机过晚。
- Composer 2.11.2 的下载停转超时是什么?
- 服务器接受连接却不响应时,30 秒后会中止并重试,可用环境变量调整或关闭。
- Composer 2.11.2 新增了哪些仓库选项?
- VCS 仓库可用 exclude-branches 跳过指定分支,GitLab 等仓库可关闭 git 回退。
- Composer 2.11.2 需要马上升级吗?
- 使用第三方仓库或私有包的 PHP 项目建议优先升级,避免凭据与命令执行风险。
相关术语
- Composer
- Composer 是 PHP 的依赖管理工具,负责解析、下载依赖并生成自动加载文件。
- composer.lock
- composer.lock 是记录依赖精确版本与来源的锁定文件,用来保证安装可重现。
- transport
- transport 是 Composer 处理远程包下载的传输层,负责发起请求与校验响应。
- dist
- dist 是包的分发压缩包,相对于从源码仓库克隆,安装速度更快。
这篇文章的来源是什么?
文中涉及版本、价格与功能的信息,均以厂商原文为准;下面是可以核对的原始出处。
- Composer 2.11.2 · Composer · 2026-11-12
「Composer 2.11.2」 —— Composer
文章目录