Composer如何对比PSR-0和PSR-4_Composer两种加载标准区别【核心】

Composer如何对比PSR-0和PSR-4_Composer两种加载标准区别【核心】

先说一个关键结论：PSR-0 在 Composer 的世界里，已经彻底成为历史了。这可不是什么“不推荐使用”，而是从 Composer 2.0 版本开始，它就完全被移除了。如果你还在 composer.json 里写上 psr-0 字段，Composer 会直接报错退出，连个商量的余地都没有。

为什么 composer dump-autoload 报 [InvalidArgumentException] A non-empty PSR-4 prefix must end with a namespace separator

这个错误，其实跟 PSR-0 没关系，问题出在 PSR-4 的配置上。核心规则就一条：psr-4 配置里的命名空间前缀，必须以反斜杠结尾。而且，由于 JSON 格式的特性，你得写成双反斜杠。

• "App": "src/" ❌ 错误：缺少结尾的反斜杠，这就是触发上述错误的典型写法。
• "App\": "src/" ✅ 正确：JSON 解析后就是 "App"，符合规范。
• "App/": "src/" ❌ 错误：用了正斜杠，但 PHP 的命名空间分隔符是反斜杠。
• 需要警惕的是，如果你的配置文件里同时存在 psr-0 和 psr-4 配置块，Composer 会优先处理 psr-4。但那个旧的 psr-0 块，在 Composer 1.x 会引发弃用警告，到了 2.0+ 就直接报错了。

psr-4 映射路径比 psr-0 少一层目录，这是最常踩的坑

假设你配置了 "App": "src/"，那么自动加载的路径映射会发生根本性变化：

• 在 PSR-4 标准下，类 AppControllersHome 会映射到文件 src/Controllers/Home.php。
• 而在 PSR-0 标准下，同样的配置，AppControllersHome 却会映射到 src/App/Controllers/Home.php——看到了吗？路径里凭空多出了一个 App/ 子目录。
• 这个“冗余嵌套”结构，正是 PSR-0 被淘汰的主要原因之一：它把整个命名空间都塞进了文件路径里。所以，从老项目升级时，千万别只改 composer.json 就完事了，必须同步把类文件从 src/App/... 这样的目录里，移动到 src/... 下。

下划线 _ 在类名里有没有意义，决定自动加载成败

下划线的处理方式，是 PSR-0 和 PSR-4 一个行为级的根本差异，这可不是风格偏好问题。

• PSR-0：它把下划线当作路径分隔符。例如，My_Class_Name 会被解析为 My/Class/Name.php。即便它在 App 命名空间下，最终路径也会是 src/App/My/Class/Name.php。
• PSR-4：它完全无视下划线的特殊含义。对于 My_Class_Name，它只会去寻找 src/My_Class_Name.php 这个文件。这意味着，文件名必须与类名严格一致，包括大小写和下划线。
• 所以，如果你的项目里还有遗留的、类名包含下划线的文件，又不想重命名它们，那就别指望 PSR-4 能自动加载了。这时候，改用 classmap 来扫描生成静态映射，反而是更靠谱的选择。
• 另外，PSR-4 没有回退机制。配置 "App\": "src/" 只匹配以 App 开头的命名空间。它不会因为找不到 AppFooBar，就自作主张地去 src/ 目录下找 Foo.php。

最后提一个容易被忽略的要点：要让 PSR-4 映射生效，必须同时满足三个条件——composer.json 格式正确、配置的路径是相对于项目根目录的合法字符串、并且执行过 composer dump-autoload 命令。少了其中任何一个，当出现 Class not found 错误时，它甚至都不会告诉你具体缺了哪个文件。