replace仅在依赖解析阶段声明兼容性，不删除文件或替换类；必须手动remove旧包、配conflict防类冲突，并确保新包完整实现原框架的类、facade、命名空间及服务绑定，否则运行时将fatal error。
replace不是“换掉框架”，而是声明“我已内置等效能力”
想用自定义包替代 laravel/framework 或 symfony/http-kernel？别指望 replace 能绕过自动加载和运行时绑定。它只在依赖解析阶段起作用，不删文件、不改类路径、不接管服务容器。你写的 "replace": {"laravel/framework": "^10.0"} 会被 Composer 接受，但 PHP 加载器仍会从 vendor/laravel/framework 里找类——除非你手动删掉它，且确保你的包真正提供了所有被引用的类、Facade、配置键和事件契约。
常见错误现象：Fatal error: Class 'IlluminateSupportFacadesDB' not found，原因是你只写了 replace，却没在自己的包里复制或重实现这些 Facade 类，也没配好 PSR-4 自动加载映射。
- 必须显式
composer remove laravel/framework（哪怕它只是间接依赖） - 你的包的
autoload部分要完整覆盖原框架的命名空间，例如"Illuminate\": "src/Illuminate/" -
replace版本范围不能窄于你实际支持的范围；写"^10.0"却只兼容10.25.0+，下游require了10.10.0就会崩
搭配 conflict 是防止运行时类冲突的硬性前提
光有 replace 相当于给两个同名类发同一张工牌——Composer 认为“够用了”，PHP 却直接报 Fatal error: Cannot declare class X, because the name is already in use。你必须在新包的 composer.json 中加 conflict，且版本要覆盖所有可能被拉进来的旧包实例。
查真实版本用：composer show laravel/framework，然后写类似这样的约束：
"conflict": {
"laravel/framework": "=11.0.0"
}
注意：Composer 1.10+ 才完整校验 replace+conflict 联动；老版本可能静默失败，CI 上尤其危险。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 不要写
"*"—— 它无法阻止某些松散约束（如"laravel/framework": "dev-main"）逃逸 - 如果项目里已有其他包 require
laravel/framework，它们必须升级到声明支持你这个替换包的版本，否则composer install会重新拉下原框架 - 用
composer why laravel/framework找出“钉子户”，逐个处理
provide + replace 组合才是面向契约的替换姿势
单纯 replace 是粗暴覆盖，provide 才是暴露能力契约。比如你要替代一个缓存实现，又希望生态里其他包能通过 "require": {"psr/cache": "^3.0"} 自动识别你的包，就得同时写：
"provide": {
"psr/cache": "^3.0",
"psr/simple-cache": "^3.0"
},
"replace": {
"doctrine/cache": "^1.11",
"symfony/cache-contracts": "^3.0"
}
这样 Composer 先按 replace 移除冲突包，再基于 provide 判断是否满足下游依赖。顺序不能颠倒。
-
provide的版本必须严格匹配规范要求，"psr/cache": "^3.0"和"psr/cache": "3.0.0"效果不同 -
provide不影响自动加载，你仍需自己配好autoload映射 - 框架核心包（如
symfony/http-kernel）极少用provide，因为它的契约太深，几乎没法完整模拟
下游依赖不升级，你的 replace 在 CI 里等于没写
本地跑通不代表线上安全。只要某个已安装的包（比如 spatie/laravel-backup）还在 require laravel/framework，CI 或新机器上执行 composer install 就会重新装进去——因为依赖图里它仍是刚需。
验证方式很简单：执行 composer show --tree | grep laravel/framework，输出非空就说明有“钉子户”。
- 要么推动上游包发布兼容你替换包的新版本
- 要么 fork 它，修改其
composer.json中的require字段，再指向你的私有仓库 - 若长期无响应，
repositories+require强制指定 fork 版本，此时replace只起辅助防冲突作用
最常被忽略的一点：框架替换不是单点操作，它是一条链——从依赖解析、自动加载、服务注册、到运行时调用，任何一环断开，都只会安静地失败在某次请求里，而不是安装时报错。
