composer outdated在多仓库下失效,因它仅检查composer.json声明依赖,不识别path仓库、私有源、patch包、replace/provide组件及未提交lock导致的版本漂移。

不能靠 composer outdated 逐个跑,也别信“一键扫描所有 vendor”的脚本——它大概率漏掉私有包、软链接、多源配置和被 patch 过的依赖。
为什么 composer outdated 在多仓库下失效
这个命令只检查当前 composer.json 声明的依赖版本是否过期,不解析 vendor/autoload.php 实际加载的类,更不会识别:
• 被 path 类型 repository 引入的本地包(比如 "type": "path", "url": "../my-internal-lib")
• 通过 composer config repositories. 动态注册的私有源
• vendor/ 下被手动替换或 patch 的包(常见于安全 hotfix)
• 使用 replace 或 provide 伪装成其他包的组件
• 多环境分支中 composer.lock 未提交导致版本漂移
用 composer show --tree + jq 提取真实依赖图
真正要审计的是运行时实际加载的包结构,不是声明树。先统一进入每个仓库根目录执行:composer show --tree --no-dev | grep -E '^[a-z0-9\-]+/[a-z0-9\-]+' | sed 's/├── //; s/└── //; s/│//g' | sort -u
再把结果导出为 CSV 或 JSON,用 jq 做归一化处理:
• 过滤掉 dev- 开头的临时版本号
• 合并 foo/bar 和 foo/bar-dev(后者常是 fork 分支)
• 标记含 patch、hotfix、security 字样的包名——这些往往跳过了正常升级流程
批量扫描必须绕过 vendor/ 目录本身
直接递归扫描 vendor/ 会误报大量测试文件、文档、.git 子模块,且无法区分哪些是真正被 require 的。正确做法是:
• 只读取每个仓库的 composer.lock 文件(它才是权威依赖快照)
• 用 json_decode(file_get_contents('composer.lock'), true) 解析,提取 packages 和 packages-dev 中的 name、version、source.type(判断是否为 git 或 hg)
• 对 source.url 非公开域名的包(如 git@xxx.internal),单独打标并人工介入
• 忽略 dist.shasum 为空的条目——这说明该包未被 lock,可能来自 require-dev 的动态安装
私有包和 patch 包最容易成为盲区
这类包不会出现在 packagist.org 的 CVE 数据库里,但恰恰是攻击者最常下手的位置:
• 检查 composer.json 中是否存在 "patches" 键(来自 cweagans/composer-patches)
• 扫描 patches/ 目录或 .patch 文件,确认补丁是否已合入上游,还是长期悬空
• 对使用 path repository 的包,检查其对应目录是否存在 composer.json,并验证其中 version 是否与主项目 lock 中记录一致
• 若发现某私有包在 3 个以上仓库中被引用,但无统一发布流程(如没走 git tag + packagist.org 同步),就说明它正在裸奔
真正难的不是扫出一堆过期包,而是区分哪些过期是“可忽略的开发分支残留”,哪些是“已知 CVE 影响线上服务”。每次扫描后,必须人工核对 composer.lock 中的 content-hash 是否与 CI 构建时一致——不一致,说明有人绕过 lock 直接 install,审计结果就不可信。











