讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

剧云
剧云

中文短剧剧本制作平台

SoundView
SoundView

字幕擦除翻译、配音口型同步

Seko
Seko

AI短剧一键生成成片

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

梦涛君_7403

梦涛君_7403

发布时间:2026-03-19 17:41:31

|

698人浏览过

|

来源于php中文网

原创

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 冲突报错。

music-composer
music-composer

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

下载
  • 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。

另一个典型场景是 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 的 <extensions></extensions> 里引用了它,而 PHPUnit 启动时早于 autoloader 初始化

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

热门AI工具

更多
二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

笔灵降AI

一款AI论文写作工具,主要用于论文降AI神器,适配知网及维普!一键降至安全线,100%保留原文格式;无口语化问题,文风更学术,降后字数控制最佳!,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
PHP Symfony框架
PHP Symfony框架

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

6717

2025.09.11

laravel组件介绍
laravel组件介绍

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

897

2024.04.09

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

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

875

2024.04.09

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

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

2548

2024.04.09

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

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

5241

2024.04.10

laravel入门教程
laravel入门教程

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

7790

2025.08.05

laravel实战教程
laravel实战教程

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

5076

2025.08.05

laravel面试题
laravel面试题

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

9529

2025.08.05

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

0

2026.11.20

热门下载

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

精品课程

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

共0课时 | 0人学习

phpEnv手册
phpEnv手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn