require用于添加生产环境必需的依赖,如框架、数据库组件等,执行composer require命令会将其写入composer.JSon的require字段;require-dev用于添加仅开发测试时需要的工具,如phpunit、phpstan等,通过composer require –dev命令安装并记录在require-dev字段;部署时使用composer install –no-dev可避免安装开发依赖,减少生产环境文件体积并提升安全性。

在使用 Composer 管理 PHP 项目依赖时,require 和 require-dev 都用于添加依赖包,但它们的用途和作用范围不同。
require:生产环境依赖
这些是项目运行所必需的库。无论开发、测试还是线上部署,都必须存在。
常见用途包括:
- 框架核心组件(如 laravel、symfony)
 - 数据库 ORM(如 Doctrine、Eloquent)
 - 第三方 API 客户端(如 Guzzle http 客户端)
 - 日志处理库(如 Monolog)
 
执行命令:composer require vendor/package-name
 该依赖会被写入 composer.json 的 require 字段,并安装到 vendor/ 目录。
require-dev:仅开发阶段依赖
这些包只在开发或测试时需要,不会随生产环境部署。
典型场景有:
- 单元测试工具(如 phpunit/phpunit)
 - 代码质量检查(如 phpstan/phpstan、squizlabs/php_codesniffer)
 - 本地调试工具(如 psy/psysh)
 - 生成文档或自动化脚本的工具
 
执行命令:composer require --dev vendor/package-name 或 composer require-dev vendor/package-name
 这些依赖会记录在 composer.json 的 require-dev 字段中。
关键区别与实际影响
最直接影响体现在部署行为上:
- 运行 
composer install时,默认会安装 require 和 require-dev 中的所有包 - 但在生产环境中,通常使用 
composer install --no-dev,此时 require-dev 的包不会被安装 - 这能减少生产服务器上的文件体积,提升安全性,避免不必要的依赖暴露
 
基本上就这些。合理区分两者,能让项目结构更清晰,部署更高效。
以上就是composer require-dev和require有什么区别和用途?的详细内容,更多请关注php中文网其它相关文章!


