Hyperf3.1 databases.php怎么配置MySQL连接-php教程-PHP中文网

Hyperf 3.1 MySQL 配置核心是 env() 读取 .env 变量、正确设置协程连接池参数、确保使用 swoole_mysql 协程客户端；需先确认 Swoole ≥5.0.0、安装 hyperf/database 与 db-connection、启用对应 Package。

hyperf3.1 databases.php怎么配置mysql连接

Hyperf 3.1 的 MySQL 连接配置核心是：用 env() 读取 .env 变量 + 正确设置协程连接池参数 + 确保底层驱动走 swoole_mysql 协程客户端。不是写死值，也不是直接套用 PDO 配置。

确保基础依赖和运行环境已就位

配置前先确认这三件事已满足，否则后续配置无效：

Swoole 扩展已安装且版本 ≥5.0.0（执行 php --ri swoole 查看，需显示 support coroutines: enabled）
项目已安装 hyperf/database 和 hyperf/db-connection（composer show hyperf/db-connection 可查）
config/autoload/packages.php 中 Hyperf\DbConnection\Package 已启用（默认开启，无需改动）

在 .env 文件中定义数据库变量

不要在 PHP 配置文件里硬编码。在项目根目录的 .env 文件中写入：

DB_DRIVER=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=hyperf_demo
DB_USERNAME=root
DB_PASSWORD=your_password
DB_CHARSET=utf8mb4
DB_COLLATION=utf8mb4_unicode_ci
DB_PREFIX=

注意：DB_HOST 推荐用 127.0.0.1 而非 localhost，避免 Unix socket 解析失败或 IPv6 冲突；所有值不加引号（如 DB_PASSWORD="123" 是错的）。

MySQL8 CRM Schema Design Expert

面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。

下载

修改 config/autoload/databases.php

打开该文件，找到 'mysql' => [ ... ] 配置块，按如下方式填写（关键字段含类型转换和连接池）：

'mysql' => [
  'driver' => env('DB_DRIVER', 'mysql'),
  'host' => env('DB_HOST', '127.0.0.1'),
  'port' => (int) env('DB_PORT', 3306),
  'database' => env('DB_DATABASE', 'hyperf'),
  'username' => env('DB_USERNAME', 'root'),
  'password' => env('DB_PASSWORD', ''),
  'charset' => env('DB_CHARSET', 'utf8mb4'),
  'collation' => env('DB_COLLATION', 'utf8mb4_unicode_ci'),
  'prefix' => env('DB_PREFIX', ''),
  'strict' => true,
  'pool' => [
    'min_connections' => 1,
    'max_connections' => 32,
    'connect_timeout' => 10.0,
    'wait_timeout' => 3.0,
    'heartbeat' => -1,
    'max_idle_time' => 60.0,
  ],
],

其中 max_connections 建议按预估 QPS × 平均查询耗时（秒）× 2 来设，一般 20–50 足够；min_connections 设为 1 可避免冷启动延迟。