require-dev依赖仅在开发环境安装,生产部署必须用composer install --no-dev跳过,否则phpunit等工具会误入线上环境,引发安全风险、性能下降或Class not found错误。

require-dev 依赖只在开发环境安装
Composer 默认会同时安装 require 和 require-dev 中的包,除非你明确告诉它跳过开发依赖。这在生产部署时是危险的——比如 phpunit、mockery 或 larastan 这类工具被装到线上,不仅浪费空间,还可能引入意外的自动加载或安全风险。
正确做法是在部署时加 --no-dev 参数:
composer install --no-dev
这个参数只影响安装行为,不影响 composer.json 结构本身。如果你用的是 composer update,也得带上它,否则本地改完 require-dev 后直接 push 到 CI/CD,可能触发非预期的依赖更新。
-
composer install无参数 → 读composer.lock并装全量(含 dev) -
composer install --no-dev→ 读 lock 文件,但跳过 dev 包 -
composer update --no-dev→ 更新非 dev 依赖,dev 部分完全不动
require-dev 里的包不能在生产代码里直接 use
虽然 Composer 的自动加载机制对 require-dev 包也生效(只要没加 --no-dev),但逻辑上这些包不该出现在运行时代码中。常见错误是:在控制器或服务类里写了 use PHPUnitFrameworkTestCase;,或者调用 OrchestraTestbenchTestCase 的方法——这会导致生产环境报 Class not found,哪怕你用了 --no-dev 安装。
判断依据很简单:如果某段代码在请求生命周期中被执行(比如 HTTP 响应生成、队列任务处理),它就不该依赖 require-dev 里的任何类或函数。
- 测试类、Factories、Seeders 可以用
require-dev包,因为它们只在phpunit或artisan db:seed等命令下运行 - 中间件、模型观察者、事件监听器等运行时组件,必须只依赖
require中的包 - CI 脚本里可以放心 require
phpstan/phpstan,但别把它写进config/app.php的 providers 数组
如何安全地在生产环境检测 dev 依赖是否被误引
没有静态分析工具能 100% 捕获所有运行时引用,但你可以快速筛出高危信号。最直接的方式是临时删掉 vendor/bin 以外的 dev 包,再跑一遍自动加载检查:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
composer install --no-dev && composer dump-autoload --optimize
然后用 PHP 自带的反射或简单脚本扫描关键入口:
grep -r "use.*PHPUnit\|use.*Mockery\|use.*pestphp" app/ --include="*.php"
更稳妥的做法是,在 CI 中加一步检查:
- 用
composer show --dev列出所有 dev 包名 - 对每个包名(如
phpunit/phpunit),提取其命名空间前缀(PHPUnit\) - 在
app/、src/下 grep 这些前缀,若命中且不在tests/目录下,就视为违规
注意:有些包(如 symfony/var-dumper)既在 require 又在 require-dev 出现,要结合实际安装路径和 composer show 输出确认来源。
require-dev 不等于“不重要”,但它的管理逻辑不同
很多人把 require-dev 当成临时垃圾桶,随便加工具、凑版本号,结果导致本地 composer update 变慢、lock 文件频繁冲突、甚至测试环境和本地行为不一致。真正需要关注的是:谁在用、什么时候用、怎么验证没被滥用。
比如 laravel/pint 是代码风格工具,只在 pre-commit hook 里调用;infection/infection 是变异测试,只在 nightly CI 运行——它们都不该出现在 autoload-dev 的 PSR-4 映射里,除非你真要在测试代码里动态加载其类。
最容易被忽略的一点:某些包(如 doctrine/dbal)在 require-dev 里是为了支持迁移回滚测试,但它本身可能被 require 中的 ORM 间接依赖。这时要看 composer why doctrine/dbal 输出,而不是只看它在哪一节声明。

















