composer audit --format=json 是唯一稳定输出结构化数据的方式,输出含 advisories 数组,每项含 id、package、version、severity、title、cve 等字段;无漏洞时输出 {},不包含被忽略条目,且 severity 仅限 critical/high/medium/low 四种。

composer audit 输出的 JSON 格式结构
Composer 本身不提供 composer audit 命令——这是由 composer/composer 官方未内置的功能,实际依赖审计需借助第三方插件(如 sensiolabs/security-checker 已弃用)或现代替代方案 composer audit 来自 composer/composer 2.5+ 内置命令(自 2023 年起)。该命令默认输出为 JSON,且仅当检测到漏洞时才输出完整结果。
导出时需显式指定格式,否则终端直接打印人类可读摘要。关键点是:它不生成报告文件,必须重定向或用 --format=json 显式触发。
-
composer audit --format=json是唯一稳定输出结构化数据的方式 - 输出 JSON 包含
advisories数组,每个条目含id、title、severity、package、version、cve(若存在)等字段 - 无漏洞时输出为空 JSON 对象
{},不是空数组或 null - 不包含已忽略(
composer.json中audit-ignore)的条目,除非加--show-ignored
导出为 CSV 或 Markdown 的实操转换方式
Composer 不支持原生 CSV/Markdown 导出,必须管道处理。推荐用 jq 做轻量转换,避免引入重型解析器。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 导出 CSV(含表头):
composer audit --format=json | jq -r ' ["ID","Package","Version","Severity","Title"], (.advisories[] | [.id, .package, .version, .severity, .title]) | @csv ' > audit.csv
- 生成简洁 Markdown 表:
composer audit --format=json | jq -r ' "| ID | Package | Severity |\n|---|---|---|", (.advisories[] | "| \(.id) | \(.package)@\(.version) | \(.severity) |") ' > audit.md
- 注意:若
.advisories为空(即无漏洞),jq默认报错;加?可静默跳过:.advisories[]?
与 composer show -t 的区别:别混淆依赖树和安全审计
composer show -t 显示的是包依赖图谱,不含任何漏洞信息;而 composer audit 仅查询 Symfony Security Advisory Database,两者数据源、用途、输出结构完全不同。
-
composer show -t输出纯文本树形结构,无法结构化提取 -
composer audit的 JSON 输出字段固定,但severity值只有critical、high、medium、low四种,无unknown - 若项目使用私有包或 fork 分支,
composer audit默认跳过——它只校验 Packagist 上已收录且有对应 advisory 的版本
CI 环境中自动导出并失败控制
在 GitHub Actions 或 GitLab CI 中,不能只靠 composer audit 返回码判断是否“有风险”:默认有漏洞时返回 1,但若想“发现任意严重及以上漏洞就中断构建”,需额外过滤。
- 只在
critical或high时失败:composer audit --format=json | jq -e 'any(.advisories[]; .severity == "critical" or .severity == "high")' > /dev/null
- 导出报告同时控制退出码:
composer audit --format=json > audit-report.json && \ jq -e 'length == 0 or (all(.advisories[]; .severity != "critical" and .severity != "high"))' audit-report.json
- 注意:Windows PowerShell 用户需改用
jq-win64.exe,且路径中含空格时必须引号包裹
真正容易被忽略的是 advisory 数据库的更新延迟——它不实时同步 CVE,通常滞后 24–72 小时。生产环境审计不能替代 SCA 工具的主动扫描。

















