composer autoload机制不兼容旧代码时，应分层接管：用files加载旧系统初始化逻辑，classmap显式映射旧类路径，避免psr-4强行重构，明确vendor与legacy边界，禁用include_path干扰，并严格验证加载链。
Composer autoload 机制不兼容旧代码怎么办
直接启用 composer.json 的 autoload 会破坏原有全局函数/类的加载顺序，尤其当旧系统依赖 require_once 手动加载或 __autoload() 时，PHP 会报 Class not found 或重复定义错误。
解决思路不是“全盘替换”，而是分层接管：先让 Composer 管理新增模块，旧代码继续走原路径，靠 files 类型 autoload 做胶水层。
- 在
composer.json中用"autoload": { "files": ["legacy/bootstrap.php"] }引入旧系统的初始化逻辑（如注册spl_autoload_register回调） - 避免在
files中执行业务代码，只做注册、常量定义、函数声明等无副作用操作 - 旧类文件路径若与 PSR-4 不符，不要强行改命名空间——用
classmap显式映射："classmap": ["lib/Helper.php", "old/models/"]
如何让 legacy 目录和 vendor 目录共存且互不干扰
旧系统往往把所有代码放在 ./app 或 ./includes 下，而 Composer 默认从 vendor/ 加载依赖。冲突点常出现在自动加载优先级和 include_path 设置上。
关键不是“隔离”，而是“明确边界”：让 Composer 只负责它该管的部分，其余由开发者显式控制。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer dump-autoload --optimize后，检查生成的vendor/composer/autoload_classmap.php是否意外包含了旧目录下的文件（如有，说明classmap配置范围过宽） - 禁用默认的
include_path修改行为：在composer.json中加"config": { "autoloader-suffix": "LegacyAutoloader" }，避免覆盖已有环境变量 - 旧代码中调用新模块时，统一用
use Vendor\Package\ClassName;，而非相对路径require—— 这是模块边界的第一个信号
拆分过程中遇到 “Trait not found” 或 “Interface mismatch” 怎么办
旧系统里大量使用继承和全局 trait，而新模块按 PSR-4 组织后，use 路径和命名空间稍有偏差就会触发致命错误，且 PHP 不会提示“你可能少写了 namespace”，只报找不到。
这类问题本质是命名空间断层，不是语法错，调试要跳过 IDE 自动补全干扰，直查加载链。
- 运行
composer show -p确认目标包是否已安装且路径正确；再用grep -r "trait YourTraitName" vendor/验证是否存在并检查其namespace - trait 文件必须声明
namespace，且不能和类同名（例如App\Utils\Logger是类，就不能有同名trait Logger，否则 autoload 会混淆） - 若旧代码中
use SomeTrait没写完整 namespace，立刻补全为use App\Traits\SomeTrait;—— 不要依赖use前的namespace上下文，因为旧文件可能没声明 namespace
上线前必须验证的三个加载边界点
平滑过渡最怕“本地跑得通，线上报错”，根源常是 autoloader 缓存、OPcache 或文件权限导致的加载差异。
- 清空 OPcache：部署后执行
opcache_reset()或重启 PHP-FPM，否则旧的 autoload map 仍被缓存 - 检查
vendor/autoload.php是否被多次require—— 尤其在旧入口文件里，重复引入会导致Cannot redeclare class - 用
get_declared_classes()在关键位置 dump 一次，确认新模块类已加载、旧类未被 autoload 机制意外接管（比如 classmap 错误扫到了 config 目录）
过渡期越长，越容易忽略这些边界点——它们不报错，但会让某次热更新后某个功能突然失效，而且难以复现。
