在使用 Composer 时，classmap 是一种优化类自动加载性能的方式，尤其适用于不遵循 PSR-4 或 PSR-0 命名规范的老旧代码库或某些特定目录。它通过预先扫描指定目录中的所有 PHP 文件，生成一个“类到文件路径”的映射表（即 classmap），从而避免运行时动态查找类文件，提升加载效率。

什么是 classmap 自动加载？

Composer 支持多种自动加载机制，其中 classmap 是最直接的一种。它会遍历你指定的目录或文件列表，分析其中定义了哪些类、接口或 trait，并将它们记录在一个数组中。这个数组在项目运行时被读取，PHP 就能快速定位类所在的文件，无需解析命名空间或尝试多个路径。

与 PSR-4 相比，classmap 加载更“笨重”但更“全面”，因为它会包含所有类，即使命名不规范也能识别。

如何配置 classmap 提升性能？

要在 composer.json 中启用 classmap，需在 autoload 字段中添加 classmap 配置项：

{
    "autoload": {
        "classmap": [
            "legacy/",
            "src/compat/",
            "lib/mixed-naming.php"
        ]
    }
}

说明：

• legacy/：传统项目目录，类名和文件结构混乱
• src/compat/：兼容性代码，未采用标准命名空间
• lib/mixed-naming.php：单个包含多个类声明的文件

配置完成后，运行命令生成 classmap：

composer dump-autoload --optimize

或简写：

2010.09.03更新优化前台内核处理代码；优化后台内核、静态生成相关代码，生成速度全面提升；修改前台静态模板中所有已知错误；修正后台相关模块所有已知错误；更换后台编辑器，功能更强大；增加系统说明书。免费下载、免费使用、完全无限制。完全免费拥有：应广大用户要求，千博网络全面超值发布企业网站系统个人版程序包：内含Flash动画源码、Access数据库程序包、SQL数据库程序包。全站模块化操作，静态

composer du -o

--optimize 参数会强制重建优化后的自动加载映射，包括生成完整的 classmap 数组并写入 vendor/composer/autoload_classmap.php。

何时使用 classmap 而不是 PSR-4？

尽管 PSR-4 更高效且推荐用于现代项目，但在以下场景中 classmap 更实用：

• 维护老系统，类名如 Database_Helper 并不在对应命名空间下
• 第三方库没有命名空间，但需要纳入自动加载
• 某些文件中定义了多个类（PSR-4 不支持）
• 你需要确保某个目录下所有 PHP 文件都被扫描并注册

注意：classmap 在 安装或更新依赖时不会自动重建，除非你运行 dump-autoload。开发过程中若新增类，应手动执行该命令。

性能对比与建议

PSR-4 使用“按需推算路径”的方式，速度快且内存占用低；而 classmap 需要加载一个较大的数组，占用更多内存，但查找是 O(1) 的数组查询，也很快。

建议：

• 新项目优先使用 PSR-4
• 旧代码整合时用 classmap 单独管理
• 生产环境部署后运行 composer du -o 确保 classmap 生效
• 避免对大量频繁变动的目录使用 classmap，会增加生成耗时