require用于生产环境必需的依赖,如框架、数据库组件,部署时始终安装;2. require-dev用于开发测试工具,如PHPUnit、PHPStan,仅在开发阶段使用,可避免进入生产环境。
在使用 Composer 管理 PHP 项目依赖时,require 和 require-dev 是两个关键配置项。它们都用于声明项目所依赖的包,但用途和作用范围不同。
require:生产环境依赖
这个部分列出的是项目在实际运行时必须存在的依赖包。这些库是应用功能的核心组成部分,无论在开发、测试还是线上部署环境中都不可或缺。
例如:
- 框架类库(如 Laravel、Symfony)
- 数据库操作组件(如 doctrine/dbal)
- 第三方 API 客户端(如 guzzlehttp/guzzle)
当你执行 composer install 时,这些包一定会被安装。即使你在部署生产环境时使用了 –no-dev 参数,require 中的包依然会被加载。
require-dev:开发与测试阶段依赖
这一部分包含的是仅在开发或测试过程中需要的工具类库。它们不参与项目的实际运行,主要用于代码质量检查、自动化测试、生成文档等任务。
常见例子包括:
- 单元测试框架(phpunit/phpunit)
- 静态分析工具(phpstan/phpstan、vimeo/psalm)
- 代码格式化工具(friendsofphp/php-cs-fixer)
- 开发服务器或调试工具(psy/psysh)
这些包在运行 composer install –no-dev 时不会被安装,因此不会进入生产环境,有助于减少部署体积并提升安全性。
如何选择放在哪个位置?
判断一个包应该放在 require 还是 require-dev,关键看它是否。
- 如果代码中通过
new、use调用了某个类,并且该类来自这个包 → 放入 require - 如果只是命令行工具或测试脚本用到,运行时完全不需要 → 放入 require-dev
比如:你用 PHPUnit 写测试,但应用上线后并不执行测试,所以 PHPUnit 属于开发依赖;而如果你的应用调用了 Guzzle 发送 HTTP 请求,那它就是生产依赖。
小技巧:添加依赖的正确方式
使用 Composer 命令可以自动将包添加到对应区域:
- composer require vendor/package → 添加到 require
- composer require –dev vendor/package → 添加到 require-dev
这样能避免手动编辑 composer.json 出错。
基本上就这些。分清生产依赖和开发依赖,不仅能让你的项目结构更清晰,还能优化部署流程,避免把不必要的工具带到线上环境。
以上就是composer中的require-dev和require有什么区别_理解生产依赖与开发依赖的用途的详细内容,更多请关注php中文网其它相关文章!



