Composer自动加载旧版非命名空间类靠classmap生成静态映射表;需在composer.json的autoload下配置"classmap"字段为路径数组,支持目录、文件及glob表达式,执行dump-autoload后映射存于vendor/composer/autoload_classmap.php。

composer自动加载旧版非命名空间类靠什么
靠 classmap 生成静态映射表,不是靠 PSR-0/PSR-4 自动推导路径。旧项目里一堆 require_once 手动引入的 .php 文件,没有命名空间、类名和文件路径不一致(比如 MyDB.php 里定义了 Database 类),这时候只能让 Composer 扫描并记录“这个类在哪个文件”,运行时直接查表加载。
如何配置 composer.json 的 classmap
在 autoload 或 autoload-dev 下加 "classmap" 字段,值为路径数组 —— 支持目录、具体文件、甚至带通配符的 glob 表达式(如 src/*.inc)。
- 目录会被递归扫描所有
.php、.inc、.hh文件 - 文件路径必须存在,否则
composer dump-autoload会报 warning(但不中断) - 不区分大小写匹配类名(Windows/macOS 默认行为),但建议保持文件名与类名大小写一致,避免部署到 Linux 出问题
- 如果同时用了
psr-4和classmap,Composer 会先查 PSR 映射,没命中再查 classmap 表
{
"autoload": {
"classmap": [
"lib/",
"includes/functions.php",
"legacy/DB_*.php"
]
}
}
执行 dump-autoload 后 classmap 存在哪
生成结果在 vendor/composer/autoload_classmap.php,是个返回大数组的 PHP 文件,键是类名(全大写标准化),值是绝对路径:
$vendorDir . '/myproject/lib/MyDB.php',
'ConfigLoader' => $vendorDir . '/myproject/includes/config.php',
'DB_MySQL' => $vendorDir . '/myproject/legacy/DB_MySQL.php'
);
注意:classmap 不支持接口、trait 的自动加载(Composer 5.6+ 开始部分支持 trait,但兼容性差,别依赖);也**不会**解析 class_alias() 或动态定义的类。
常见坑:为什么类还是找不到
最常踩的几个点:
-
composer dump-autoload没重新运行 —— 修改composer.json后必须手动触发,install/update不自动重刷 classmap - 类名拼写错误或大小写不一致,比如文件里是
class mysql_db,但代码中new MySQL_DB(),classmap 记录的是小写键"mysql_db",而 PHP 类名是大小写敏感的,实际加载失败 - 路径配置用了相对路径但不在项目根目录下执行命令,导致扫描不到 —— 始终在
composer.json所在目录执行dump-autoload - 文件里有语法错误(如漏括号、PHP 版本不兼容的语法),Composer 扫描时会跳过该文件且不报错,只在运行时报
Class not found
调试时可临时加一句 var_dump($loader->getClassMap()); 看实际加载了哪些类,确认 key 是否和 new 时写的完全一致。










