composer install 默认安装 require-dev 包,生产环境应使用 composer install --no-dev 跳过 dev 依赖及 autoload-dev,需在部署、ci/cd、docker 中显式添加,不影响 composer.lock。

composer install 时跳过 require-dev 的包
生产环境运行 composer install 默认仍会装 require-dev 下的包,除非明确告诉它别装。这不是 bug,是默认行为——Composer 假设你本地和线上都走同一套流程,但上线时显然不该带 phpunit、phpstan 这类工具。
正确做法是加 --no-dev 参数:
composer install --no-dev
这个参数会跳过 require-dev 区块里的所有依赖,同时还会忽略 autoload-dev 的自动加载规则,避免意外引入测试类。
- 必须在部署脚本、CI/CD 流水线、Docker 构建阶段显式加上,不能依赖“线上环境没装 dev 包”这种侥幸
- 如果项目用了
composer.lock,--no-dev不影响 lock 文件内容,只是安装时过滤掉 dev 依赖 - 某些旧版 Composer(--no-dev 下仍可能加载部分 dev autoloader,升级到 2.x 可彻底规避
为什么 vendor/bin 里还残留测试命令?
即使加了 --no-dev,你仍可能在 vendor/bin 看到 phpunit、phpcs 这些可执行文件——它们不是被“安装”进 vendor,而是由其他已安装的包(比如 symfony/console 或 phpspec/phpspec)声明的 bin 脚本,Composer 会一并生成符号链接。
这不是错误,但有风险:
注意:请在linux环境下测试或生产使用 青鸟内测是一个移动应用分发系统,支持安卓苹果应用上传与下载,并且还能快捷封装网址为应用。应用内测分发:一键上传APP应用包,自动生成下载链接和二维码,方便用户内测下载。应用封装:一键即可生成app,无需写代码,可视化编辑、 直接拖拽组件制作页面的高效平台。工具箱:安卓证书生成、提取UDID、Plist文件在线制作、IOS封装、APP图标在线制作APP分发:
- 如果某天误执行
vendor/bin/phpunit,它可能因缺少依赖而报错,也可能意外触发本地测试逻辑 - 更糟的是,某些框架(如 Laravel)的 Artisan 命令会扫描
vendor/bin,遇到异常脚本可能提前失败 - 解决方案不是删文件,而是用
"bin-dir": "bin"配置把 bin 脚本挪到非 Web 可访问路径,并配合部署脚本清理无关 bin
CI/CD 中忘记 --no-dev 导致线上体积暴增
一个典型现象:Docker 镜像大小突然多出 80MB,du -sh vendor/* | sort -hr | head -5 显示 phpunit、roave/security-advisories 占大头——基本就是 CI 脚本漏了 --no-dev。
这类问题往往只在上线后才暴露,因为本地开发不关心体积,测试环境又常复用 dev 依赖。
- GitLab CI / GitHub Actions 的部署 job 必须显式写
composer install --no-dev --optimize-autoloader -
--optimize-autoloader很关键:它生成 classmap,绕过 PSR-4 动态查找,既提速又避免加载 dev 目录下的类(哪怕它们物理存在) - 若用
composer install --no-dev后仍发现 dev 类可被 new 出来,大概率是 autoloader 没刷新,删掉vendor/autoload.php和vendor/composer/autoload_*.php再重装
require-dev 里混进了运行时依赖怎么办?
有些团队把 doctrine/migrations、laravel/sail 甚至 ext-pcntl 适配包扔进 require-dev,结果上线后迁移跑不了、队列起不来——这不是 Composer 的锅,是依赖分类错了。
判断标准很简单:只要代码里 new、use、class_exists 到它,或者它参与请求生命周期(如中间件、命令、事件监听器),就必须进 require。
-
phpunit、phpstan、mockery—— 安全放 dev -
doctrine/doctrine-bundle、spatie/laravel-backup—— 运行时用,必须移出 dev - 不确定?用
grep -r "use.*ClassName" app/ src/ | grep vendor或直接查类是否在vendor/autoload.php的 autoload 链路中
最麻烦的不是改配置,是改完要验证所有命令、API、后台任务是否还能正常调用那些类——漏测一个,上线就挂。









