Hyperf MySQL多实例创建数据库连接配置代码-php教程-PHP中文网

hyperf支持为多个mysql实例（含不同版本、地址、账号）分别配置独立连接池，需在databases.php中为每个实例定义唯一连接名、显式驱动参数及独立pool配置，禁止混用；运行时通过db::connection()或模型$connection属性切换，动态配置可通过configinterface热更新。

hyperf mysql多实例创建数据库连接配置代码

Hyperf 支持为多个 MySQL 实例（包括不同版本、不同地址、不同账号）分别创建独立数据库连接，关键在于 每个实例单独定义连接名 + 完整驱动与池配置，不能复用同一连接池混接差异大的实例。

1. 在 config/autoload/databases.php 中定义多个 MySQL 实例连接

每个连接需有唯一 name，显式声明 driver、host、port、database、认证参数，以及独立的 pool 配置：

mysql_v57_rds：MySQL 5.7 阿里云 RDS 实例，使用 mysql_native_password 认证
mysql_v80_local：本地 MySQL 8.0 实例，启用 caching_sha2_password，关闭预处理模拟
mysql_v80_proxy：ProxySQL 后端分片集群，连接池 max_connections 按实际承载调低

示例配置：

'connections' => [
    'mysql_v57_rds' => [
        'driver' => 'mysql',
        'host' => 'rm-xxx.mysql.rds.aliyuncs.com',
        'port' => 3306,
        'database' => 'app_core',
        'username' => 'core_user',
        'password' => 'pwd123',
        'charset' => 'utf8mb4',
        'collation' => 'utf8mb4_unicode_ci',
        'prefix' => '',
        'pool' => [
            'min_connections' => 2,
            'max_connections' => 30,
            'connect_timeout' => 5.0,
            'wait_timeout' => 5.0,
            'max_idle_time' => 30.0,
        ],
        'options' => [
            \PDO::ATTR_EMULATE_PREPARES => true,
        ],
    ],

    'mysql_v80_local' => [
        'driver' => 'mysql',
        'host' => '127.0.0.1',
        'port' => 3307,
        'database' => 'dev_analytics',
        'username' => 'ana_user',
        'password' => 'pwd456',
        'charset' => 'utf8mb4',
        'collation' => 'utf8mb4_0900_ai_ci',
        'prefix' => 'ana_',
        'pool' => [
            'min_connections' => 1,
            'max_connections' => 20,
            'connect_timeout' => 5.0,
            'wait_timeout' => 5.0,
            'max_idle_time' => 30.0,
        ],
        'options' => [
            \PDO::MYSQL_ATTR_SSL_MODE => \PDO::SSL_NONE,
            \PDO::ATTR_EMULATE_PREPARES => false,
        ],
    ],

    'mysql_v80_proxy' => [
        'driver' => 'mysql',
        'host' => 'proxy.internal',
        'port' => 6033,
        'database' => 'shard_orders',
        'username' => 'shard_rw',
        'password' => 'pwd789',
        'charset' => 'utf8mb4',
        'collation' => 'utf8mb4_unicode_ci',
        'prefix' => '',
        'pool' => [
            'min_connections' => 3,
            'max_connections' => 40,
            'connect_timeout' => 3.0,
            'wait_timeout' => 3.0,
            'max_idle_time' => 20.0,
        ],
        'options' => [
            \PDO::ATTR_EMULATE_PREPARES => false,
        ],
    ],
],

2. 运行时按需切换连接

不修改配置文件，直接在代码中指定连接名即可操作对应实例：

Hyperframes Creative

HyperFrames视频非动画创意指导，包括设计规范（frame.md/design.md）处理、配色、字体设计、旁白及节奏规划等。

下载

Query Builder：用 Db::connection('mysql_v57_rds')->table(...)
Eloquent 模型：在模型类中设置 protected $connection = 'mysql_v80_local';
事务：用 Db::connection('mysql_v80_proxy')->transaction(...)

3. 注意事项

避免常见错误：

不同 MySQL 大版本（如 5.7 vs 8.0）必须分连接池，不可共用一个 connection 名
每个连接的 pool.max_connections 应 ≤ 对应实例的 max_connections（留余量）
RDS 或云数据库建议显式设 charset 和 collation，避免建表或查询乱码
若出现 Too many connections，优先检查各连接池的 max_connections 总和是否超 DB 限制

4. 动态更新连接配置（灰度/热切场景）

启动后可通过 ConfigInterface 修改内存中连接配置，无需重启：

use Hyperf\Contract\ConfigInterface;
use Psr\Container\ContainerInterface;

$container->get(ConfigInterface::class)->set(
    'databases.connections.mysql_v57_rds.host',
    'rm-new.xxx.mysql.rds.aliyuncs.com'
);

适用于 A/B 测试、数据库迁移过渡期等场景。