Composer依赖审计不能自动定时,必须由操作系统调度器驱动;audit默认不扫描dev依赖、平台兼容性及私有包,需在crontab或PowerShell中显式指定绝对路径、cd项目目录、加--dev参数、重定向日志,并用--format=json解析advisories_count字段判断真实漏洞数,且CI中须串联composer validate --strict校验平台兼容性。

Composer 依赖审计不能靠 Composer 自己定时,必须交由操作系统调度器驱动,且 audit 命令本身有严重默认限制——不扫 dev 依赖、不校验平台兼容性、不覆盖私有包,直接跑 composer audit 几乎等于没审。
Linux/macOS 下用 crontab 调 composer audit 必须加这四件事
crontab 不继承你的 shell 环境,PATH 极窄,composer 命令大概率找不到;同时 composer audit 默认只查生产依赖,漏掉 phpunit 这类开发依赖就是留后门。
- 用
which composer确认绝对路径,例如/usr/local/bin/composer,crontab 里必须写全 - 显式
cd /path/to/your/project切到项目根目录,否则报Could not find composer.lock - 强制加
--dev参数:/usr/local/bin/composer audit --dev --no-interaction,否则开发依赖漏洞全跳过 - 重定向输出并追加时间戳:
2>&1 >> /var/log/composer-audit-$(date +\%Y\%m\%d).log,避免日志被覆盖
Windows 任务计划程序调用 composer audit 的 PowerShell 脚本要点
PowerShell 默认不加载用户环境变量,PATH 里没有 composer 就会失败;而且 audit 在 Windows 下 stderr 不自动合并,不处理就看不到错误信息。
- 脚本开头必须用
Set-Location "C:\myapp"切项目目录,不能依赖当前工作路径 - 调用前检查执行策略:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser,否则脚本被阻止 - 推荐用完整路径调用,比如
& "C:\ProgramData\ComposerSetup\bin\composer.phar" audit --dev --no-interaction - 捕获全部输出:
2>&1 | Out-File -Append -Encoding UTF8 "C:\logs\composer-audit.log"
composer audit 输出的 advisories_count 字段才是真实漏洞数
命令行输出的 “found X advisories” 是展示用的,可能含重复或已忽略项;JSON 格式才可靠,尤其 CI 中需做自动化判断。
- 加
--format=json获取结构化结果:composer audit --dev --format=json 2>/dev/null | jq '.advisories_count' - 注意:返回
0不代表绝对安全——私有包、fork 包、path类型本地依赖默认不扫描,advisories_count为 0 只说明“已知公开库中无匹配漏洞” - 若项目用了自定义仓库,先运行
composer config repositories确认源是否可信,非https://packagist.org的镜像可能丢弃安全元数据
CI 流水线里必须串联 composer validate --strict
composer audit 只管漏洞,不管你的 PHP 版本或扩展是否真能跑起来。一个“零漏洞”但 platform.php 写成 "8.2"、而依赖最新版要求 8.3+ 的项目,上线就崩。
- CI 中 audit 后必须紧跟:
composer validate --strict,它会校验platform配置、PHP 版本、扩展是否存在 - 如果用了
config.platform,validate --strict会据此检查ext-mbstring等是否声明,避免部署时才发现扩展缺失 - 某些云 CI 镜像(如阿里云 Composer 镜像)会缓存或剥离
platform元数据,关键项目建议直连https://packagist.org
真正容易被忽略的是:audit 结果为 0 并不等于可以上线,它只是第一道过滤网;私有包得人工盯 GitHub SECURITY.md,平台兼容性得靠 validate 拦,而所有这些都得在操作系统级定时任务里显式串起来——少一个环节,就等于把漏洞当空气。











