Composer 默认不支持自动加载旧版PHP类库，需通过classmap（扫描生成静态映射）或files（强制预加载）显式声明；二者均需在composer.json中配置并执行dump-autoload。
Composer 本身不支持直接自动加载旧版 PHP 类库（如无命名空间、非 PSR-0/PSR-4 规范的代码），但可以通过 classmap 或 files 两种方式手动接入——关键不是“自动发现”，而是“显式声明”。
为什么 autoload 默认不生效
Composer 的 autoload 配置默认只处理符合 PSR-4、PSR-0、classmap 或 files 规则的路径。老项目常见情况：类文件名与类名不一致（如 Database.php 里定义 class DB）、没有 namespace、甚至一个文件定义多个类——这些都会让 PSR 自动加载失败。
- PSR-4 加载器会按命名空间 + 类名拼路径，找不到就静默跳过，不会报错
- 如果
composer.json里只写了"psr-4": {"App\": "src/"}，而旧类在lib/old/下且无命名空间，那它们根本不会被扫描 - 运行
composer dump-autoload后检查生成的vendor/composer/autoload_classmap.php，能直观看到哪些类被收录了
用 classmap 扫描并固化类名到文件映射
适合类名和文件名有规律（比如都以 .class.php 结尾）、但无命名空间的老代码。Composer 会递归扫描指定目录，用 token_get_all() 解析 class 声明，生成静态映射表。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在
composer.json的autoload段添加："autoload": { "classmap": ["lib/old/", "includes/"] } - 运行
composer dump-autoload -o（加-o生成优化后的 classmap，更快） - 注意：
classmap是一次性快照，新增类后必须重新执行dump-autoload，否则加载不到 - 如果类定义在条件语句里（如
if (DEBUG) { class LegacyUtil {} }），classmap可能漏掉——此时改用files
用 files 强制每次加载固定文件
适合无法保证类定义顺序、或依赖全局函数/常量、或类定义嵌套在逻辑块中的场景。Composer 会在每次请求时 require_once 列出的每个文件，不解析内容，也不做任何假设。
- 在
composer.json中写："autoload": { "files": ["lib/old/functions.php", "lib/old/DB.class.php"] } - 文件路径是相对于
composer.json的，不要用../跨出项目根目录 - 顺序很重要：如果
DB.class.php依赖functions.php里的工具函数，functions.php必须排在前面 -
files方式无性能损耗（PHP OPcache 会缓存），但会增加启动时的 I/O 开销；不适合放几百个文件
真正容易被忽略的是：旧类库可能依赖 __autoload 或自定义 spl_autoload_register 回调。一旦启用 Composer 自动加载，这些旧机制通常会被覆盖或绕过——得检查是否要保留原回调，或把它们迁移到 files 中统一管理。
