通过配置classmap和files实现Composer对非PSR代码的自动加载：1. 使用classmap扫描legacy目录下的类、接口、trait并生成路径映射；2. 通过files引入全局函数或配置文件如helpers.php、config.php；3. 可与PSR-4共存，支持新旧代码混合加载；4. 新增文件后需执行composer dump-autoload更新映射。
要让 Composer 自动加载不符合 PSR 规范的旧版 PHP 代码，关键是通过配置 classmap 或 files 加载方式，而不是依赖 PSR-4 或 PSR-0 的命名空间映射规则。
使用 classmap 扫描类文件
对于没有遵循 PSR 命名规范、类名与文件路径不匹配的老代码，Composer 提供了 classmap 机制。它会扫描指定目录下的所有 PHP 文件，生成一个包含所有类及其对应文件路径的映射表。
{
"autoload": {
"classmap": ["legacy/"]
}
}
执行 composer dump-autoload 后，Composer 会遍历 legacy 目录中的每个 PHP 文件，解析出其中定义的类、接口或 trait，并记录它们所在的文件路径。之后调用这些类时就能自动加载。
立即学习“PHP免费学习笔记（深入）”；
适用场景包括：
- 传统 MVC 结构中类名与文件名不一致
- 使用全局函数或 define 定义的旧模块
- 无命名空间的老项目
使用 files 加载函数库或初始化脚本
如果旧代码包含大量全局函数、常量定义或需立即执行的逻辑（如配置加载），可使用 files 方式确保这些文件在每次请求时被包含。
{
"autoload": {
"classmap": ["legacy/"],
"files": ["legacy/helpers.php", "legacy/config.php"]
}
}
这样，helpers.php 中的函数和 config.php 中的配置会在 Composer 自动加载启动时就被载入，无需手动 require。
混合加载策略的实际应用
大型遗留系统往往需要组合多种加载方式。例如：
- 核心业务类放在 legacy/classes/ 下，用 classmap 扫描
- 工具函数写在 legacy/functions/ 中，通过 files 显式引入
- 部分新模块采用 PSR-4 规范，可并行配置
{
"autoload": {
"psr-4": { "App\\": "src/" },
"classmap": ["legacy/classes/"],
"files": ["legacy/functions/helpers.php"]
}
}
这种混合模式允许新旧代码共存，逐步迁移。
基本上就这些。只要把非 PSR 代码交给 classmap 处理，配合 files 引入全局逻辑，Composer 就能顺利加载老项目。不复杂但容易忽略的是：每次新增类文件后必须重新运行 dump-autoload，否则 classmap 不会更新。
