Composer怎么混合使用加载标准_Composer PSR-0与PSR-4混用方法

Composer怎么混合使用加载标准_Composer PSR-0与PSR-4混用方法

想在同一个 autoload 配置块里同时使用 PSR-0 和 PSR-4？这事儿行不通。Composer 可不是在跟你玩什么配置技巧，这是它明确禁止的行为。你就算写进去了，它也会默默地忽略掉 PSR-0 的部分，只让 PSR-4 生效，运气不好的话，可能还会收到一个弃用警告。

为什么 psr-0 和 psr-4 不能共存于同一 autoload 块

根本原因在于，Composer 在处理 autoload 配置时，对 PSR-0 和 PSR-4 采用的是互斥逻辑。一旦它检测到配置文件里存在 psr-4 这个键，那么整个 psr-0 配置块就会被直接跳过。这可不是什么程序漏洞，而是 PHP-FIG 和 Composer 开发团队为了消除规则歧义，特意设定的强制约束。

• PSR-0 标准早在 2014 年就被正式标记为“弃用”了。从 Composer 2.0 版本开始，它仅仅是为了兼容老项目而保留的解析逻辑，并不参与实际的自动加载流程。
• 退一步讲，就算你手动保留了类似 "psr-0": { "Legacy\": "src/legacy/" } 这样的配置，只要 psr-4 同时存在，这行配置就等于完全没写。
• 错误现象非常典型：类文件明明就躺在 src/legacy/Legacy/Class.php 这个路径下，但当你尝试 new LegacyClass() 时，却会收到一个冷冰冰的 Class not found 错误。为什么呢？因为 PSR-4 规则已经抢先一步接管了查找工作，它会尝试去 src/Legacy/Class.php 这个位置（基于前缀匹配逻辑）寻找文件，而那里自然是空空如也。

如何让旧 PSR-0 类和新 PSR-4 类共存

共存的关键，不在于“混合配置”，而在于“物理隔离”。必须用不同的自动加载类型来承载新旧两套逻辑。核心思路其实很清晰：让 PSR-4 专心管理新的、符合现代标准的代码；至于那些遗留的、结构特殊的旧代码，则交给 classmap 或 files 来处理。

• 首先，把所有遵循 PSR-0 风格的老旧类（比如类名里还带着下划线的，或者目录嵌套不符合 PSR-4 标准的）集中到一个独立的目录里，例如就叫 legacy/。
• 接着，在 composer.json 中，使用 classmap 来加载这个目录："classmap": ["legacy/"]。这种方式会直接扫描目录生成一个静态的类名到文件路径的映射表，完全不依赖命名空间到目录的转换规则。
• 如果遗留代码里只有少数几个全局函数或者工具类，用 files 加载更直接："files": ["legacy/helpers.php"]，这会在每次请求时都直接引入指定的文件。
• 这里有个绝对要避免的坑：千万不要把同一个命名空间前缀，比如 "Legacy\"，同时配置在 psr-0 和 psr-4 下面——哪怕你指向的路径完全不同。只要命名空间前缀一致，PSR-4 规则就会强势地接管所有该前缀下的类查找。

psr-4 多命名空间配置时的常见翻车点

你以为配置了多个 PSR-4 命名空间就能高枕无忧了？实际加载行为远比想象中微妙，它取决于前缀的长度和路径拼接的逻辑，稍不留神就会“找错门”。

• 像 "App": "src/" 和 "App\Controller": "old-controllers/" 这样的配置共存是危险的。对于类 App\Controller\Foo，Composer 可能会用前者规则去 src/Controller/Foo.php 找，也可能用后者规则去 old-controllers/Foo.php 找。最终结果取决于你的 src/ 目录下是否真的存在一个 Controller/ 子目录。
• 正确的做法是确保命名空间前缀之间互斥，没有包含关系。比如改成 "OldApp\": "old-controllers/"，这样就和 App\ 彻底划清了界限。
• 路径配置的结尾必须带上斜杠：写成 "src/" 才是对的，写成 "src" 在旧版 Composer 里会警告，新版里可能直接导致配置失效。
• 修改完 composer.json 后，别忘了运行 composer dump-autoload -o 这个命令。如果不执行，vendor/autoload.php 文件就不会更新，你之前所有的配置调整都等于白费功夫。

最后，还有一个极易被忽略的细节，那就是 classmap 的优先级问题。虽然 classmap 的查找顺序排在 PSR-4 之后，但它一旦匹配成功，就会立即加载，不会再有回退机制。这意味着，只有当 PSR-4 规则找不到目标类时，classmap 才有机会上场。所以，把遗留类放在 classmap 里，确实不会干扰新的 PSR-4 逻辑；但反过来，如果你不小心把新的、本该由 PSR-4 管理的类也塞进了 classmap，反而会绕开 PSR-4 的路径校验，给未来的代码维护埋下隐患。