在 Composer中加载非PSR-4旧代码库最常用方式是classmap自动加载机制，通过扫描指定路径下的PHP文件生成类、接口、trait及全局函数的映射关系，并需执行composer dump-autoload更新autoload.php。
在 Composer 中加载非 PSR-4 规范的旧代码库，最常用且可靠的方式是使用 classmap 自动加载机制。它不依赖命名空间或目录结构，而是通过扫描指定路径下的 PHP 文件，提取其中定义的类、接口和 trait，生成映射关系供自动加载器使用。
配置 classmap 加载路径
在项目的 composer.json 中，将旧代码所在的目录（或具体文件）添加到 "autoload": {"classmap": [...]} 数组里：
- 可以是目录（如
"lib/"），Composer 会递归扫描所有.php文件 - 也可以是单个文件（如
"legacy/functions.php"），适合全局函数或定义杂乱的旧脚本 - 路径相对于
composer.json所在位置
示例：
{
"autoload": {
"classmap": [
"lib/",
"legacy/core.php",
"includes/old-utils.php"
]
}
}
重新生成自动加载文件
修改 composer.json 后必须执行以下命令，让 Composer 重新扫描并写入 vendor/autoload.php 的映射表：
-
composer dump-autoload—— 快速重建（推荐日常使用） -
composer install或composer update—— 也会触发 dump，但开销更大
注意：仅靠 require 'vendor/autoload.php' 不会自动识别新 classmap，必须先 dump。
处理无命名空间的类和全局函数
classmap 能正确加载传统写法的类（如 class Database { ... }），也支持全局函数（只要它们定义在被扫描的 PHP 文件中）。Composer 会在 autoloader 中注册这些符号，无需额外 require_once。
- 如果旧代码用
__autoload()或手动include，建议移除，避免冲突 - 若函数名重复或存在条件加载逻辑，需人工检查是否真能被安全调用
验证是否生效
最直接的方法是尝试实例化一个旧类或调用一个旧函数，看是否报 Class not found 或 Call to undefined function：
- 运行
composer dump-autoload -o（带优化选项）可生成更紧凑的映射，同时也能快速暴露路径错误 - 查看
vendor/composer/autoload_classmap.php，确认你的类名已出现在数组中 - 对含中文路径、特殊字符或符号链接的目录，确保 Composer 有读取权限
基本上就这些。classmap 不复杂但容易忽略 dump 步骤，配好路径后记得重生成 autoload 就行。
