require用于声明生产环境必需的依赖,如框架和数据库组件,这些包会部署到生产服务器并随项目运行;require-dev则包含开发和测试阶段使用的工具,如phpunit和代码检查工具,仅在开发时安装,可通过composer install --no-dev排除,避免影响生产环境。例如monolog属于require,而phpunit属于require-dev,合理区分可减小部署体积并提升安全性。

在使用 Composer 管理 PHP 项目依赖时,require 和 require-dev 都用于声明项目所需的外部包,但它们的用途和作用范围不同。
require:生产环境依赖
放在 require 中的包是项目运行所必需的依赖,无论在开发、测试还是生产环境中都必须存在。
-
• 这些包会随项目一起部署到生产服务器
• 缺少这些依赖,应用将无法正常运行
• 例如:框架(如 Laravel)、数据库 ORM、缓存库等核心组件
require-dev:开发环境依赖
放在 require-dev 中的包仅在开发或测试阶段使用,不会影响生产环境的运行。
-
• 常见于测试工具(如 phpunit/phpunit)、代码规范检查(phpstan/phpstan)、调试工具等
• 使用
composer install --no-dev 时,这些包不会被安装
• 不会包含在生产环境的依赖中,有助于减小部署体积
实际示例
一个典型的 composer.json 片段:
{
"require": {
"monolog/monolog": "^2.0"
},
"require-dev": {
"phpunit/phpunit": "^9.0"
}
}
这里 monolog 是记录日志的核心库,必须存在于生产环境;而 phpunit 只在写测试时用到,上线后不需要。
基本上就这些。区分清楚这两个字段,能帮助你更合理地管理项目依赖,避免把开发工具带到线上环境。










