composer不内置自动删除测试文件功能,但可通过–no-dev选项跳过开发依赖、使用eloquent/composer-cleaner插件配置排除路径、自定义post-autoload-dump脚本或CI/CD中find命令清理vendor内tests等冗余目录来实现。

Composer 本身不提供“安装后自动删除测试文件”的内置功能,但可以通过组合使用 composer install 的选项、自定义脚本和第三方插件来实现类似效果。核心思路是:在包安装完成后,主动移除不需要的目录(如 tests/、examples/、docs/ 等),同时确保不影响运行时依赖。
使用 composer install --no-dev 减少非生产文件
这是最基础也最有效的一步。开发依赖(包括测试框架、工具类库)及其相关文件(如 phpunit 的配置、测试用例)默认不会被安装到生产环境:
-
--no-dev会跳过require-dev中声明的包,自然也就不会下载它们附带的测试/文档等资源 - 配合
"minimum-stability": "stable"和"prefer-stable": true可进一步避免不稳定版本中混入调试用内容 - 注意:这不会清理已安装包内部自带的
tests/目录(比如monolog/monolog自身的tests/文件夹仍会存在)
启用 extra > composer-cleaner 插件(推荐)
社区主流方案是使用 bamarni/composer-bin-plugin 或更直接的 maglnet/ComposerRequireChecker?不对——真正专注“清理包内冗余文件”的是:ergebnis/composer-normalize 不干这事;正确答案是:johnstevenson/composer-cleanup 或更活跃维护的:symfony/flex(仅限 symfony 项目)?其实最通用的是:
eloquent/composer-cleaner —— 它允许你在 composer.json 中声明要从所有已安装包中删除的路径模式:
- 安装插件:
composer require --dev eloquent/composer-cleaner - 在
composer.json的extra段添加规则:
"extra": { "cleaner": { "exclude": [ "/tests/", "/Tests/", "/test/", "/Test/", "/examples/", "/docs/", "/documentation/", "/.github/", "/.git/", "/CHANGELOG.md", "/README.md", "/LICENSE" ] } }
下次执行 composer install 或 composer update 后,插件会自动扫描 vendor/ 下每个包,匹配并删除符合规则的文件与目录。
自定义 post-autoload-dump 脚本(轻量可控)
如果你倾向零依赖、完全自主控制,可在 composer.json 中注册一个清理脚本,在自动加载生成后执行:
- 添加脚本定义:
"scripts": { "post-autoload-dump": [ "rm -rf vendor/*/tests vendor/*/Tests vendor/*/test vendor/*/Test vendor/*/examples vendor/*/docs vendor/*/documentation vendor/*/.github vendor/*/.git" ] }
⚠️ 注意事项:
- 该命令仅在 linux/macOS 下生效;windows 用户需改用 PowerShell 或借助
robloach/component-installer类工具 - 建议先加
echo "Cleaning vendor..."并用find vendor -name tests -type d | head -5预览,避免误删 - 若某些包的
tests/是运行时必需的(极少见,如部分代码生成器),请从排除列表中移除对应路径
构建阶段统一清理(CI/CD 场景)
在 docker 构建或部署脚本中,不依赖 Composer 插件,而是用系统命令集中处理:
- Dockerfile 示例片段:
RUN composer install --no-dev --optimize-autoloader && find vendor/ -name 'tests' -type d -prune -exec rm -rf {} + && find vendor/ -name 'Examples' -type d -prune -exec rm -rf {} + && find vendor/ -name '.git' -type d -prune -exec rm -rf {} +
这样既干净又可审计,适合对安全性、体积敏感的生产镜像。
基本上就这些。不需要复杂配置,关键在于明确目标:不是阻止 Composer 下载,而是安装后精准剔除。选插件省心,写脚本透明,进容器彻底——按项目实际选一种即可。