Hyperf 3.1 数据库主配置文件默认位于 config/autoload/database.php,通过 env() 动态读取 .env 中的 DB_HOST 等变量,支持多连接;关联文件包括 .env(环境源)、databases.php(连接池参数)和 params.php(可能提前初始化 DB 工厂),可用 php bin/hyperf.php config:show database 验证最终生效配置。

Hyperf 3.1 的数据库配置文件默认位于 config/autoload/database.php。
配置文件位置说明
该文件是框架加载数据库连接参数的主配置入口,由 env() 函数读取 .env 中的值(如 DB_HOST、DB_DATABASE 等),结构清晰、便于维护。
- 路径固定为项目根目录下的
config/autoload/database.php - 它不直接写死数据库信息,而是通过
env('DB_HOST', '127.0.0.1')这类方式动态获取 - 若使用多数据库,可在此文件中定义多个连接配置(如
'mysql_slave')
其他相关配置位置
除了主配置文件,还需注意以下关联项:
-
.env:位于项目根目录(与composer.json同级),是环境变量源头 -
config/autoload/databases.php:控制连接池行为(如max_idle_time、pool.max_connections) -
config/autoload/params.php:偶尔会在这里提前初始化 DB 工厂,可能影响配置加载时机
验证配置是否生效
运行以下命令可查看最终合并后的数据库配置:
php bin/hyperf.php config:show database
输出内容即为框架实际使用的完整配置,能直观确认 .env 值是否被正确注入、有无被硬编码覆盖。


















