Composer如何设置require和require-dev_Composer开发依赖区分说明-composer-PHP中文网

应使用 composer require --dev phpunit/phpunit 正确安装 phpunit 到 require-dev，避免误入 require 导致生产环境 class 'phpunitramework estcase' not found；同时需配置 autoload-dev 并运行 composer dump-autoload。

composer如何设置require和require-dev_composer开发依赖区分说明

生产环境报 Class 'PHPUnitFrameworkTestCase' not found？不是 Composer 没装对，是你没搞清 require 和 require-dev 的边界在哪——它们不按 APP_ENV 自动切换，只认命令里有没有 --no-dev。

composer require --dev 和 composer require 写错位置的后果

少一个空格、多一个连字符，就可能把测试工具塞进生产环境：

composer require --dev phpunit/phpunit → 正确：写入 composer.json 的 require-dev 字段，composer install --no-dev 会跳过
composer require-dev phpunit/phpunit → 错误：Composer 不识别该子命令，实际执行的是 composer require dev（把字符串 dev 当成包名），极可能触发意外行为
composer require phpunit/phpunit → 更危险：直接写进 require，上线后 vendor/autoload.php 会尝试加载它，但文件不存在，必报 Class not found

补救方式：手动删 composer.json 中 require 下那行，再运行 composer update phpunit/phpunit（此时它已不在 require，update 会移除）。

为什么 --no-dev 部署后还报错？常见三类代码层泄漏

require-dev 包不装，不代表代码里调用它就安全。只要运行时执行到相关语句，autoload 就会失败：

在 config/app.php 或 bootstrap/app.php 里用了 class_exists('PhpCsFixerFixerLineEndingLineEndingFixer') —— 这个函数会触发 autoload，而类根本不存在
控制器或服务中写了临时调试代码，比如 new SymfonyComponentVarDumperVarDumper()，但 symfony/var-dumper 在 require-dev
测试专用的 mock 类（如 MockeryMockInterface）被漏写进 autoload-dev，CI 报错找不到类，而非本地

安全做法：用 interface_exists() 或 function_exists() 替代 class_exists()；更稳妥的是把所有 dev 工具逻辑包裹在 if (app()->environment('local')) { ... } 中。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

autoload-dev 不是给 require-dev 包用的，是给你自己用的

很多人以为 autoload-dev 是让 phpunit/phpunit 自己能自动加载，其实完全相反：

autoload-dev 是告诉 Composer：“当本项目启用了 dev 模式（即装了 require-dev 包）时，请额外把我的测试目录（如 tests/）也加进自动加载规则”
它和 require-dev 的包本身无关，不负责加载 PHPUnit 的类，只负责加载你写的测试类
漏配 autoload-dev，会导致 phpunit 命令能跑，但你的 tests/ExampleTest.php 找不到类，报 Class not found

典型配置："autoload-dev": { "psr-4": { "Tests\": "tests/" } }，然后记得运行 composer dump-autoload 生效。

CI/CD 流水线里最常踩的缓存坑

GitHub Actions 或 GitLab CI 跑 composer install 后提示 Class 'PHPUnitFrameworkTestCase' not found，但本地好好的？大概率是缓存复用了上一次带 --no-dev 的 vendor/：

缓存键没包含 --no-dev 标志变化，导致本该装 phpunit 的 job 复用了没装它的缓存
解决办法：在缓存 key 中显式加入标志，例如 composer-${{ hashFiles('**/composer.lock') }}-${{ env.COMPOSER_NO_DEV }}
或者干脆在 CI 脚本里统一用 composer install --no-interaction（默认装 require-dev）+ composer install --no-dev --no-interaction（部署前清理）

真正容易被忽略的是：Composer 从不读取 APP_ENV、COMPOSER_ENV 或服务器 hostname，它只看命令参数。不加 --no-dev，require-dev 就照装不误——线上多出 20MB、启动变慢、甚至暴露 _debug 接口，都是这么来的。