Composer自动加载器默认支持PSR-4、PSR-0（废弃）、classmap和files四种方式；旧代码可通过classmap扫描任意类文件或files直接引入函数/定义文件实现兼容，优先级为psr-4→psr-0→classmap→files。
Composer 的自动加载器默认只支持 PSR-4、PSR-0（已废弃）、classmap 和 files 四种方式。若你手上有非 PSR-4 规范的旧代码库（比如类名与文件路径不匹配、无命名空间、或命名空间与目录结构错位），可通过 classmap 或 files 加载方式绕过命名规则限制，实现兼容。
用 classmap 扫描并注册任意类文件
classmap 不依赖命名空间或文件路径映射，而是直接扫描指定目录下的所有 PHP 文件，提取其中声明的类名并生成静态映射表。适合有大量传统类（如 class User {}）但无统一命名空间的项目。
操作步骤：
- 在
composer.json的"autoload"段中添加"classmap"字段，指向旧代码所在目录或具体文件 - 例如：
"autoload": { "classmap": ["legacy/", "lib/Utils.php"] } - 运行
composer dump-autoload，Composer 会解析这些文件中的class声明并写入vendor/composer/autoload_classmap.php - 之后只要类名正确，就能被自动加载，无需改源码
用 files 加载全局函数或定义型文件
如果旧代码包含大量无类的函数文件（如 functions.php、config.inc）、常量定义或静态初始化逻辑，files 方式会在 Composer 自动加载器初始化时无条件一次性载入这些文件。
适用场景和写法：
- 在
composer.json中配置："autoload": { "files": ["legacy/helpers.php", "legacy/constants.php"] } - 这些文件会在
require 'vendor/autoload.php'时立即执行，适合迁移期保留原有函数调用习惯 - 注意：files 不做任何解析，仅 require；重复加载会导致 fatal error，确保文件内无重复定义
混合使用 + 注意 autoloader 优先级
Composer 按照 psr-4 → psr-0 → classmap → files 的顺序尝试加载。这意味着：
- 若某个类同时匹配 PSR-4 规则和 classmap 条目，PSR-4 会优先生效（可能加载错误版本）
- 建议为旧代码单独设一个 classmap 目录（如
legacy/），并避免和新 PSR-4 目录重叠 - 可临时禁用 PSR-4 映射来调试：注释掉 autoload.psr-4 段，再运行
dump-autoload看是否走 classmap
不推荐但可行：自定义加载器兜底
当 classmap 也无法覆盖（比如动态类名、__autoload 兼容需求），可在 composer.json 的 "autoload" 中加 "files" 引入一个自定义 loader 脚本，里面注册自己的 spl_autoload_register 回调：
