composer怎么使用PSR-0规范加载旧版库_传统目录结构的兼容配置【教程】

PSR-0 已被 composer 2.0 移除，旧库需改用 classmap 或适配 PSR-4：classmap 适用于无命名空间或路径不匹配的旧库，直接扫描文件建立硬映射；PSR-4 仅限可修改源码且命名空间匹配的情况，需将下划线转斜杠并声明对应 Namespace。

PSR-0 已被废弃，但旧库仍需加载时怎么办

Composer 从 2.0 起完全移除了对 psr-0 的原生支持，直接写 "psr-0" 配置会报错：Invalid argument supplied for foreach() 或直接忽略。你不是配置错了，而是 Composer 不再处理它了——必须改用 classmap 或适配 PSR-4 的映射方式。

用 classmap 加载传统目录结构（最稳妥）

适用于没有命名空间、或命名空间与路径不匹配的旧库（比如 Zend_Loader、PEAR 风格类名 DB_mysql），classmap 不依赖命名规则，只扫描文件并建立类名 → 文件路径的硬映射，兼容性最强。

• 在 composer.json 的 "autoload" 下添加：

{   "autoload": {     "classmap": [       "library/",       "legacy/Zend/"     ]   } }

• library/ 下若有 My_Utils.php，且含 class My_Utils，就会被自动识别
• 执行 composer dump-autoload 生效（开发中建议加 -o 生成优化后的类映射）
• 注意：classmap 不支持动态类名（如 __autoload 中拼接的类），仅适用于已知静态类定义

强行“模拟” PSR-0 映射（仅限有命名空间 + 路径可推导）

如果旧库用了类似 Vendor_Package_ClassName 命名，且目录结构是 vendor/package/ClassName.php，可用 psr-4 配合自定义前缀替换来逼近 PSR-0 行为：

• 把下划线 _ 替换为目录分隔符，例如 Foo_Bar_Baz → foo/bar/baz.php
• 在 composer.json 中写：

{   "autoload": {     "psr-4": {       "Foo_": "src/foo/"     }   } }

• 要求源码里 class Foo_Bar_Baz 必须声明 namespace Foo;（否则无法匹配）
• 实际文件路径得是 src/foo/Bar/Baz.php，不是 src/foo/Bar_Baz.php —— 这就是和原始 PSR-0 的关键差异
• 若无法改源码，这条路走不通，退回 classmap

常见错误和绕不过去的坑

很多开发者卡在“为什么 psr-0 配置没报错但类还是找不到”，根本原因其实是 autoload 机制已跳过该字段，而 classmap 又没覆盖到实际路径。

• 检查是否漏了 composer dump-autoload —— 修改 autoload 后必须手动刷新映射
• 确认类文件真实路径在 classmap 列表内，且文件内 class 名称与文件名一致（不含命名空间时，类名必须全匹配）
• windows 下路径大小写不敏感，linux/macOS 敏感：MyClass.php 里写 class myclass 就会加载失败
• Composer 2.x 不再解析 autoload-dev 中的 psr-0，同样要转 classmap 或删掉

真正麻烦的不是配置写法，而是旧库本身是否在 PHP 7.4+ 下还能跑通——类名冲突、var 语法、create_function 等问题，往往比 autoloading 更早拦住你。