autoload-dev用于定义开发环境的自动加载规则,如测试代码tests/目录,仅在开发时生效,不包含在生产环境中,提升性能与安全性。

autoload-dev 是 composer.json 中的一个配置字段,用于定义仅在开发环境下使用的自动加载规则。它和 autoload 的作用类似,都是告诉 Composer 如何自动加载 PHP 类文件,但关键区别在于使用场景。
只在开发时生效
autoload-dev 中配置的目录或文件不会包含在生产环境的自动加载中。这些通常是测试代码、单元测试辅助类、开发工具类等不需要上线部署的内容。
例如:
- 测试用例(如 PHPUnit 的 tests/ 目录)
- 本地开发脚本
- Mock 数据或测试桩(Stubs)
当你运行 composer install 且没有指定 --dev 时,autoload-dev 的内容将被忽略。
提升性能与安全
不把测试代码带到生产环境有两点好处:
- 减少不必要的文件加载,提高应用性能
- 避免暴露测试逻辑或敏感调试信息,增强安全性
Composer 在生成自动加载映射时,会根据环境决定是否包含 autoload-dev 定义的路径。
常见写法示例
{
"autoload": {
"psr-4": {
"App\\": "src/"
}
},
"autoload-dev": {
"psr-4": {
"App\\Tests\\": "tests/"
}
}
}
上面配置表示:
- App\ 命名空间对应 src/ 目录,用于项目主代码
- App\Tests\ 命名空间对应 tests/ 目录,仅开发时可用
这样在写单元测试时,可以直接 use App\Tests\ExampleTest,而不用担心这个路径出现在线上服务器中。
基本上就这些。合理使用 autoload-dev 能让项目结构更清晰,开发与生产环境职责分明。










