PSR-4自动加载需在composer.json的autoload中显式声明,键为带尾部反斜杠的命名空间前缀(如”App\\”: “src/”),值为项目根目录下的相对路径;配置后须运行composer dump-autoload生效,且文件名、命名空间、目录结构三者必须严格一致。
PSR-4 自动加载配置写在 composer.json 的 autoload 里
Composer 不会自动识别目录结构来推断命名空间,必须显式声明。核心是 "autoload": { "psr-4": { ... } } 这一段,键是命名空间前缀(含末尾反斜杠),值是相对于项目根目录的源码路径。
常见错误:漏掉命名空间末尾的 \,比如写成 "App": "src/" 而不是 "App\\": "src/" —— 这会导致 App\Http\Controller 类无法被找到,因为 Composer 会尝试加载 src/Http/Controller.php,但实际期望的是 src/Http/Controller.php 对应 App\Http\Controller,而前缀不带 \ 时匹配逻辑会错位。
-
"App\\": "src/"→ 正确:类App\Http\Controller映射到src/Http/Controller.php -
"App": "src/"→ 错误:可能匹配到src/App/Http/Controller.php,且与 PSR-4 规范不符 - 路径值不支持通配符或相对上层路径(如
"../lib/"),必须是项目根下的有效子路径 - 修改后必须运行
composer dump-autoload(或composer install/update)才能生效
多个命名空间怎么共存?用数组键值对逐条声明
一个项目常有主代码、测试、可选模块等不同命名空间,全部平级写在 psr-4 对象中即可,Composer 会按顺序尝试匹配(但实际是哈希查找,顺序无关)。关键是路径不能重叠,否则可能引发意外交互。
例如 Laravel 风格结构: