vendor 目录就要花费大量时间。这个目录动辄几百兆甚至上G，里面包含了各种第三方库的测试文件、文档、示例代码、.git 目录、.travis.yml 配置等等，这些东西在生产环境中根本用不到，却白白占用了服务器空间，拖慢了部署速度。我尝试过一些土办法，比如在部署后手动删除 vendor 目录下的 tests、docs 等文件夹，但这不仅效率低下，而且很容易遗漏或者误删，导致程序出现意想不到的问题。尤其是在CI/CD流程中，这种手动干预的方式更是不可取。我急需一个自动化、可靠的解决方案。
Composer在线学习地址：学习地址
幸运的是，PHP社区总有大神出手相助！经过一番搜索，我发现了 liborm85/composer-vendor-cleaner 这个Composer插件，它简直是为解决我的痛点而生。
告别臃肿：liborm85/composer-vendor-cleaner 登场
liborm85/composer-vendor-cleaner 是一个Composer插件，它的核心功能是在 composer install 或 composer update 之后，自动扫描并清理 vendor 目录中那些你指定为“不必要”的文件和文件夹。它通过高度灵活的配置，让你能够精确控制哪些内容应该被移除，从而在不影响项目功能的前提下，大幅减小 vendor 目录的体积。
如何使用它让项目“瘦身”？
使用 liborm85/composer-vendor-cleaner 非常简单，主要分为安装和配置两步。
1. 安装插件
你可以选择将其安装到你的项目本地，或者全局安装。对于大多数项目，推荐本地安装，这样配置会随着项目一起管理：
composer require liborm85/composer-vendor-cleaner
如果你希望在所有项目中使用相同的清理规则，可以考虑全局安装：
composer global require liborm85/composer-vendor-cleaner
2. 配置清理规则
插件安装完成后，你需要在项目的 composer.json 文件中添加 extra.dev-files 配置项，来定义你想要清理的文件和目录。这个配置项支持强大的Glob模式匹配，让你能够非常精细地控制清理范围。
以下是一个配置示例，展示了其灵活性：
{
"require": {
"liborm85/composer-vendor-cleaner": "^1.0"
},
"extra": {
"dev-files": {
"/": [ // 匹配所有库包的根目录和bin目录
"tests/", // 移除所有测试目录
"docs/", // 移除所有文档目录
".travis.yml", // 移除所有.travis.yml文件
".github/" // 移除所有.github目录
],
"*/*": [ // 匹配所有库包目录（不包括bin目录）
"*.sh", // 移除所有shell脚本文件
"CONTRIBUTING.md" // 移除贡献指南文件
],
"twig/twig": [ // 仅匹配 twig/twig 包
"doc/", // 移除其doc目录
"/drupal_test.sh" // 移除其根目录下的drupal_test.sh文件
],
"symfony/*": [ // 匹配所有symfony开头的包
"Tests/" // 移除其Tests目录
],
"example/package": [ // 匹配 example/package 包
"languages/*", // 移除languages目录下的所有文件和目录
"!languages/cs.php" // 但排除languages/cs.php文件
]
}
},
"config": {
"dev-files": {
"match-case": true, // 是否区分文件名大小写，默认为true
"remove-empty-dirs": true, // 是否移除清理后留下的空目录，默认为true
"no-dev-only": false // 如果设置为true，则只在运行`composer install --no-dev`时才进行清理
}
}
}配置详解：
- *键名（
"/", `"/","twig/twig","symfony/"` 等）**：这些是匹配目标路径的规则。-
"/"：表示匹配vendor目录下所有直接子目录（即所有第三方包的根目录）以及bin目录。 -
"*/*"：表示匹配vendor目录下所有第三方包的根目录，但不包括bin目录。 -
"twig/twig"：精确匹配vendor/twig/twig这个特定包。 -
"symfony/*"：使用通配符匹配所有以symfony/开头的包，例如symfony/console、symfony/http-kernel等。
-
-
值（数组）：数组中的每个字符串都是一个Glob模式，用于匹配要删除的文件或目录。
-
tests/：匹配名为tests的目录。 -
*.sh：匹配所有以.sh结尾的文件。 -
!languages/cs.php：感叹号!表示排除规则，即languages目录下的所有内容都会被删除，除了cs.php文件。
-
-
config.dev-files：提供了一些额外的全局配置选项，可以进一步微调清理行为。-
match-case: 是否区分文件名大小写，默认true。 -
remove-empty-dirs: 清理后是否删除空目录，默认true。 -
no-dev-only: 如果设置为true，则只有当Composer命令带上--no-dev参数时（通常用于生产环境部署）才会执行清理。这非常有用，可以在开发环境中保留所有文件，而在生产环境自动清理。
-
你甚至可以将这些清理规则定义在一个独立的JSON文件中（例如 composer.dev-files.json），然后在 composer.json 中引用它：
{
"extra": {
"dev-files": "composer.dev-files.json"
}
}优势与实际应用效果
引入 liborm85/composer-vendor-cleaner 后，我的项目部署流程发生了质的飞跃：
- 显著减小部署包体积：清理掉几百兆甚至上G的无用文件后，部署包的大小可以减少一半甚至更多，极大地节省了存储空间和网络传输带宽。
- 加速部署时间：文件传输量的减少直接带来了部署时间的缩短，尤其是在网络条件不佳或需要频繁部署的环境下，效果非常明显。
- 更纯净的生产环境：生产服务器上不再有与生产无关的测试、文档等文件，减少了潜在的安全风险和混乱。
- 自动化与可靠性：一旦配置完成，清理过程完全自动化，无需人工干预，避免了手动清理可能带来的错误和遗漏。
- 高度可定制：灵活的Glob模式和排除规则，让我可以根据每个项目的具体需求，精确控制清理范围，确保不会误删任何必要文件。
- 与CI/CD无缝集成：在自动化部署流程中，这个插件能完美融入，成为部署流水线中不可或缺的一环。
如果你也曾被臃肿的 vendor 目录困扰，那么 liborm85/composer-vendor-cleaner 绝对值得一试。它不仅能让你的项目更轻盈，还能让你的部署工作变得前所未有的顺畅和高效。赶快尝试一下，让你的PHP项目焕发新生吧！
