composer如何查看某个包是否已被废弃?(abandoned字段识别)

4次阅读

不能。composer show vendor/package 默认不显示abandoned字段,需用composer show -a才能查看abandoned:true、替代包名或NULL等值。

composer如何查看某个包是否已被废弃?(abandoned字段识别)

composer show 能不能直接看出包是否废弃?

不能。默认 composer show vendor/package 不显示 abandoned 字段,哪怕包已被标记为废弃,输出里也不会提示。这是最常被忽略的一点——很多人查完 show 就以为“没异常”,其实只是信息没露出来。

  • --all 参数也无效,它只影响版本列表展示,不触发元数据扩展
  • 真正能暴露废弃状态的,是 composer show -a(注意是小写 -a,不是 --all
  • -a 会强制拉取完整包信息,包括 abandoned 字段值,比如 trueother-vendor/alt-packagenull

示例:
composer show -a monolog/monolog
如果返回中包含 abandoned : trueabandoned : php-fig/log,就说明已废弃。

packagist.org 页面上怎么看 abandoned 字段?

Packagist 页面顶部的「Abandoned」横幅是最直观的信号,但得注意它的来源和延迟:

  • 横幅只在 maintainer 主动调用 Packagist API 标记后才出现,不是自动检测

  • 标记后可能有缓存延迟(通常几分钟到几小时),刚废弃未必立刻显示

  • 如果页面没横幅,不代表安全:有些包从未被标记,但实际已多年无更新、issue 无人回应

  • 查看 json 元数据更可靠:访问 <a href="https://www.php.cn/link/71e04d8a85ed261e4763a9b0dab3ab79">https://www.php.cn/link/71e04d8a85ed261e4763a9b0dab3ab79</a>

  • 直接搜 "abandoned" 字段,值可能是 true字符串(推荐替代包)、或缺失(等价于 false

  • 注意:JSON 中字段存在但值为 null,也代表明确废弃(Packagist v2 协议行为)

composer require 时会不会警告 abandoned 包?

不会主动警告。Composer 在安装或更新时默认静默处理 abandoned 字段,哪怕你装的是一个明确标为废弃的包,命令照样成功,零提示。

  • 只有加 --with-all-dependencies--update-with-dependencies 时,某些旧版 Composer(1.x)会在末尾补一句 “Package X is abandoned…” —— 但新版(2.2+)连这个都去掉了

  • 真正起作用的是 composer outdated --direct:它会把所有直接依赖列出来,并在废弃包名后加 [abandoned] 标记

  • 更彻底的方式是启用严格模式COMPOSER_ABORT_ON_WARNING=1 composer install,但该环境变量只对「警告类错误」生效,不涵盖 abandoned 场景

  • 所以靠 CI 或本地检查时,别依赖安装过程,改用脚本解析 composer show -a 输出或调用 Packagist API 做断言

abandoned 字段为字符串时,怎么判断替代包是否可用?

字段值是字符串(如 "laravel/framework")只表示「官方推荐迁移目标」,不保证兼容、不验证是否存在、也不检查版本约束。

  • 替代包可能尚未发布稳定版,或者 require 约束冲突(比如原包要求 PHP 7.4,替代包最低要 8.1)

  • Composer 不会自动替换 require 行,你得手动改 composer.json 并运行 composer update

  • 最容易踩的坑:直接删掉废弃包,再 require 替代包,结果发现两者命名空间/类名不一致,代码大面积报 class not found

  • 务必先查替代包的文档,确认 API 兼容性层级(BC break 列表、升级指南)

  • 运行 composer why-not vendor/replacement 验证当前环境能否装上它

  • 如果替代包本身也已废弃,JSON 数据里会嵌套显示,得递归检查

废弃不是终点,而是信号——它不告诉你能不能用,只提醒你该花时间看文档了。

text=ZqhQzanResources