composer怎么创建开发依赖_composer怎么安装require-dev【方法】

梦涛君_7403

梦涛君_7403

2026-03-19

698人浏览

原创

composer require --dev 是安装开发依赖的正确命令,它将包写入 require-dev 并立即安装;composer install --dev 不存在,composer install 默认安装 require-dev,但 CI 或生产环境需加 --no-dev 避免冗余和冲突。

composer怎么创建开发依赖_composer怎么安装require-dev【方法】

composer require --dev 安装开发依赖的正确写法

直接用 composer require --dev 就行,不是 composer install --dev,后者根本不存在——composer install 本身不接受 --dev 参数,它只按 composer.json 里已有的 require-dev 字段来装。

常见错误是以为加了 --dev 就能“临时启用 dev 依赖”,其实它只控制「把包写进 require-dev 并立刻安装」这个动作。

  • composer require --dev phpunit/phpunit:写入 require-dev 并安装
  • composer require phpunit/phpunit(没加 --dev):写入 require,变成生产依赖
  • 如果项目已提交过 composer.lock,且你本地没删过 vendor/,执行 require --dev 后会立即生效,不需要再跑 composer install

require-dev 和 require 的实际区别不止是“要不要上线”

关键差异在安装行为和 CI 环境处理上:默认 composer install 会装 require-dev,但 CI 脚本常加 --no-dev 跳过它;而 composer update 默认仍会更新 require-dev 里的包,除非显式加 --no-dev。

这意味着:本地开发时 phpstan、pest 这类工具在 require-dev 里很安全;但一旦误放进 require,上线部署时就可能多拉一个 50MB 的静态分析工具,还可能因 autoload 冲突报错。

  • require-dev 中的包不会被 autoload 到生产环境自动加载器里(除非你手动配了 autoload-dev)
  • 但它的类仍可能被 require 或 include 显式加载——所以别在 src/ 里直接 new PhpUnitRunnerVersion()
  • 某些包(比如 symfony/var-dumper)在 require-dev 里,但你在 config/dev/debug.php 里用了它,那 dev 环境没问题,prod 环境就会 Class not found

composer install --no-dev 在哪些场景下必须加

不是“上线才加”,而是只要运行环境不需要 dev 包,就得加。比如 Laravel 的 artisan optimize:clear 在生产环境跑,如果没加 --no-dev,可能会因为 phpunit 的 autoloader 规则干扰而报 Cannot declare class PHPUnitTextUIResultPrinter。

music-composer
music-composer

专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。

下载

另一个典型场景是 Docker 构建:多阶段构建中,build 阶段装了所有依赖,但 final 阶段应该只复制 vendor/ 并加 --no-dev 重装,否则镜像里混进一堆测试工具,体积翻倍还带安全隐患。

  • CI 流水线跑测试前一般不加 --no-dev(要跑 PHPUnit)
  • CI 打包生产镜像时必须加 --no-dev
  • Laravel APP_ENV=production 下,composer install 建议始终加 --no-dev,哪怕你没在代码里用它——避免 autoload 冲突和意外加载

require-dev 里放错东西的典型错误现象

最常踩的坑不是“装不上”,而是“装上了但出问题”:比如把 laravel/sail 放进 require-dev,本地 ./vendor/bin/sail up 没问题;但某天同事在没装 Docker 的机器上跑 composer install,结果卡在 exec: "docker": executable file not found —— 因为 sail 的 post-install-cmd 脚本被触发了,而它不在 require-dev 的“仅开发”语义里,属于基础设施依赖,该放 require 或干脆不走 Composer 安装。

  • Class 'NunoMaduroCollisionAdaptersLaravelCollisionServiceProvider' not found:Collision 放 require-dev,但 app.providers 里写了它,prod 环境崩
  • Target class [TestsTestCase] does not exist:自定义测试基类放在 tests/,但 autoload-dev 没配 "psr-4": {"Tests\": "tests/"}
  • PHP Fatal error: Uncaught Error: Class 'MockeryAdapterPhpunitMockeryPHPUnitIntegration':Mockery 在 require-dev,但 phpunit.xml 的 里引用了它,而 PHPUnit 启动时早于 autoloader 初始化

dev 依赖不是“随便放的垃圾桶”,它和你的加载顺序、环境变量、甚至 shell 命令执行时机都咬得很死。一个没注意,就是半夜收到告警说线上日志里刷满了 class not found。

相关专题

更多
PHP Symfony框架
PHP Symfony框架

本专题专注于PHP主流框架Symfony的学习与应用,系统讲解路由与控制器、依赖注入、ORM数据操作、模板引擎、表单与验证、安全认证及API开发等核心内容。通过企业管理系统、内容管理平台与电商后台等实战案例,帮助学员全面掌握Symfony在企业级应用开发中的实践技能。

2025.09.11

6717

17

laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2024.04.09

897

10

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

2024.04.09

875

9

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2024.04.09

2548

10

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.10

5241

7

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

2025.08.05

7790

22

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

2025.08.05

5076

13

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

2025.08.05

9529

7

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

2026.03.04

1556

29

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpMyAdmin 安装文档
phpMyAdmin 安装文档

共0课时 | 0人学习

phpEnv手册
phpEnv手册

共0课时 | 0人学习