只能在真实入口文件第一行引入vendor/autoload.php；老类用classmap映射，全局函数/常量用files加载；修改后必须执行composer dump-autoload并清理OPcache。
直接在旧系统里引入 vendor/autoload.php 是可行的，但必须控制加载时机、隔离老加载逻辑、并用 classmap 或 files 覆盖真实类路径——否则 90% 的 Class not found 和 Cannot redeclare class 都源于加载顺序或映射错位。
为什么不能在 config.php 或函数库文件里 require autoload.php
入口之外的任何地方 require vendor/autoload.php 都可能引发作用域污染或重复加载：config.php 里常有 define()、global $db 等语句，一旦 autoload 提前触发类加载（比如某个类的 static init），就可能因依赖未初始化而 fatal；更常见的是老代码自己定义了 __autoload() 或 spl_autoload_register()，和 Composer 的加载器冲突，导致类加载跳过或报错。
实操建议：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 只在真实入口文件（
index.php、api.php、CLI 脚本）第一行加require __DIR__ . '/vendor/autoload.php'; - 检查老代码是否已有
__autoload()，有则用spl_autoload_unregister('__autoload');显式卸载 - 绝对不要在
config.php、functions.php、bootstrap.php这类被多处 include 的文件中引入 autoload
如何让无命名空间的老类（如 class User_model {}）被 Composer 加载
PSR-4 强制要求文件名与类名一致、路径匹配命名空间，对老项目基本不可行。硬套只会让 composer dump-autoload 扫不到类，最终还是 Class not found。
实操建议：
- 用
"classmap"字段，例如："autoload": { "classmap": ["models/", "libraries/", "includes/"] } - 路径是相对于
composer.json的，别加./前缀（Composer 会忽略） - 执行
composer dump-autoload -o生成优化后的静态映射表，比每次扫描快得多 - 迁移后必须删掉所有
require_once 'models/User_model.php'类语句，否则运行时可能报Cannot redeclare class
全局函数和常量文件怎么接入 autoload
老项目常靠 require_once 'helpers.php' 引入一堆函数，这类文件不能走 classmap（没 class），也不能塞进 PSR-4（不是类）。强行改写为类会破坏调用方，成本高且不必要。
实操建议：
- 用
"files"类型，例如："autoload": { "files": ["helpers.php", "constants.php", "lib/functions.php"] } - 这些文件会在每次请求时自动
require，所以只放真正“全局必需”的函数/常量，避免拖慢性能 - 确保它们不重复定义函数（比如多个 helpers.php 互相 include），否则
Cannot redeclare function - 改完必须跑
composer dump-autoload，否则不会生效
classmap 和 files 混用时最容易踩的坑
一个目录既写进 classmap 又被 files 包含，或者多个 classmap 条目指向同一子目录，会导致映射覆盖、类加载失败或函数重复加载。Composer 不校验这种重叠，出问题只能靠手动排查。
实操建议：
-
classmap和files必须职责分离：类走classmap，函数/常量走files - 避免
"classmap": ["src/", "src/Utils/"]这种嵌套写法，后者会被前者覆盖 - 如果老项目有带下划线的类名（如
User_Model），别试图用 PSR-4 映射，classmap是唯一稳定方案 - 每次修改 autoload 配置后，务必清理 OPcache（
opcache_reset()或重启 PHP-FPM），否则旧映射仍生效
最易被忽略的是：classmap 扫描是一次性行为，它不会监听文件增删。你新增了一个 models/NewFeature.php，不跑 composer dump-autoload，这个类永远进不了自动加载表——这点和 PSR-4 的“按需加载”完全不同，得记牢。
