composer audit 需同时满足 Composer ≥ 2.5.0、存在有效 composer.lock、可访问 Packagist 安全数据库三条件,缺一则报错或静默;需启用 experimental.audit、验证命令存在、确保网络与数据源就绪。

composer audit 不是开箱即用的功能,它需要三件事同时就位:Composer ≥ 2.5.0、composer.lock 存在且有效、能连上 Packagist 安全数据库。缺一不可,否则你会看到静默无输出、Command not defined 或 Could not fetch advisories。
确认 audit 命令是否真正可用
很多人卡在这一步,以为装了 Composer 就能扫——其实不是。
-
composer --version必须输出2.5.0或更高;低于这个版本,audit命令压根不存在,composer self-update是唯一解 - 即使版本达标,
composer list | grep audit没输出,说明实验特性没启用:composer config --global experimental.audit true - 某些 CI 镜像(如旧版阿里云 Composer 镜像)打包时裁掉了审计模块,
self-update也无效,只能换官方composer.phar -
ls composer.lock要有内容,且不能被.gitignore忽略;空文件或哈希与vendor/不一致,audit会直接跳过
私有源必须显式声明 type: "composer" 才进审计范围
写成 "type": "vcs" 或留空,audit 就当它不存在——哪怕 URL 能返回 packages.json,也不会查里面有没有漏洞。
- repositories 里该项的
type字段值必须严格为"composer" -
url末尾必须带斜杠,比如"https://satis.internal/",否则请求packages.json会 404 - 同级加
"packagist.org": false,否则 Composer 默认先走官方源,你的私有包永远不进审计路径 - 私有源返回的
packages.json必须手动注入security-advisories字段,格式要完全兼容 FriendsOfPHP/schema;用advisories或结构错位,audit直接忽略
CI 流水线里 audit 不能只跑默认命令
默认行为对自动化极其不友好:发现任意一条 advisory(哪怕是 5 年前的 low 级 CVE)就返回非零退出码,构建直接失败。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 生产卡点只关注真实可利用风险:
composer audit --severity=critical,high --no-dev - CI 必须加
--dev,否则phpunit/phpunit、mockery/mockery这类开发依赖漏洞全被跳过 - 防网络抖动卡住:
composer audit --no-interaction --timeout=30 - 结构化输出供脚本判断:
composer audit --format=json --no-dev | jq '.advisories | length',检查advisories_count是否为 0,别信退出码 - 镜像源不支持安全通告接口(国内多数镜像如此),临时切回官方源:
composer config --global repo.packagist.org https://packagist.org
audit 只报告,不修复,也不校验平台兼容性
它告诉你“哪个包哪个版本有已知漏洞”,但不会提醒你“这个包最新版要 PHP 8.3,而你锁在 8.2”——这种问题得靠 composer validate --strict 补上。
- 发现漏洞后,优先执行
composer update vendor/package --with-dependencies,而不是盲目composer update - 若无法升级,
--ignore=CVE-2023-12345可临时绕过,但必须在代码注释里写明理由和预期修复时间 -
composer validate --strict必须和audit一起跑,它会检查config.platform是否匹配、扩展是否缺失、PHP 版本是否越界 - 私有 fork 包、
path类型本地依赖,默认不参与审计;要支持,得手动配"type": "package"并提供security-advisories字段
最常被忽略的一点:audit 的结果准确性高度依赖数据源。FriendsOfPHP/security-advisories 库不收小众包、不收新披露未同步的 CVE,也不覆盖未签名的私有包——它只是个起点,不是终点。










