CodeIgniter多库.env里不同组端口hostname怎么分别写-php教程-PHP中文网

codeigniter 4 默认仅支持 database.default.* 单库配置，但可通过 .env 前缀区分（如 db_primary_、db_log_）并在 app/config/database.php 中手动注册多组配置实现多库切换，使用时调用 database::connect('group') 即可。

codeigniter多库.env里不同组端口hostname怎么分别写

CodeIgniter 4 本身不支持 .env 文件中按“组”定义多套数据库配置（比如 db_primary、db_backup、db_log），它的默认数据库配置只认 database.default.* 下的键。但你可以通过手动扩展配置 + 多个数据库组定义来实现多库切换，.env 中需用约定前缀区分，再在 app/Config/Database.php 中读取并注册。

下面是具体做法：

✅ `.env` 文件里怎么写多个数据库配置

用清晰前缀（如 DB_PRIMARY_、DB_LOG_、DB_REPORT_）区分不同库，避免冲突：

# 主库
DB_PRIMARY_HOSTNAME = "192.168.1.10"
DB_PRIMARY_PORT = 3306
DB_PRIMARY_DATABASE = "myapp_main"
DB_PRIMARY_USERNAME = "user1"
DB_PRIMARY_PASSWORD = "pass1"
DB_PRIMARY_CHARSET = "utf8mb4"

# 日志库
DB_LOG_HOSTNAME = "192.168.1.11"
DB_LOG_PORT = 3307
DB_LOG_DATABASE = "myapp_logs"
DB_LOG_USERNAME = "logger"
DB_LOG_PASSWORD = "logpass"
DB_LOG_CHARSET = "utf8mb4"

# 报表库（可能是只读从库）
DB_REPORT_HOSTNAME = "192.168.1.12"
DB_REPORT_PORT = 3306
DB_REPORT_DATABASE = "myapp_reports"
DB_REPORT_USERNAME = "reporter"
DB_REPORT_PASSWORD = "reppass"
DB_REPORT_CHARSET = "utf8mb4"

⚠️ 注意：

不要写 DB_HOSTNAME 这类无前缀的通用键，否则会被默认组覆盖；

端口必须写数字（不能带引号），如 DB_PRIMARY_PORT = 3306，不是 "3306"；

Hostname 支持域名或 IP，也支持 localhost（但注意 PHP-FPM 下 localhost 可能走 socket，建议用 127.0.0.1 明确走 TCP）。

✅ 在 `app/Config/Database.php` 中注册多个组

打开该文件，找到 public $defaultGroup = 'default';，然后在 $DBGroups 数组里添加你定义的组：

CodeIgniter 4.7.0

CodeIgniter下载页提供 CodeIgniter 4.7.0 官方源码包，并整理框架安装、数据库配置与入门开发说明。

下载

public $DBGroups = [
    'default' => [
        'DSN'      => '',
        'hostname' => env('DB_PRIMARY_HOSTNAME', 'localhost'),
        'port'     => env('DB_PRIMARY_PORT', 3306),
        'username' => env('DB_PRIMARY_USERNAME', ''),
        'password' => env('DB_PRIMARY_PASSWORD', ''),
        'database' => env('DB_PRIMARY_DATABASE', ''),
        'DBDriver' => 'MySQLi',
        'DBPrefix' => '',
        'pConnect' => false,
        'DBDebug'  => (ENVIRONMENT !== 'production'),
        'charset'  => env('DB_PRIMARY_CHARSET', 'utf8mb4'),
        'DBCollat' => 'utf8mb4_general_ci',
        'swapPre'  => '',
        'encrypt'  => false,
        'compress' => false,
        'strictOn' => false,
        'failover' => [],
        'port'     => (int) env('DB_PRIMARY_PORT', 3306), // 强制转整型
    ],
    'log' => [
        'DSN'      => '',
        'hostname' => env('DB_LOG_HOSTNAME', 'localhost'),
        'port'     => (int) env('DB_LOG_PORT', 3307),
        'username' => env('DB_LOG_USERNAME', ''),
        'password' => env('DB_LOG_PASSWORD', ''),
        'database' => env('DB_LOG_DATABASE', ''),
        'DBDriver' => 'MySQLi',
        'DBPrefix' => '',
        'pConnect' => false,
        'DBDebug'  => (ENVIRONMENT !== 'production'),
        'charset'  => env('DB_LOG_CHARSET', 'utf8mb4'),
        'DBCollat' => 'utf8mb4_general_ci',
        'swapPre'  => '',
        'encrypt'  => false,
        'compress' => false,
        'strictOn' => false,
        'failover' => [],
    ],
    'report' => [
        'DSN'      => '',
        'hostname' => env('DB_REPORT_HOSTNAME', 'localhost'),
        'port'     => (int) env('DB_REPORT_PORT', 3306),
        'username' => env('DB_REPORT_USERNAME', ''),
        'password' => env('DB_REPORT_PASSWORD', ''),
        'database' => env('DB_REPORT_DATABASE', ''),
        'DBDriver' => 'MySQLi',
        'DBPrefix' => '',
        'pConnect' => false,
        'DBDebug'  => (ENVIRONMENT !== 'production'),
        'charset'  => env('DB_REPORT_CHARSET', 'utf8mb4'),
        'DBCollat' => 'utf8mb4_general_ci',
        'swapPre'  => '',
        'encrypt'  => false,
        'compress' => false,
        'strictOn' => false,
        'failover' => [],
    ],
];

✅ 在代码中使用指定数据库组

获取主库连接（默认）：
```
$db = \Config\Database::connect();
```

获取日志库连接：

$logDB = \Config\Database::connect('log');

获取报表库连接：

$reportDB = \Config\Database::connect('report');

在 Model 中指定连接组（可选）：
```
protected $DBGroup = 'log';
```

✅ 小贴士：端口和 hostname 的常见坑

如果某库用的是非标端口（如 3307），务必确认 MySQL 服务已监听该端口且防火墙放行；
hostname 写 localhost 时，MySQLi 驱动可能尝试 Unix socket，导致连接失败；生产环境建议统一用 127.0.0.1 或内网 IP；
所有 env() 调用都建议加默认值，防止 .env 缺失字段时报错；
修改 .env 后，不需要重启 Web 服务器，但 CLI 命令（如 spark migrate）会立即生效；Web 请求下次加载即生效。