如何将废弃的Composer包替换成可用的替代品？

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

Composer 不会自动替换废弃包，只会报 warning；你必须手动更新依赖，否则可能会遇到 Class not found 或方法签名不兼容的问题。

怎么确认废弃包有没有靠谱替代项

Composer 提示里的 Use xxx instead 只是同步了 Packagist 页面上维护者填的 replaced by 字段——这个字段可能为空、过时，甚至指向 psr/log 这类接口而非具体实现。

• 运行 composer show vendor/package-name，看输出里是否有 replaced by: 行；若只有 abandoned: true，说明没指定替代项
• 打开 https://www.php.cn/link/84ff7015cca989303244d13f1a8146fd，查右上角「Replaced by」字段——这才是唯一权威来源
• 若该字段为空，去 GitHub 仓库翻 README.md 开头或 UPGRADE.md，别在 Issues 里猜
• 注意 PHP 版本兼容性：比如 symfony/polyfill-php81 替代某些废弃适配器，但你项目还在 PHP 7.4 就不能直接切

直接依赖 vs 子依赖，替换操作完全不同

硬删一个被上游包依赖的废弃包，Composer 会卡在依赖解析阶段，不是报错就是回退到旧版本。