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 更早拦住你。










