如何配置Composer在安装包后自动清理不必要的文件？（例如测试文件）-composer-PHP中文网

如何配置Composer在安装包后自动清理不必要的文件？（例如测试文件）

穿越時空

发布： 2025-12-15 13:05:02

原创

481人浏览过

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

如何配置composer在安装包后自动清理不必要的文件？（例如测试文件）

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 中注册一个清理脚本，在自动加载生成后执行：

Kreado AI

Kreado AI是一个多语言AI视频创作平台，只需输入文本或关键词，即可创作真实/虚拟人物的多语言口播视频。为创作者提供AI赋能

182

查看详情

添加脚本定义：

"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 下载，而是安装后精准剔除。选插件省心，写脚本透明，进容器彻底——按项目实际选一种即可。

以上就是如何配置Composer在安装包后自动清理不必要的文件？（例如测试文件）的详细内容，更多请关注php中文网其它相关文章！