Composer什么时候配置自动加载_Composer类库引入教学【方法】-composer-PHP中文网

改完 composer.json 的 autoload 字段后必须运行 composer dump-autoload，否则自动加载不生效；psr-4 路径与命名空间、目录结构须严格一致，大小写敏感，classmap 适合老代码但需手动重 dump，files 仅用于函数/常量。

composer什么时候配置自动加载_composer类库引入教学【方法】

改完 composer.json 的 autoload 字段后，不运行 composer dump-autoload，自动加载永远不会生效——这是 90% “Class not found” 报错的真正原因。

psr-4 映射写错一个字符就完全失效

PSR-4 不是模糊匹配，它对格式极其敏感：

"App\": "src/" 是合法的；"App": "src/"（缺反斜杠）或 "App\": "src"（路径末尾缺斜杠）都会静默失败
命名空间声明必须严格对应目录结构：类 App\Http\Controller\Home 必须在 src/Http/Controller/Home.php，不能是 src/app/Http/... 或 src/http/...
Linux/macOS 下大小写敏感：src/Services/ ≠ src/services/，文件名 User.php 里定义 class user 也找不到
路径是相对于 composer.json 所在目录的，不是项目根目录、也不是 vendor/ 目录

classmap 适合老代码，但新增类必须重 dump

当你有一批无命名空间、类名与文件名不一致、或散落在多个非标准目录的老代码时，classmap 是最务实的选择：

Discussion Composer

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

下载

配置示例："classmap": ["legacy/", "lib/Database.class.php"]，Composer 会扫描并提取所有 class 和 interface 声明
它不校验命名空间或文件名规则，只认物理路径下的 .php 文件
新增一个 legacy/Helper.php 后，必须手动执行 composer dump-autoload，否则这个类永远“看不见”
避免写 "classmap": ["."] —— 会把 vendor/、tests/ 全扫进去，映射表膨胀、加载变慢，甚至引发同名类冲突

files 只能放函数/常量，千万别塞类

files 不是类加载器，而是每次请求时无条件 require_once 的静态包含机制：

适用场景：全局辅助函数、define() 常量、环境初始化逻辑，如 "src/functions.php"、"config/constants.php"
绝对不要把 UserService.php 这类含 class 定义的文件放进 files 数组，否则直接报 Fatal error: Cannot declare class UserService
路径必须是相对于 composer.json 的完整路径，"functions.php"（缺目录）会报错
多个 files 的加载顺序由 Composer 内部决定，不可控；有依赖关系时建议改用 classmap 或封装成类

autoload-dev 是测试类的专属通道

测试类（如 Tests\Unit\UserTest）不该混进主自动加载逻辑：

正确做法是在 composer.json 中单独配置："autoload-dev": { "psr-4": { "Tests\": "tests/" } }
这样 composer install --no-dev 时，Tests\ 命名空间根本不会写入生产环境的 vendor/autoload.php
如果图省事把 "tests/" 加进主 autoload，CI 流水线或线上日志里可能意外触发测试类初始化，带来安全隐患
PHPUnit 默认读取 autoload-dev，所以测试类路径配错也会直接报 Class not found