require用于生产环境必需的依赖,如框架和HTTP客户端,部署时默认安装;require-dev用于开发测试工具,如phpunit和代码格式化工具,仅在开发阶段安装,通过--no-dev参数可跳过,确保生产环境轻量安全。

Composer 通过 require 和 require-dev 区分生产依赖与开发依赖,从而在不同场景下精准管理项目所需库。
require:生产环境必需的依赖
写在 require 中的包是项目运行所必需的。这些依赖会在所有环境中安装,包括生产环境。
- 例如框架(如 Laravel、Symfony)、数据库抽象层(如 Doctrine)、HTTP 客户端(如 Guzzle)等。
- 执行
composer install或composer update时,默认会安装 require 中的包。 - 部署到生产环境时,只保留 require 的依赖更安全、轻量。
require-dev:仅开发和测试时需要的工具
require-dev 中的包只在开发阶段使用,比如测试工具、静态分析器、代码生成器等。
- 常见例子:phpunit/phpunit、friendsofphp/php-cs-fixer、fakerphp/faker。
- 这些包不会出现在生产环境,减少潜在安全风险和体积。
- 只有在本地开发或 CI 流程中,才会被安装。
安装行为受 --no-dev 参数控制
Composer 的安装行为可以通过参数调整,决定是否加载 require-dev 中的内容。
-
composer install:默认安装 require 和 require-dev 所有依赖。 -
composer install --no-dev:仅安装 require 中的依赖,跳过 require-dev。常用于生产部署。 - 在 CI/CD 或构建镜像时,加上
--no-dev可加快安装速度并精简环境。
自动加载也分主代码与开发类
Composer 自动生成的 autoload 配置会包含两部分:
- 主 autoloader(
vendor/autoload.php)加载 require 和 require-dev 的类。 - 但生产环境若用
--no-dev安装,则 require-dev 的类实际上不存在,不能调用。 - 建议不要在应用代码中引用 phpunit 等 dev 工具类,避免运行时报错。
基本上就这些。合理划分 require 与 require-dev,能让项目结构更清晰,部署更高效。不复杂但容易忽略细节。










