Composer 允许安装废弃包是因为其 require 命令不校验 abandoned 字段,仅依赖解析和版本匹配;成功安装只是表象,实际埋下安全、兼容性与维护风险。

composer require 不能也不该用来安装已被标记为 abandoned 的包——这不是操作问题,而是设计事实:Composer 本身不阻止你强制安装,但所有废弃包的元数据都明确表示“作者已放弃维护”,require 成功只是表象,后续风险由你全权承担。
composer require 为什么还能装上废弃包
Composer 的 require 命令默认不校验 abandoned 字段,它只做依赖解析和版本匹配。只要包还存在于 Packagist(哪怕标了废弃),且版本满足约束,命令就能通过。
-
composer require monolog/monolog:^1.25仍会成功,哪怕 Packagist 页面顶上写着 Abandoned! - 安装日志里可能有一行
monolog/monolog is abandoned,但它只是notice级别,exit code仍是 0 -
composer.json不会自动加注释、不改require行、不阻断写入
这导致最危险的情况:你手动敲下 require,以为只是加个依赖,实际却埋下安全与兼容性地雷。
怎么确认一个包真被废弃了(别信 require 是否成功)
靠安装行为判断毫无意义。唯一可信动作是查快照:
使用 template.yaml 定义创建 Spotify Backstage 软件模板,包含 Scaffolder 操作,包括 fetch:template、publish:github 和 catalog:register。通过其 REST API 管理 Backstage 软件目录。
- 运行
grep -A1 -B1 '"abandoned"' composer.lock:如果刚require完就出现"abandoned": true或"abandoned": "new/vendor",说明 Composer 在解析时已拿到废弃信号 - 对比
composer show monolog/monolog输出:含abandoned : true或replaced by : php-monolog/monolog即为实锤 - 打开
<a href="https://www.php.cn/link/6daab15a4f57549b7f236d7f0cfca3c8">https://www.php.cn/link/6daab15a4f57549b7f236d7f0cfca3c8</a>:右上角横幅才是最终裁决,带时间戳和维护者签名
注意:国内镜像(如阿里云)可能缓存旧元数据,composer config -g repo.packagist composer <a href="https://www.php.cn/link/ec811d0d775adc62776ba80fadd4ed19">https://www.php.cn/link/ec811d0d775adc62776ba80fadd4ed19</a> 切回官方源再试一次,才能排除延迟误判。
强制 require 废弃包的后果不是“能不能”,而是“值不值”
你当然可以用 --ignore-platform-reqs 或临时切镜像绕过警告,但以下问题无法绕过:
- 废弃包通常不再修复 CVE,PHP 8.3+ 的
#[\ReturnTypeWillChange]兼容性、__serialize方法变更等大概率不处理 - 若它被
replaced by指向另一个包,那个包可能也已废弃(比如指向psr/log接口而非具体实现),你只是把问题往后推了一层 -
composer depends vendor/package往往显示它是被laravel/framework或symfony/console间接拉入的——你删它,整个生态链可能崩
更现实的问题是 autoload:废弃包的命名空间、类路径、PSR-4 映射可能和新包完全不兼容,use Monolog\Logger 换成 use PhpMonolog\Logger 不是全局替换就能解决的,构造函数参数、上下文格式、处理器链顺序都可能变。
如果非用不可(比如 legacy 系统迁移卡点),至少做三件事
- 锁死版本:在
composer.json中写死"monolog/monolog": "1.25.5",禁用^和~,避免下次update自动跳进未知分支 - 补充注释:在
require行上方加// ABANDONED: no security updates after 2023-06, see <a href="https://www.php.cn/link/6daab15a4f57549b7f236d7f0cfca3c8">https://www.php.cn/link/6daab15a4f57549b7f236d7f0cfca3c8</a>,让接手人一眼看清风险 - 隔离调用:用适配器封装所有对该包的调用,定义 interface,后续替换时只需重写实现,不碰业务逻辑
真正的归档扩展(archive extension)并不存在于 Composer 生态——所谓“归档”,只是作者停止维护后留在 Packagist 上的只读快照。它不会消失,但也不会进化。你 require 的不是功能,是技术债务的起始凭证。

















