必须放在入口文件最顶部，因为vendor/autoload.php通过spl_autoload_register()注册加载器，若new或use类在它之前执行，将因无handler而直接报class not found。

为什么 require_once 'vendor/autoload.php' 必须放在入口文件最顶部

因为 vendor/autoload.php 的核心作用是调用 spl_autoload_register() 注册加载器链，而不是直接定义类。一旦 PHP 解析到 new SomeClass() 或 use SomeNamespace，就会触发 autoload 队列——如果此时还没注册任何 handler，就直接报 Fatal error: Class 'XXX' not found。

常见错误现象：

• 入口里先 new AppController()，再 require vendor/autoload.php → 必定失败
• 框架启动逻辑（如 CI3 的 CodeIgniter.php）在 autoload 加载前就尝试实例化类 → 报错但难以定位
• CLI 脚本漏加这行，却在某些测试中“碰巧”成功（因前序命令已加载过该类）→ 具有迷惑性

实操建议：

• 只在真实入口文件（index.php、api.php、cli.php）顶部第一行写 require_once __DIR__ . '/vendor/autoload.php';
• 不要包在 if、函数体或 try/catch 里——PHP 解析阶段就可能触发类加载
• 别用 include 替代 require_once：失败时不报错，问题更隐蔽

如何让无命名空间的老类和 Composer 包共存

老代码通常没命名空间、类名含下划线（如 User_Model）、文件路径不匹配 PSR-4 规则——硬改代码成本高，应优先用 classmap 和 files 适配。

实操建议：

• classmap 适合扫描整个目录下所有 .php 文件并建立类名→路径映射，例如："classmap": ["models/", "lib/", "legacy/Database.class.php"]；路径必须相对于 composer.json 所在目录，且结尾带斜杠
• files 只用于纯函数/常量文件，如 "src/functions.php" 或 "config/constants.php"；不能放类定义，否则会报 Fatal error: Cannot declare class
• 避免混用 psr-4 和 classmap 指向同一目录，否则可能覆盖或重复加载
• 若老类已有非标准命名空间（如 namespace appmodel;），可在 psr-4 中加一条映射："app\model\": "models/"，比全切到 classmap 更轻量

PSR-4 配置写错一个字符就失效的典型场景

psr-4 对格式极其敏感：命名空间结尾必须带反斜杠、路径结尾必须带斜杠、大小写严格一致。Linux 下文件系统区分大小写，UserController.php 里定义 class usercontroller 就永远找不到。

Discussion Composer

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

下载

常见错误配置：

• "App": "src/" 是合法的；"App": "src"（缺斜杠）或 "App": "src/"（多空格）都会静默失效
• 类 AppControllerHome 对应路径是 src/Controller/Home.php，不是 src/App/Controller/Home.php
• 路径是相对于 composer.json 所在目录的，不是项目根目录也不是 vendor/

验证方法：

• 运行 composer dump-autoload 后，检查 vendor/composer/autoload_psr4.php 是否生成了对应映射
• 确认类文件名与类名完全一致（Home.php → class Home）
• 用 php -a 手动测试：require 'vendor/autoload.php'; new AppControllerHome();

修改 autoload 配置后为什么必须跑 composer dump-autoload

composer dump-autoload 不是“刷新缓存”，而是重建整个自动加载索引。它读取 composer.json 中的 autoload 配置，生成 vendor/composer/autoload_*.php 映射文件，并更新 vendor/autoload.php 的引导逻辑。

漏跑会导致：

• 新写的 AppHelperLogger 死活不加载
• 老 files 里的函数突然“找不到”
• classmap 目录移动后仍加载旧路径下的类

实操建议：

• 每次修改 composer.json 的 autoload 段后，立刻执行 composer dump-autoload
• 开发调试阶段不用 -o（optimize），避免掩盖路径映射问题
• 上线前清理 opcache（opcache_reset() 或重启 PHP-FPM），否则可能加载旧映射

真正容易被忽略的是：改了 composer.json 却忘了跑命令，或者跑了但没清 opcache——这两步缺一不可，否则你看到的永远是旧行为。