详解 composer.json 中的 "require" 与 "require-dev"

require用于声明生产环境必需的依赖，如框架和SDK；require-dev用于开发测试工具，如PHPStan和PHPUnit；执行composer install --no-dev可避免在生产环境安装dev依赖，确保部署安全高效。

在使用 Composer 管理 PHP 项目依赖时，require 和 require-dev 是两个核心配置项。它们都用于声明项目所依赖的包，但用途和作用范围不同。理解它们的区别对构建清晰、高效的项目结构非常重要。

require：项目运行所必需的依赖

require 中列出的包是项目在生产环境正常运行所必须的依赖。这些包会被部署到线上环境，是应用功能的基础组成部分。

例如：

• 框架（如 Laravel、Symfony）
• 数据库操作库（如 Doctrine、Eloquent）
• HTTP 处理组件（如 Guzzle、PSR-7 实现）
• 第三方服务 SDK（如阿里云、微信支付 SDK）

当你执行 composer install 时，这些包默认都会被安装。

require-dev：仅开发和测试阶段需要的工具

require-dev 用于声明只在开发、调试或测试过程中使用的依赖。这些包不会出现在生产环境中，有助于减少部署体积并提升安全性。

常见的 dev 依赖包括：

• 代码质量工具（如 PHPStan、Psalm）
• 单元测试框架（如 PHPUnit、PHPSpec）
• 代码格式化工具（如 PHP-CS-Fixer、PHP_CodeSniffer）
• 本地服务器或调试工具（如 PsySH、barryvdh/laravel-ide-helper）

这些工具帮助开发者写出更健壮的代码，但上线后并不需要。

Fliki

高效帮用户创建视频，具有文本转语音功能

151

查看详情

安装行为差异：如何控制依赖加载

Composer 提供了选项来控制是否安装 dev 依赖：

• composer install —— 默认安装 require 和 require-dev 中的所有包
• composer install --no-dev —— 只安装 require 中的依赖，常用于生产环境部署
• composer require --dev —— 添加新包到 require-dev，比如加一个测试库

这意味着你可以灵活地根据不同环境调整依赖集合。

自动加载机制中的区别

Composer 生成的自动加载器（autoload）会同时包含 require 和 require-dev 中的类，但在生产环境使用 --no-dev 安装后，dev 包实际上不存在于 vendor 目录中，因此相关类也无法访问。

建议不要在应用主逻辑中调用 require-dev 中的类，避免因环境差异导致运行时错误。

基本上就这些。合理划分 require 和 require-dev，能让项目结构更清晰，部署更安全。

以上就是详解 composer.json 中的 "require" 与 "require-dev"的详细内容，更多请关注php中文网其它相关文章！