classmap是唯一能加载无命名空间、类名与文件名不一致或定义在.inc文件中的老代码的方案，它仅扫描class/interface/trait后的标识符，路径需相对composer.json，支持*通配符（≥2.2），语法错误文件会被静默跳过。

classmap 怎么加载无命名空间的老代码

classmap 是唯一能加载没 namespace、类名和文件名不一致、甚至定义在 .inc 文件里的老代码的方案。它不看命名空间，只扫描 PHP 文件里 class、interface、trait 关键字后的标识符。

• 路径必须写相对 composer.json 的真实路径，比如 "legacy/"（末尾带 / 表示递归扫描）或 "lib/Database.inc"
• 支持 * 通配符（Composer ≥ 2.2），如 "legacy/DB_*.php"，但不支持 ** 或正则
• 文件里有语法错误（比如少个分号），classmap 会静默跳过该文件，不会报错，也不会进 vendor/composer/autoload_classmap.php
• Linux 下大小写敏感：文件叫 User.php，里面定义 class user，调用 new User() 就会报 Class not found

files 不是用来加载类的，别往里塞 UserService.php

files 的作用是每次 autoloader 初始化时，无条件 require_once 指定文件——它不管有没有类，也不参与类查找流程。把它当类加载器用，等于直接触发 Fatal error: Cannot declare class UserService。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 只适合放纯函数、常量、配置初始化逻辑，比如 "src/helpers.php"、"config/bootstrap.php"
• 路径同样相对于 composer.json，不支持 __DIR__ 或动态变量
• Web 和 CLI 环境都生效，但如果入口没引入 vendor/autoload.php，或者 opcache 没刷新，函数就不可见
• 两个 files 都定义了 str_slug()？PHP 直接报 Cannot redeclare，没法绕开

PSR-4 和 classmap 混用时，谁“赢”了

加载顺序固定：psr-4 → psr-0 → classmap → files。一旦前面匹配成功，后面全跳过。这不是优先级可调的问题，是硬编码的执行链。

• 哪怕你把 "src/" 加进 classmap，只要 "App\" → "src/" 在 psr-4 里配着，src/User.php 里的 class User 就永远走 PSR-4，classmap 白扫
• 想让 classmap 生效，得确保路径不重叠：比如老代码全扔进 legacy/，然后只在 classmap 里写 "legacy/"，别碰 src/ 或 lib/
• 重复类名（两个文件都定义 class Config）？后扫描到的覆盖前一个，顺序取决于文件系统遍历结果，不可控

改完 autoload 一定要跑 composer dump-autoload

classmap 和 files 都不是热加载机制。配置写对了，不执行这条命令，vendor/composer/autoload_classmap.php 和 autoloader 初始化行为就不会更新。

• 别信终端输出的 “Generating autoload files”，打开 vendor/composer/autoload_classmap.php 搜索你的类名，确认键值对存在才是真生效
• 开发阶段频繁增删类文件，就得养成习惯：改完 composer.json → composer dump-autoload → 验证
• CI/CD 流水线里漏掉这步，线上环境就只能看到 Class not found，且查不到配置问题在哪

classmap 和 files 看似简单，真正卡住人的从来不是怎么写，而是路径是否真实存在、是否被 PSR-4 截胡、以及改完忘跑 dump-autoload —— 这三处出错，90% 的“加载失败”就定了。