vendor目录庞大的根源是dev依赖和测试/文档等非运行文件;生产环境应使用composer install --no-dev --optimize-autoloader,并用composer-unused扫描未引用包,再通过composer-cleaner或shell命令清理冗余目录。
vendor 目录为什么这么大?根源在 dev 依赖和测试文件
绝大多数项目
膨胀,不是因为主包本身,而是
默认拉取了所有
依赖(如
、
、
),并且很多包把测试用例(
)、文档(
)、示例(
)甚至 .
git
目录一起打包进发行版。这些对线上运行完全无用,但可能占掉 40%–70% 的空间。
安装时跳过 dev 依赖:只在生产环境用
部署到服务器或构建 Docker 镜像时,必须加这个参数,否则白占空间还增加攻击面:
注意
:
会生成类映射(
),加快自动加载,同时也会排除未声明的文件(比如没在
里写的
),属于一箭双雕。
CI/CD 流水线、Dockerfile 的
行必须带
一般不用于生产,但如果执行,也应加
防止意外引入开发依赖
本地开发仍需
,所以不要全局删掉
里的
段
用
扫描真正没被引用的包
只是砍掉整块 dev 依赖,但有些
包其实项目里根本没调用过(比如历史遗留、临时试用后忘了删)。这时需要静态分析:
它会扫描全部 PHP 文件,比对
、
、
等调用痕迹,列出疑似废弃的包。结果要人工核验,尤其注意:
Docker Sandbox
创建并管理 Docker 沙箱虚拟机环境以安全执行代理。适用于运行不受信任代码、探索包或隔离代理工作负载。支持 Claude、Codex、Copilot、Gemini 和 Kiro 代理,并提供网络代理控制。
下载
运行时动态加载(
、
)不会被识别
配置文件
中引用的类(如 Laravel 的
)也不会被扫描到
删包前先
搜包名,确认没有字符串级依赖
删 vendor 内部冗余目录:用
或手动过滤
即使去掉 dev 依赖,单个包(比如
)仍自带
、
、
等非运行必需内容。可借助工具清理:
或者更轻量——直接用 shell 清理(执行前备份):
⚠️ 注意:
类包(如
)本身不含
,但它的依赖(如
)常带测试目录;删之前确认该包是否真被
排除了。
最省事的是从一开始就用
,最难防的是那些“看起来有用、其实没被调用”的包——它们不会报错,只会悄悄吃掉磁盘和部署时间。
vendorcomposer installrequire-devphpunitmockeryphpstantests/docs/examples/--no-devcomposer install --no-dev --optimize-autoloader--optimize-autoloaderclassmapautoload.files.phpRUN composer install--no-devcomposer update--no-devrequire-devcomposer.jsonrequire-devcomposer-unusedcomposer install --no-devrequirecomposer require --dev composer-unused
composer unusedusenewstatic::class_exists($name)Container::get()config/app.phpgit grepcomposer-cleanersymfony/consoleTests/Resources/CHANGELOG.mdcomposer require --dev vaimo/composer-cleaner
# 在 composer.json 中添加清理规则
"extra": {
"vaimo-composer-plugins": {
"cleaner": {
"excludes": ["**/Tests/**", "**/tests/**", "**/Examples/**", "**/*.md", "**/*.txt", "**/.git/**"]
}
}
}find vendor/ -name 'Tests' -type d -exec rm -rf {} +
find vendor/ -name 'tests' -type d -exec rm -rf {} +
find vendor/ -name '*.md' -delete
find vendor/ -name 'CHANGELOG*' -deletephpunitphpunit/phpunitTests/sebastian/exporter--no-dev--no-dev