require用于项目运行必需的生产依赖,如框架和http客户端;require-dev用于开发测试工具,如phpUnit,通过–no-dev可不安装,以减小生产环境体积。

在使用 composer 管理 PHP 项目依赖时,require 和 require-dev 是两个关键字段,它们定义了不同类型的依赖包。正确区分它们有助于保持生产环境的轻量和安全。
require:生产环境必需的依赖
放在 require 中的包是项目运行所必需的,部署到生产环境时必须安装。
- 比如框架(laravel、symfony)、数据库 ORM(Eloquent、Doctrine)、HTTP 客户端(Guzzle)等。
- 这些组件参与实际业务逻辑,缺少它们应用无法运行。
- 执行
composer install时,默认会安装 require 列表中的所有包。
示例场景: 你的项目调用第三方 API,必须使用 guzzlehttp/guzzle 发送 HTTP 请求。这个包应通过以下命令添加:
composer require guzzlehttp/guzzle
它会被写入 composer.JSon 的 require 字段。
require-dev:仅开发和测试需要的工具
require-dev 中的包只在开发、调试、测试阶段使用,不会影响线上功能。
- 常见类型包括单元测试框架(phpunit/phpunit)、代码规范检查(phpcs、phpstan)、生成文档或测试数据的工具。
- 这些工具帮助提升代码质量,但与应用核心功能无关。
- 部署生产环境时可通过
composer install --no-dev跳过安装 dev 依赖,减少体积和潜在风险。
示例场景: 你用 PHPUnit 写测试用例,应使用:
composer require --dev phpunit/phpunit
这样 phpunit 只出现在 require-dev,不会被带到生产服务器。
如何选择正确的命令?
判断一个包该放哪,关键是看它是否参与最终用户的请求处理流程。
- 如果某个类在控制器或服务中被直接调用 → 放
require - 如果只在命令行运行测试或静态分析 → 放
require-dev - 不确定时查看包的用途说明,多数官方推荐已明确分类
基本上就这些。合理划分依赖,能让项目更清晰,部署更高效。
以上就是composer require 和 require-dev 的正确使用场景的详细内容,更多请关注php中文网其它相关文章!


