require用于安装生产环境必需的依赖,如框架和SDK,写入composer.json的"require"字段;而require --dev用于安装开发或测试工具,如PHPUnit和PHPStan,写入"require-dev"字段,可通过composer install --no-dev在生产环境跳过安装,以减少体积并提升安全性。

在使用 Composer 安装 PHP 包时,require 和 require --dev 的主要区别在于依赖的用途和部署环境。
require:安装生产环境依赖
这个命令用于添加项目在生产环境中必须运行的依赖包。
例如:- 框架(如 Laravel、Symfony)
- 数据库 ORM(如 Doctrine)
- 支付 SDK、缓存组件等
这些包会被写入 composer.json 的 "require" 字段,并在所有环境中(包括生产服务器)安装。
require --dev:安装开发环境依赖
这个命令用于添加仅在开发或测试阶段需要的工具,不会影响线上功能。
常见类型包括:- 代码测试工具(phpunit/phpunit)
- 静态分析工具(phpstan/phpstan)
- 代码格式化工具(friendsofphp/php-cs-fixer)
这些包会被写入 composer.json 的 "require-dev" 字段,默认情况下,在生产环境执行 composer install 时可以通过 --no-dev 参数跳过它们的安装。
实际影响示例
当你运行:
composer install --no-dev
Composer 只会安装 require 中的包,忽略 require-dev 的内容。这能减少生产环境的文件体积,提升安全性,避免不必要的依赖暴露。
基本上就这些。简单记:核心功能依赖用 require,开发辅助工具加 --dev。










