本质区别在于使用场景和安装时机:require是运行必需依赖,所有环境都安装;require-dev仅开发测试时需要,生产环境用–no-dev跳过。

本质区别在于使用场景和安装时机不同:require 是项目运行必需的依赖,必须存在于所有环境;require-dev 是仅在开发、测试阶段需要的工具类依赖,生产环境默认不装。
require:上线就靠它
这些包是应用启动和运行的基石。没有它们,代码根本跑不起来。
- 框架本身(如 laravel、symfony、yii2)
- 数据库操作层(如 doctrine/orm、illuminate/database)
- 核心 SDK(如 aliyuncs/oss-sdk-php、wechat/php-sdk)
- 日志、缓存、http 客户端等运行时组件(如 monolog/monolog、guzzlehttp/guzzle)
执行 composer install 或 composer update 时,它们一定会被安装,且会随项目一起部署到生产服务器。
require-dev:只在你写代码时帮忙
这些包不参与业务逻辑,只服务开发流程,比如写测试、查 bug、规范代码。
- 测试框架:phpunit/phpunit、pestphp/pest
- 代码质量工具:phpstan/phpstan、friendsofphp/php-cs-fixer
- 调试辅助:yiisoft/yii2-debug、symfony/var-dumper
- 生成器与模拟器:fakerphp/faker、mockery/mockery
它们只在你本地或 CI 环境中用 composer install(不加参数)时才装。上线前加 –no-dev 就彻底跳过,既省空间又少风险。
autoload 和实际加载也跟着区分
composer 自动生成的 vendor/autoload.php 会注册 require 和 require-dev 的自动加载规则——但前提是那些包真的存在。
- 如果你用 –no-dev 部署,require-dev 的包没装,对应类文件就不存在
- 如果代码里不小心 new 了一个 PHPUnit 类,线上就会报 class not found
- 所以别在业务逻辑中引用 dev 工具类,哪怕 autoloader 看似支持
谁来决定装不装?看是不是“根项目”
require-dev 只对当前项目的 composer.json(即“根包”)生效。
- 你在自己的项目里加了 phpunit 到 require-dev,运行 composer install 就会装进 vendor/
- 但如果别人把你这个项目当依赖引入他的项目,他的 composer install 不会装你的 require-dev
- 也就是说,require-dev 不会“传染”,只服务于本项目开发
基本上就这些。不复杂但容易忽略细节。
以上就是Composer 中的 require 和 require-dev 有什么本质区别?的详细内容,更多请关注php中文网其它相关文章!