Composer autoload自动加载如何配置

Composer通过配置composer.json实现自动加载，1. 推荐使用PSR-4规范将命名空间映射到目录，如"App\": "src/"对应src/Controller/UserController.php；2. classmap用于扫描无命名空间的目录；3. files加载全局函数文件；4. 在入口文件引入vendor/autoload.php即可启用，需注意命名空间反斜杠和大小写问题。

Composer 的自动加载机制能让你无需手动引入类文件，只要遵循 PSR-4 或 PSR-0 规范，就能实现类的自动加载。配置 autoload 主要通过修改项目根目录下的 composer.json 文件来完成。

1. 使用 PSR-4 配置自动加载（推荐）

PSR-4 是目前最常用的自动加载标准，它基于命名空间映射到目录结构。

在 composer.json 中添加 autoload 字段：

{
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}

上面配置表示：
- 所有以 App\ 开头的命名空间类，都会从 src/ 目录下查找。
- 例如：

App\Controller\UserController

对应文件路径为

src/Controller/UserController.php

。

配置完成后，运行以下命令生成自动加载文件：

composer dump-autoload

2. 使用 classmap 手动扫描类文件

如果你的项目没有使用命名空间，或者某些目录不符合 PSR-4 规则，可以用 classmap 方式。

{
    "autoload": {
        "classmap": [
            "legacy/",
            "database/seeds/",
            "scripts/"
        ]
    }
}

Composer 会扫描这些目录中的所有 PHP 文件，生成类名到文件路径的映射表。

每次新增或删除类后，记得执行：

composer dump-autoload

3. 使用 files 加载函数文件或全局脚本

有些工具类函数或配置文件不是类，但需要在项目启动时加载，可以使用 files 选项。

{
    "autoload": {
        "files": [
            "helpers.php",
            "config/constants.php"
        ]
    }
}

这些文件会在 Composer 自动加载时被包含，适合定义全局函数或常量。

4. 在项目中启用自动加载

在入口文件（如 index.php）中引入 Composer 自动生成的加载器：

// 现在可以直接使用命名空间类
$user = new App\Model\User();

只要类符合你配置的规则，Composer 就会自动加载对应文件。

基本上就这些。配置好 autoload 后，保持目录结构和命名空间一致，再运行 dump-autoload，就能实现无缝自动加载。不复杂但容易忽略细节，比如命名空间末尾的反斜杠和目录命名大小写问题。