Composer可通过classmap和files加载旧代码库：classmap扫描目录生成类名到路径映射，适用于无命名空间的老项目；files直接require_once函数文件，适合helpers.php等全局代码；二者可混合使用，并支持dump-autoload -o优化。
Composer 可以通过 classmap 和 files 两种方式加载不符合 PSR-0/PSR-4 规范的旧代码库，无需改写类名或目录结构。
classmap：扫描并生成类名到文件路径的映射
适用于传统命名风格（如 PearStyle_ClassName）、散落在多层目录的类文件，或没有命名空间的老项目。
- 在
composer.json的autoload段中添加"classmap"字段，填入目录或具体文件路径 - 执行
composer dump-autoload，Composer 会递归扫描指定路径下的所有 PHP 文件，提取class、interface、trait声明，生成映射表 - 后续
new OldLib_Foo()或class_exists('Legacy_Builder')都能自动定位并加载对应文件
示例：
"autoload": { "classmap": ["lib/", "src/legacy/Utils.php"] }files：直接加载函数库或全局定义
适合纯函数集合（如 helpers.php）、常量定义、静态配置等无法实例化的代码，这些内容不依赖类名，也无法用 classmap 自动识别。
- 在
autoload中声明"files"数组，列出需每次请求都载入的 PHP 文件 - 这些文件会在 Composer 自动加载器初始化时被
require_once，确保函数、常量、全局变量提前可用 - 注意：
files不做任何解析，也不支持条件加载，慎用于有副作用的脚本
示例：
"autoload": { "files": ["src/functions.php", "config/defines.php"] }混合使用 classmap + files 应对复杂旧项目
一个典型的遗留系统可能同时包含带类的老模块和一堆工具函数。这时可组合配置：
-
classmap覆盖所有类文件所在目录（如includes/、classes/） -
files加载公共函数集（如common.inc.php）和初始化脚本 - 运行
composer dump-autoload -o（优化模式）可合并 classmap 到单个数组，提升生产环境性能
注意事项与调试技巧
- 修改
classmap或files后必须重新运行dump-autoload，否则变更不生效 - 可用
composer show --platform或查看vendor/composer/autoload_classmap.php确认映射是否生成成功 - 若类仍报
Class not found，检查文件中是否真有class XXX声明（不含命名空间也行），且无语法错误阻断扫描 - 避免把大目录（如整个
wp-content/plugins）加进 classmap，会显著拖慢 autoload 生成速度
基本上就这些。不复杂但容易忽略细节，配对好路径再跑一次 dump，老代码就能无缝接入现代工作流了。
