require-dev是作用域声明而非环境开关,仅表示包用于开发阶段;是否安装取决于composer install是否加--no-dev参数,与APP_ENV无关。

require-dev 不是“开发环境开关”,而是作用域声明
很多人以为 require-dev 会随 APP_ENV=dev 自动生效,其实完全不是。Composer 没有环境感知能力,require-dev 只表示「这个包只在你本地写代码、跑测试、做构建时需要」,它和服务器上跑的是 dev 还是 prod 完全无关。
真正起作用的是安装命令:不加 --no-dev,require-dev 里的包就全装进 vendor/;加了,就跳过——部署脚本里漏掉这句,线上就会多出几十 MB 的 phpunit 或 roave/security-advisories,还可能因类名冲突直接报错。
-
phpunit/phpunit、laravel/pint、symfony/var-dumper必须放require-dev -
monolog/monolog、guzzlehttp/guzzle这类运行时必需的,绝不能放require-dev -
roave/security-advisories是个特例:它不提供任何类,只在composer install时做冲突拦截,必须放require-dev
CI/CD 里 composer install 必须带 --no-dev
GitHub Actions、GitLab CI 等流水线默认缓存 vendor/,但缓存键往往没包含 --no-dev 标志变化。结果就是:上次跑了 --no-dev,缓存里没 phpunit;这次忘了加参数,却复用了旧缓存,导致 Class 'PHPUnitFrameworkTestCase' not found。
安全做法是在 CI 脚本开头显式检查:ls -la composer.lock 确认 lock 文件存在且新鲜,再执行:
composer install --no-dev --optimize-autoloader
-
--no-dev:跳过require-dev,防止线上混入开发工具 -
--optimize-autoloader:生成 classmap,提升生产环境加载速度 - 别信“本地能跑 CI 就没问题”——CI 缓存机制和本地行为根本不同
想按 staging/prod 装不同依赖?别硬靠 require-dev
Composer 没有 require-staging 或环境条件语法。试图用 require-dev 区分预发和生产,只会让 composer.json 变成不可维护的谜题。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
真要差异化依赖,只有两个务实路径:
- 拆
composer.json:比如composer.prod.json,用COMPOSER=composer.prod.json composer install --no-dev指定(适合强隔离场景,但得同步维护两份 lock) - 下沉到代码层:定义接口(如
LoggerInterface),require里只放稳定基础实现(monolog/monolog),不同环境通过配置切换具体实现——这才是可测、可换、不锁死的方案
把环境逻辑塞进依赖声明,等于把部署问题提前到开发阶段,后期改起来比修祖传 SQL 还费劲。
autoload-dev 和自动加载的关系容易被忽略
autoload-dev 声明的命名空间(比如 "Example\Tests\": "tests/")只在开发时参与自动加载,但关键点在于:它不会出现在生产环境的优化 classmap 里——除非你手动执行 composer dump-autoload --optimize 且没加 --no-dev。
这意味着:
- 本地跑测试时,
tests/下的类能正常加载 - 线上即使误装了
require-dev包,autoload-dev路径也不会被注册进生产 autoloader - 但如果你在生产代码里写了
new ExampleTestsFooTest(),那不管有没有 autoload-dev,都得报错——这种写法本身就是 bug
最常被忽视的其实是 autoload-dev 和 require-dev 的配合:前者管「怎么加载」,后者管「装不装」,两者缺一不可,但又各自独立。

















