Hyperf 3.0 实现多数据库连接需在 config/autoload/databases.php 的 connections 数组中显式声明多个唯一键名的完整连接配置，如 'slave1'、'pgsql_log'，键名须小写+数字+下划线，driver 值必须正确且区分实例；使用时通过 Db::connection('key') 或模型 $connection 属性显式指定，参数严格大小写敏感。

Hyperf 3.0 中实现多数据库连接，核心是在 config/autoload/databases.php 文件中显式声明多个命名连接配置，每个连接需独立、完整、可区分。不能只改一个 default，必须新增带唯一键名的连接项。

H3 多库配置必须写在 databases.php 的 connections 数组里
该文件默认返回一个包含 'default' 连接的数组。要支持多库，直接在 'connections' 下追加新键值对，例如：

return [
    'default' => [
        'driver' => env('DB_DRIVER', 'mysql'),
        'host' => env('DB_HOST', '127.0.0.1'),
        'port' => env('DB_PORT', 3306),
        'database' => env('DB_DATABASE', 'hyperf'),
        'username' => env('DB_USERNAME', 'root'),
        'password' => env('DB_PASSWORD', ''),
        'charset' => 'utf8mb4',
        'collation' => 'utf8mb4_unicode_ci',
        'fetch_mode' => PDO::FETCH_ASSOC,
        'pool' => [
            'min_connections' => 1,
            'max_connections' => 10,
            'connect_timeout' => 10.0,
            'wait_timeout' => 3.0,
            'max_idle_time' => 60.0,
        ],
    ],
    'slave1' => [  // ← 新增从库连接，键名小写、无特殊字符
        'driver' => env('SLAVE1_DRIVER', 'mysql'),
        'host' => env('SLAVE1_HOST', '192.168.1.100'),
        'port' => env('SLAVE1_PORT', 3306),
        'database' => env('SLAVE1_DATABASE', 'hyperf_slave'),
        'username' => env('SLAVE1_USERNAME', 'reader'),
        'password' => env('SLAVE1_PASSWORD', 'r3ad0nly'),
        'charset' => 'utf8mb4',
        'collation' => 'utf8mb4_unicode_ci',
        'fetch_mode' => PDO::FETCH_ASSOC,
        'pool' => [
            'min_connections' => 1,
            'max_connections' => 5,
            'connect_timeout' => 10.0,
            'wait_timeout' => 3.0,
            'max_idle_time' => 60.0,
        ],
    ],
    'pgsql_log' => [  // ← 可混用不同驱动，如 PostgreSQL
        'driver' => 'pgsql',
        'host' => env('LOG_PG_HOST', '127.0.0.1'),
        'port' => env('LOG_PG_PORT', 5432),
        'database' => env('LOG_PG_DATABASE', 'logdb'),
        'username' => env('LOG_PG_USERNAME', 'loguser'),
        'password' => env('LOG_PG_PASSWORD', ''),
        'charset' => 'utf8',
        'pool' => [
            'min_connections' => 1,
            'max_connections' => 3,
        ],
    ],
];

H3 键名和驱动必须合法且不冲突

• 键名（如 'slave1'、'pgsql_log'）必须是小写字母+数字+下划线，不能含点号、大写或空格；
• 每个连接的 'driver' 值必须明确，支持 'mysql'、'pgsql'、'sqlite'、'sqlsrv' 等，拼错会导致运行时报 Driver not supported；
• 不同连接可共用同一数据库类型，但必须指向不同实例（IP/端口/DB名），否则失去多库意义。

H3 使用时通过连接名显式指定
配置完后，代码中不自动切换，默认仍走 'default'。需主动调用：

• 查询：Db::connection('slave1')->table('user_log')->select();
• 模型绑定：在模型类中加 protected $connection = 'slave1';
• 事务：Db::connection('pgsql_log')->beginTransaction();

注意：Db::connection() 的参数必须与 databases.php 中定义的键名完全一致，大小写敏感，少一个字符就抛 Connection not found 异常。

hyperframes-超帧视频

HTML 驱动的视频合成——GSAP 动画、TTS 字幕、音频响应、着色器转场

下载

H3 别忘了环境变量和连接池隔离

• 推荐所有参数通过 env() 加载，便于不同环境切换；
• 多库建议配置独立连接池参数（如 max_connections），避免主库高并发挤占从库资源；
• 若使用 Redis 或其他组件做读写分离中间件，仍需在业务逻辑层控制路由，Hyperf 不自动分发 SQL。

不复杂但容易忽略

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！