在 Packagist 上标记包为已弃用并填写迁移说明,使 Composer 安装时输出警告,同时在 README 和代码仓库中添加弃用通知与迁移指南,最后发布最终版本并归档项目,确保用户获知停止维护信息。

要为你的 Composer 包设置弃用消息,最直接的方法是通过 Packagist 平台进行操作。当你决定不再维护某个包或推荐用户迁移到新包时,可以在 Packagist 上标记它为已弃用,并附上说明。
在 Packagist 上标记包为已弃用
登录到 Packagist 官网,进入你想要弃用的包的页面。你会看到一个“DEPRECATE”按钮。点击后可以填写一段简短的消息,说明该包已被弃用,并建议用户使用哪个替代包(如果有的话)。例如,你可以写“此包已停止维护,请使用 vendor/new-package 替代”。一旦提交,这个弃用状态和消息会显示在 Packagist 的包详情页上,并且当其他开发者运行 composer install 或 composer update 时,如果他们的项目依赖了这个被弃用的包,Composer 会在终端中输出警告信息,提醒他们该包已被弃用。
提供迁移路径和更新文档
仅仅在 Packagist 上标记弃用是不够的。你应该在项目的 README 文件顶部添加明显的弃用通知,解释原因并提供详细的迁移指南。如果你有推荐的替代包,确保链接到它的文档。同时,考虑在项目的 GitHub/GitLab 页面的描述或置顶 issue 中也做同样声明。这样能确保无论是通过搜索发现你项目的新人,还是正在维护旧代码的老用户,都能清楚地知道下一步该怎么做。
发布最后一个版本并冻结代码
在完成上述步骤后,可以考虑为你的包发布一个最终版本(例如 1.5.0),在这个版本的 CHANGELOG 中明确写出这是最后一个版本,项目将进入维护模式或完全停止更新。之后,你可以选择将代码仓库设为只读或添加归档(archived)状态,以进一步表明项目不再活跃开发。基本上就这些,关键是在技术平台和项目文档两端同步信息。










