composer通过请求packagist api检查元数据中的"abandoned"字段识别废弃包，该字段由作者手动设置为true、替代包名或空；镜像缓存可能导致警告延迟，最准验证方式是grep -a1 -b1 '"abandoned"' composer.lock。
Composer install/update 时怎么发现包被废弃了
它不扫描代码，也不查 GitHub 更新时间，而是每次执行 composer install 或 composer update 时，主动向 Packagist API 请求该包的元数据，检查其中 "abandoned" 字段。这个字段由作者在 Packagist 后台手动设置，值可能是：true（彻底废弃）、"guzzlehttp/guzzle"（推荐替代包名），也可能是空字符串。
镜像源（如阿里云、腾讯云）会缓存元数据，导致警告延迟出现或消失。若本地没报但 CI 报了，先切回官方源验证：composer config -g repo.packagist composer https://packagist.org。
composer.lock 文件里每条包记录都可能带 "abandoned": true 或 "abandoned": "new/vendor" ——这是 Composer 解析那一刻写死的快照，不随 vendor 目录变动而更新。最准的查法是：grep -A1 -B1 '"abandoned"' composer.lock。
“Use xxx instead” 提示能信吗
不能直接信。终端那行黄色提示里的 Use xxx instead，只是原封不动抄了 Packagist 页面上作者填的 replaced by 字段，可能过时、模糊（比如只写 "psr/log"），甚至为空。
唯一权威来源是打开 https://packagist.org/packages/vendor/package-name，看右上角「Replaced by」横幅。如果为空，再点进 GitHub 仓库，优先翻 README.md 开头和 UPGRADE.md。
更可靠的本地验证方式是：composer show vendor/package-name，输出中若有 replaced by: 行，才是当前 Composer 解析到的推荐项；若只有 abandoned: true，就得自己评估功能边界和等效替代。
replace 字段不是“替换命令”，别指望它自动删包
replace 只在依赖解析阶段起作用，它不执行任何安装、卸载或文件覆盖操作。你写好 "replace": {"old-vendor/package": "*"}，然后直接 composer install，旧包该在还在——除非它本来就没被显式 require，或者已被其他规则排除。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
必须先手动运行：composer remove old-vendor/package，清掉旧包及其所有传递依赖（比如它带进来的 psr/log）。否则，新旧包共存大概率触发 Fatal error: Cannot declare class X。
光有 replace 不够，还必须配 conflict。例如在新包的 composer.json 中加："conflict": {"old-vendor/package": "*"}。否则 Composer 认为“够用了”，但 PHP 加载器看到两个同名类定义，直接炸。
下游依赖不升级，你的 replace 在 CI 里等于没写。用 composer depends old-vendor/package 查谁还在拖后腿。输出非空，说明有“钉子户”包，必须升级它，或 fork 后改它的 require。
为什么改个包名就报错：命名空间、构造函数、返回值全变了
废弃包的替代者通常不只是换个名字。比如从 guzzlehttp/guzzle:^6 升到 ^7，GuzzleHttp\Client 的构造参数从 array $config 变成 HandlerStack $handler，直接改 composer.json 包名，代码立刻报 Too few arguments。
检查新包的 composer.json 中 autoload 是否覆盖原路径；若新包用 psr-4 映射到 PhpMonolog\ 而不是原来的 Monolog\，就得全局搜 use Monolog\ 并手动改。
确认新包是否声明了 "replaces": {"monolog/monolog": "^2.0"}；有这个字段才可能“无缝”，否则别假设兼容。
跑完 composer dump-autoload -o 后必须执行单元测试，尤其验证日志写入、上下文传递、处理器链行为是否一致。别跳过这步，很多问题只在运行时暴露。
