生产环境依赖安全审计必须用composer audit --no-dev,且仅当composer.lock存在、Composer≥2.5.0、网络能通Packagist安全数据库时才真正有效;否则“No advisories found”可能是假阴性。

生产环境依赖安全审计必须用 composer audit --no-dev,且仅当 composer.lock 存在、Composer ≥ 2.5.0、网络能通 Packagist 安全数据库时才真正有效。
确认 audit 命令是否可用且可信
别直接跑命令——先验证三件事:版本、锁文件、数据源。否则看到 “No advisories found” 可能是假阴性,不是真安全。
- 运行
composer --version,输出必须是2.5.0或更高;2.4.x虽带audit,但不对接 Snyk,Laravel/CVE-2023-41277 这类高危漏洞会漏掉 - 检查
composer.lock是否存在且未被.gitignore忽略;audit 只读这个文件,不看composer.json的约束 - 执行
curl -I https://packagist.org,确认能连通;国内镜像(如阿里云、腾讯云)大多不同步security-advisories接口,临时切回官方源:composer config --global repo.packagist.org composer https://packagist.org
生产环境必须加 --no-dev 参数
开发依赖(如 phpunit/phpunit、mockery/mockery)在生产环境根本不加载,但它们的漏洞仍可能被攻击者利用(比如通过 CI 构建链、调试接口或误部署的 dev 工具)。audit 默认不扫这些包,所以你得主动排除干扰项,聚焦真实风险面。
使用 template.yaml 定义创建 Spotify Backstage 软件模板,包含 Scaffolder 操作,包括 fetch:template、publish:github 和 catalog:register。通过其 REST API 管理 Backstage 软件目录。
- CI 流水线中固定写法:
composer audit --no-dev --severity=critical,high --no-interaction --timeout=30 - 避免默认行为返回非零退出码导致构建失败:它只要发现任意一条 advisory 就 exit 1,哪怕是个 low 级 CVE;加
--severity才能卡住真正可利用的风险 - 输出结构化数据供后续解析:
composer audit --format=json --no-dev | jq '.advisories[] | select(.severity == "critical")'(需提前装jq)
私有包和 fork 包默认不参与审计
audit 底层只查 FriendsOfPHP/security-advisories 数据库,这个库不收录私有包、未同步的 fork、path 类型本地依赖,也不会从 VCS 源自动拉取安全元数据——它不是 CVE 扫描器,而是“已知主流生态漏洞比对器”。
- 若用了私有源,必须在
composer.json的repositories中显式声明"type": "composer",URL 末尾带斜杠(如"https://satis.example.com/"),并禁用官方源:"packagist.org": false - 私有包的安全信息要手动注入到其
packages.json响应里,字段名必须是security-advisories,结构严格兼容 FriendsOfPHP schema;用advisories或advisory都无效 - 认证失败(如
auth.jsonhost 不匹配)会导致该源静默跳过,audit 不报错也不提示——验证方式:composer config --auth --list,确认 key 和 URL host 完全一致
audit 不校验 PHP 版本或扩展兼容性
它只管漏洞,不管你的 config.platform.php 是不是写错了、ext-json 有没有装、某个依赖最新版是否要求 PHP 8.3+——这些都可能让部署失败或运行时崩溃,但 audit 完全不提醒。
- CI 中必须紧接在
composer audit --no-dev后执行:composer validate --strict - 如果项目用了
config.platform,validate会据此检查扩展是否存在、PHP 版本是否匹配;某些 CI 镜像(如阿里云 Composer 镜像)会丢弃 platform 元数据,建议核心项目直连https://packagist.org - audit 发现漏洞后,修复动作仍是手动
composer update vendor/package;它不改composer.json,也不降级;更新后务必重新运行composer audit并提交新的composer.lock
最常被忽略的一点:audit 的结果强依赖 composer.lock 的时效性。CI 中如果误用 composer update 替代 install,或者 lock 文件被 gitignore,那 audit 实际扫描的是一个“从未在任何环境验证过”的依赖快照——它报告的“无漏洞”,可能只是数据没对上。

















