exclude-from-classmap用于排除不需要自动加载的文件或目录，如测试类、示例代码等，以减小类映射大小、提升性能。通过在composer.json的autoload或autoload-dev中配置路径数组，支持通配符，可排除指定内容不生成类映射，但不影响手动引入使用。
在 composer.json 中，autoload.exclude-from-classmap 字段用于指定哪些文件或目录中的 PHP 类不应被包含进 Composer 的自动加载类映射（class map）中。这个功能主要用于提升性能或避免某些测试类、开发工具类在生产环境中被加载。
exclude-from-classmap 的作用
Composer 在生成自动加载器时，默认会扫描所有配置的自动加载路径（如 psr-4、psr-0），并为每个 PHP 文件中的类创建一个类名到文件路径的映射表（即 class map）。虽然这能确保类可以被正确加载，但有些文件并不需要参与自动加载，比如：
- 测试文件（Test.php、TestCase.php）
- 废弃或示例代码
- 仅用于命令行脚本的辅助类
- 大量存在但不会被直接调用的桩类（stub）
这些文件如果保留在 class map 中，会增加内存占用和加载时间。通过 exclude-from-classmap 可以排除它们，从而减小 class map 大小，提高应用启动效率。
如何使用 exclude-from-classmap
在 composer.json 的 autoload 或 autoload-dev 配置下添加该字段，值为一个文件或目录路径的数组。支持通配符匹配。
示例：{
"autoload": {
"psr-4": {
"App\\": "src/"
},
"exclude-from-classmap": [
"src/DevTools/",
"src/Tests/",
"src/*Stub.php",
"src/Examples/"
]
}
}
上面配置表示：虽然 src/ 下的类属于 App\ 命名空间并按 PSR-4 加载，但以下内容将不会被写入 class map：
- 整个 DevTools 目录下的所有类
- 所有位于 Tests 目录中的类
- 所有以 Stub.php 结尾的文件
- Examples 示例代码目录
注意：排除后，这些类仍然可以通过手动 require 或其他方式使用，只是不会出现在 Composer 自动生成的类映射中。
开发环境与生产环境的区别处理
通常我们只想在生产环境中排除某些文件，而在开发时仍希望保留测试类等。这时应使用 autoload-dev 来反向控制。
推荐做法：{
"autoload": {
"psr-4": {
"App\\": "src/"
}
},
"autoload-dev": {
"psr-4": {
"App\\Tests\\": "tests/"
}
},
"config": {
"optimize-autoloader": true,
"classmap-authoritative": true
}
}
结合 classmap-authoritative: true，Composer 会认为 class map 是“权威的”——即不在其中的类就不存在。此时更需使用 exclude-from-classmap 明确排除不需要的类，防止误加载。
常见使用场景
- 排除项目中的功能演示类或临时调试脚本
- 避免将 Mock 类、桩类暴露给生产环境
- 减少大型项目中不必要的类扫描，加快执行速度
- 配合构建流程，在打包时去除开发相关代码
基本上就这些。合理使用 exclude-from-classmap 能让自动加载更高效，尤其对大型项目或高性能要求的服务端应用很有帮助。关键是理解它不影响文件存在与否，只影响是否被纳入 Composer 的类查找机制。不复杂但容易忽略。
