如何在 Composer 中使用 exclude-from-classmap 来避免加载特定目录？

exclude-from-classmap 用于从 classmap 自动加载中排除指定路径，仅对 classmap 生效，不影响 PSR-4/PSR-0；需在 autoload 中配置为相对路径数组，修改后须执行 composer dump-autoload 验证。

在 Composer 中，exclude-from-classmap 是 autoload 配置下的一个选项，用于从自动生成的类映射（classmap）中排除指定路径，防止这些目录下的类被自动加载。它**只对 classmap 类型的自动加载生效**，不影响 PSR-4/PSR-0 的命名空间映射。

什么时候需要 exclude-from-classmap？

常见于以下情况：

• 项目中混有测试代码、示例脚本或旧版遗留文件，它们有 .php 后缀但不应被生产环境加载；
• 某些第三方包自带 demo/fixture/docs 目录，而你用 classmap 方式加载整个包，想跳过其中非核心文件；
• 避免因临时调试文件（如 test.php、debug.php）意外被 classmap 扫描并尝试加载，导致解析错误或性能损耗。

如何配置 exclude-from-classmap？

在 composer.json 的 autoload 或 autoload-dev 块中添加该字段。格式为字符串数组，每个元素是相对于项目根目录的相对路径（支持通配符 *）：

{
  "autoload": {
    "classmap": ["src/", "lib/"],
    "exclude-from-classmap": [
      "src/Tests/",
      "lib/legacy/*",
      "examples/",
      "docs/"
    ]
  }
}

登录后复制

注意：
– 路径末尾加不加 / 都可以，但推荐统一加斜杠以明确表示目录；
– * 只能匹配单层目录或文件名，不支持递归（如 tests/** 不生效）；
– 排除路径必须位于已声明的 classmap 路径之内，否则无效。

验证是否生效？

运行以下命令重新生成 autoload 文件，并检查结果：

标签： php js json composer 一加 字符串数组