Composer 2.5+ 内置 composer audit 命令但需手动升级并启用,它依赖 packagist.org 安全数据库检测已锁定包的漏洞,不自动修复、不处理间接依赖冲突,输出含 severity 和 solution 字段供人工决策。
Composer 本身不自带
命令——它是在 Composer 2.5+ 中才正式引入的内置安全审计功能,但默认未启用,且依赖外部服务(packagist.org 的安全告警数据库)。如果你执行
报错 “Command ‘audit’ is not defined”,大概率是因为版本过低或未启用安全插件。
确认 Composer 版本并升级到 2.5+
低于 2.5 的 Composer 完全没有
子命令。运行以下命令检查:
若输出类似
,必须升级:
全局升级:
如仍卡在 2.4.x,可能是被镜像或旧安装方式锁定,可强制重装:
升级后再次运行
确认 ≥ 2.5.0
运行
composer
audit 的正确姿势
默认只检查
中已安装的包(即生产依赖),不扫描
,也不主动更新 lock 文件。常见误操作包括:
没加
却期望检查当前 lock 状态(其实它是默认行为,但显式写上更稳妥)
忘记先
或
,导致 lock 文件陈旧,漏报已修复但未锁定的漏洞
在 CI 环境中因网络限制无法访问 packagist.org/security-advisories.
js
on,会静默跳过审计
推荐执行流程:
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑,通过深度错误修复、底层性能微调以及安全加固,旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范,不包含破坏性变更。
下载
输出结构化结果,方便脚本解析;省略则为人类可读格式(含颜色)。
理解 audit 输出中的关键字段
JSON 输出里每个漏洞项包含
、
、
、
等字段。重点看:
或
:需立即处理;
通常指信息泄露类,影响有限
字段给出具体修复建议,例如:
—— 注意它不自动执行 update,只是提示
字段为空?别慌,Packagist 安全库不强制要求 CVE 编号,很多 PHP 生态漏洞只有自定义 ID(如
的
)
audit 不解决的问题,你得手动做
是检测工具,不是修复工具。它不会:
自动
—— 即使
写了“update to 2.3.1”,你也得自己执行
处理间接依赖(transitive dependencies)的冲突:比如 A 依赖 B@1.0,B@1.0 有漏洞,但 A 锁死了 B 的版本,此时
会报出,但
可能因兼容性失败而无法升级 B
识别本地修改过的包(如
类型仓库)—— 这些包不在 Packagist 数据库中,audit 直接跳过
真正卡住的地方往往不是“有没有漏洞”,而是“能不能安全升级”。这时候得看
查阻塞源,再决定是升级上游、打 patch 还是临时忽略(用
参数,但需记录原因)。
composer auditcomposer auditauditcomposer --versionComposer version 2.4.4composer self-updatephp -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" && php composer-setup.php && sudo mv composer.phar /usr/local/bin/composercomposer --versioncomposer auditcomposer.lockrequire-dev--lockedcomposer installcomposer updatecomposer install --no-interaction
composer audit --locked --format=json--format=jsonadvisorypackageversionsolution"severity": "critical""high""low""solution""Update foo/bar to version 2.3.1 or higher.""cve"symfony/serializersf-2022-01composer auditcomposer update foo/barsolutionauditcomposer update Apathcomposer why-not foo/bar:2.3.1--ignore