如何通过Composer查看特定扩展包的下载量，以评估其流行度和选型参考？

本文共计726个文字，预计阅读时间需要3分钟。

Composer命令行工具（如composer show、composer search）提供的信息仅包括依赖关系、本地安装状态和统计信息，不涉及任何下载量、安装量或使用频率数据。这些信息来源于Packagist——Composer默认使用的中央包仓库。它管理依赖关系和本地安装状态，所有统计信息都来自Packagist，但API和网页界面不直接公开下载量。

Packagist.org 网页上看到的 “Downloads” 是近似值

Packagist 在每个包页面（如 https://packagist.org/packages/monolog/monolog）右上角显示一个 “Downloads” 数字，例如 “200M+”。这个数字其实是：

• 过去 30 天的**估算安装次数**（不是独立用户数，也不是历史总和）
• 基于 Packagist 接收到的 composer install / composer update 请求日志聚合，去重逻辑有限
• 包含大量 CI 构建、Docker 构建、自动化脚本等非人工触发行为，会显著高估“真实采用率”
• 不区分主版本（^2.0 和 ^3.0 的下载被合并统计）

用 Packagist API 获取近期下载趋势（需解析 JSON）

你可以通过 Packagist 的公开 API 拉取近 30 天每日下载量，比网页上那个单数字更有参考价值：

curl -s "https://packagist.org/packages/monolog/monolog.json" | jq '.package.downloads'

返回类似：

{ "total": 214856789, "monthly": 18234567, "daily": 612345, "trend": "up" }

注意：trend 字段只返回 "up" / "down"，没有具体斜率；daily 是滚动 24 小时均值，不是当日峰值。如果要对比多个包，建议统一取 monthly 值，并手动排除明显异常值（比如某天因 CI 配置错误导致突增 10 倍）。

更可靠的流行度信号：别只盯下载数

真正反映一个包是否被广泛信任和长期维护的，往往是这些可验证指标：

• stargazers_count 和 forks_count（从 GitHub/GitLab 仓库 API 获取）—— 社区关注度更稳定
• 最近一次 commit 时间 + release 频率（看 releases API 或 Packagist 页面的 “Latest release” 时间）
• 是否有活跃的 issue 讨论、PR 合并记录（尤其关注最近 3 个月）
• 是否被 Laravel、Symfony、Drupal 等主流框架官方推荐或直接依赖（查它们的 composer.json）

一个下载量百万级但近两年没更新、issue 积压上百、作者已归档仓库的包，实际风险远高于一个月下载 5 万但每周发版、文档完整、测试覆盖率 >85% 的新锐包。