如何在 Composer 中加载非 PSR-4 规范的旧代码库（classmap）？

在 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。

标签： composer classmap php js json ai