require用于声明生产环境必需的依赖包,如框架、数据库组件和API客户端,执行composer install时默认安装;2. require-dev用于声明开发和测试阶段所需的工具类包,如代码检查、测试框架和格式化工具,使用composer install --no-dev时不会安装;3. 区分两者可确保生产环境轻量安全,composer require默认添加到require,加--dev则添加到require-dev。

在使用 Composer 管理 PHP 项目依赖时,require 和 require-dev 是两个常见的配置项。它们都用于声明项目所依赖的包,但用途和适用环境不同。
require:生产环境依赖
这个部分列出的是项目在生产环境运行时必须的依赖包。这些包是核心功能的一部分,缺少它们项目将无法正常工作。
例如:
- 框架类库(如 Laravel、Symfony)
- 数据库操作组件(如 Doctrine、Eloquent)
- 第三方 API 客户端(如 Guzzle HTTP 客户端)
当你执行 composer install 时,这些包默认都会被安装。如果部署到生产环境并使用 composer install --no-dev,这些包依然会被安装。
require-dev:开发环境依赖
这个部分列出的是仅在开发或测试阶段需要的工具类包,不会影响项目的实际运行。
常见类型包括:
- 代码质量检查工具(如 PHPStan、Psalm)
- 单元测试框架(如 PHPUnit、PHPSpec)
- 代码格式化工具(如 PHP-CS-Fixer)
- 本地服务器或调试工具(如 PsySH)
这些包只在开发时有用。使用 composer install --no-dev 时,Composer 不会安装它们,从而减少生产环境的体积和潜在安全风险。
关键区别总结
- require 中的包是运行项目必需的,始终要安装(除非明确跳过 dev)
- require-dev 中的包只用于开发、测试、调试,可选择性跳过
- 执行 composer require 默认添加到 require
- 执行 composer require --dev 则添加到 require-dev
基本上就这些。合理区分这两个字段,有助于保持生产环境干净、安全、高效。










