composer audit不是插件,而是Composer 2.5.0+内置命令,依赖AdvisoryChecker类和Packagist /advisories API,需满足版本≥2.5.0、启用experimental.audit、存在有效composer.lock且网络可达Packagist安全接口四条件。

composer audit 不是插件,也不存在“依赖审计插件”这个东西——强行安装所谓中文审计插件,只会让扫描失效、漏报漏洞、甚至破坏 CI 流程。
为什么 composer audit 命令不来自插件
Composer 的 audit 命令是 2.5.0+ 版本内置的 CLI 功能,由 AdvisoryChecker 类驱动,直连 Packagist 的 /advisories API。它不通过 PluginInterface 注册,也不在 pre-install-cmd 或其他钩子中运行。所有声称“安装审计插件启用 audit”的做法,本质是混淆了命令机制和插件机制:
- 插件无法在依赖解析完成前介入,而
audit必须基于准确的composer.lock才能比对已知漏洞 - 插件无权触发
audit的真实逻辑,只能伪造输出或调用外部脚本,结果不可信 - 若插件使用自定义源或非标准包名,Packagist 安全数据库根本无法匹配,
CVE-2023-12345这类条目直接漏掉 - 插件报错不能中断安装流程,但安全审计必须能在 CI 中失败构建——这只能靠原生命令退出码实现
真正有效的 audit 启用步骤
要让 composer audit 可用且可靠,必须逐项确认以下四点,缺一不可:
- 执行
composer --version,输出 ≥2.5.0(当前最新稳定版是2.9.6) - 运行
composer list | grep audit有输出;若无,说明实验特性未开启:composer config --global experimental.audit true - 项目根目录存在未被
.gitignore屏蔽的composer.lock文件(audit只读 lock,不看composer.json) - 网络可访问
https://packagist.org/advisories;企业环境常见失败原因:代理未配置、防火墙拦截、镜像源未同步 security-advisories 接口
CI/CD 中避免踩坑的关键参数
在 GitHub Actions、GitLab CI 等环境中,直接写 composer audit 是危险的,默认行为会因任意 low 级漏洞就返回非零退出码,导致构建误失败:
- 用
--severity=critical,high聚焦真正需要干预的风险等级 - 加
--no-dev排除开发依赖干扰,只评估生产环境实际加载的包 - 强制结构化输出:
composer audit --format=json --no-dev,再用jq '.advisories[] | select(.severity == "critical")'提取关键项 - 本地开发时设
COMPOSER_NO_AUDIT=1环境变量跳过,避免阻断日常调试 - 不要加
--locked:它是默认行为,加了反而让人误以为能绕过 lock 校验,实际无效
当 audit 扫不出已知 CVE 时该查什么
常见“没报但其实有漏洞”的情况,往往不是工具问题,而是数据链断在某个环节:
-
composer.lock过期:运行composer install或composer update更新锁文件后再试 - 用了私有仓库但未在
composer.json的repositories中声明,或该仓库未提供security-advisories兼容字段 - 镜像源不支持安全通告接口:临时切回官方源验证
composer config --global repo.packagist.org https://packagist.org - 漏洞不在 PHP-SECADV 数据库中:该库只收录 Symfony/Drupal/Laravel 等主流生态确认条目,小众包或新披露未同步的 CVE 就查不到
真正难处理的,从来不是命令怎么敲,而是锁文件是否可信、网络是否可达、镜像源是否完整同步了 advisories 数据——这些环节一旦松动,audit 就成了摆设。











