require 是运行必需依赖,–no-dev 时仍安装;require-dev 仅开发使用,–no-dev 时完全不装。autoload 全环境生效,autoload-dev 仅开发启用。运行时依赖误放 require-dev 会导致线上崩溃。
require 和 require-dev 的安装行为差异
运行 composer install 时,默认会同时安装 require 和 require-dev 下的包;但执行 composer install --no-dev(常见于生产环境部署)时,require-dev 里的依赖**完全不会被下载或加载**,而 require 中的包始终生效。
这意味着:require 是项目运行所必需的依赖(比如 "monolog/monolog": "^2.0"),缺了就报 Class not found;require-dev 只服务于开发流程(比如 "phpunit/phpunit": "^9.5"),不参与线上逻辑执行。
autoload 和 autoload-dev 的对应关系
autoload 块定义的命名空间映射,在所有环境下都生效,供运行时自动加载;而 autoload-dev 仅在开发环境下启用——它通常用来注册测试类、示例代码或命令行工具的类路径,避免污染生产 autoloader。
常见误操作是把测试工具类写进 autoload,结果上线后多加载一堆无用文件,拖慢响应。正确做法:
- 业务核心类 → 放
autoload的"psr-4"或"classmap" - Tests/ 目录、Fixtures/、Commands/(非 runtime)→ 放
autoload-dev - 若某类既被测试调用又被业务调用,必须挪到
autoload,否则生产环境找不到
require-dev 里放运行时依赖的后果
把本该在 require 中声明的包(如 "symfony/console")错放到 require-dev,会导致: