Composer怎么设置加载排除规则_Composer文件排除配置方法【实用】

Composer怎么设置加载排除规则_Composer文件排除配置方法【实用】

exclude-from-classmap 只对 classmap 生效，别指望它拦住 PSR-4 类

这个配置项经常被误解，很多人把它当成一个“万能排除开关”。其实不然，它只在一种特定场景下有效：当你明确在 composer.json 里配置了 classmap 自动加载规则时。如果你的项目只依赖 psr-4 规则，比如 "psr-4": {"App\": "src/"}，那么配置 exclude-from-classmap 基本是无效的。

一个典型的错误现象就是：明明在 exclude-from-classmap 里添加了 "tests/"，但 TestsFooTest 这个类依然能被自动加载器找到。原因很简单，这个类是通过 PSR-4 规则被发现的，它压根儿就没进入 classmap 的扫描范围。

• 生效前提：必须配合 "classmap": ["src/", "lib/"] 这类显式声明。
• 路径规则：路径是相对于 composer.json 所在目录的。写 "tests/" 或 "tests" 都可以，但通常建议带上末尾的 /，这样可以避免意外匹配到类似 test.php 这样的文件。
• 通配符支持：支持使用 * 通配符（例如 "legacy/*"）。从 Composer 2.2 版本开始，还支持 ** 进行递归匹配。
• 关键步骤：修改配置后，必须运行 composer dump-autoload 命令，否则 vendor/composer/autoload_classmap.php 文件不会更新，排除规则也就不会生效。

想让 tests/ 目录彻底不出现在生产包里？靠 .gitattributes，不是 composer.json

很多人尝试在 composer.json 里通过 "archive": {"exclude": ["/tests"]} 来排除测试目录，结果发现从 GitHub 点击 Download ZIP 下载的包里面，tests/ 目录依然存在。这是为什么呢？因为 GitHub、GitLab 等平台默认使用 git archive 命令来打包，而这个命令只认 .gitattributes 文件里的规则，根本不会去读取 composer.json 中的 archive 字段。

真正有效的做法，是在项目根目录创建一个 .gitattributes 文件，并写入如下内容：

/tests export-ignore
/Tests export-ignore
/phpunit.xml export-ignore
/phpunit.xml.dist export-ignore

• export-ignore 是 Git 的原生命令，所有基于 git archive 的分发行为（包括 Packagist 拉取、GitHub Releases、以及 composer archive 命令）都会遵守这个规则。
• 路径开头的 / 很重要，它表示精确匹配目录。如果省略，写成 tests，可能会误伤到像 mytests.php 这样的文件。
• 需要明确的是，这个配置只控制“别人下载你的包时能看到什么”，对于你本地的 composer install 安装过程完全没有影响。

autoload-dev 不是排除机制，而是开发环境开关

把 autoload-dev 理解成排除机制，是一个常见的误区。实际上，它里面定义的规则（比如 "psr-4": {"Tests": "tests/"}）并不会让 tests/ 目录在生产环境“物理消失”。它的作用仅仅是：当使用 composer install --no-dev 安装时，决定是否将这些命名空间注册到自动加载器中。

文件本身只要是你项目源码的一部分，就依然会存在于部署目录里。

• composer install --no-dev 这个命令，跳过的仅仅是 require-dev 部分声明的依赖包，并不会删除你项目根目录下自带的 tests/ 目录。
• 如果目标是让 tests/ 目录不进入最终的生产部署包，必须依靠前面提到的 .gitattributes 或 composer.json 中的 archive.exclude（后者主要对发布到 Packagist 有效）。
• 所以，如果你发现执行 --no-dev 后 tests/ 目录还在，那正好说明它是你项目自身的源码目录，而非通过依赖引入的。

别手动删 vendor 里的 tests/，也别指望 exclude-from-classmap 能减小 vendor 体积

这里有两个关键点需要厘清。首先，exclude-from-classmap 的作用仅仅是减少 autoload_classmap.php 这个索引文件的大小，它完全不影响 vendor/ 目录在磁盘上实际占用的空间。其次，vendor/some/package/tests/ 这类目录是由上游的包作者控制的，你在自己项目的 composer.json 里做任何排除配置，都对它们无效。

经常有人会进行一些误操作：比如觉得 vendor/monolog/monolog/tests/ 目录太大，就直接手动 rm -rf vendor/*/tests 删除。且不说这破坏了依赖的完整性，下次执行 composer update 时，所有被删除的测试文件都会恢复原样，还可能因为校验问题导致安装失败。

• 精简 vendor/ 目录体积唯一可靠的方法是使用 composer install --no-dev。这个命令会跳过所有 require-dev 中定义的依赖包（自然也就包括了这些包自带的 tests/ 目录）。
• 如果真的想剔除某个特定依赖包里的测试目录，正确途径是联系该包的作者，建议他在其项目的 .gitattributes 文件中添加 export-ignore 规则。
• 再次强调，archive.exclude 配置只影响“你作为包作者发布时打包什么”，对你本地安装 vendor/ 的过程没有任何影响。

最后，也是最容易混淆的一点：Composer 的排除逻辑其实分为三个完全不同的层面——自动加载层面（autoload）、安装下载层面（--no-dev）和发布打包层面（.gitattributes / archive）。把这几个层面的配置混为一谈或者用错了地方，排除规则基本都会失效。理解它们各自的职责，才是正确配置的关键。