Yii2怎样连接数据库配置_Yii2连接数据库配置方法【数据库】

先说一个常见的问题：如果你在 Yii2 项目里突然发现数据库查不了，ActiveRecord 报了个“Unknown Component ID: db”的错误，十有八九是数据库连接没有正确注册到应用组件里。这事儿说大不大，但卡起人来也挺头疼。下面整理了五种配置数据库连接的方法，每种都有它的适用场景，你可以按需选择。

一、在 config/db.php 中单独定义并引入

这种方式的好处是，数据库配置集中在一起，切换和管理都更方便，尤其适合需要多环境部署的项目。具体操作分三步：

第一步，在 config/db.php 文件里写好标准的连接数组，返回包含 class、dsn、username、password 这些基础配置。

第二步，在 config/web.php 的 components 区域里，用 require 把它引进来：
'db' => require(__DIR__ . '/db.php'),

第三步，验证一下是否生效。随便找个控制器，执行 var_dump(Yii::$app->db);，如果返回的是 yii\db\Connection 实例对象，那就成了。

二、直接在 config/web.php 的 components 中内联配置

说白了，就是把所有参数直接写在主配置文件里。适合项目比较简单，或者你只想快速调试一把，不想再多折腾一个文件。打开 config/web.php，找到 components 数组，直接插入 db 键：

'db' => [
'class' => 'yii\db\Connection',
'dsn' => 'mysql:host=localhost;dbname=test;charset=utf8mb4',
'username' => 'root',
'password' => getenv('DB_PASSWORD') ?: 'root',
'charset' => 'utf8mb4',
],

注意，这段配置必须放在 components 数组内部，别被注释掉，也别被什么条件判断给包住了。

三、配置多个数据库连接

有时候一个项目需要同时访问多个数据库，比如业务库、日志库、统计库。这时候就得给每个连接分配一个唯一的组件 ID，比如 db2、logdb、statdb。各模型可以指定自己专属的连接。

在 config/web.php 的 components 里新增第二个连接项，ID 不能是 db，比如：

'logdb' => [
'class' => 'yii\db\Connection',
'dsn' => 'mysql:host=localhost;dbname=logs',
'username' => 'logger',
'password' => 'logpass',
],

然后在对应的模型类里重写 getDb() 方法，显式返回这个连接：

public static function getDb()
{
return Yii::$app->get('logdb');
}

这样一来，用 LogEntry::find()->all() 查数据时，自动走的就是 logdb 连接了。

四、配置主从分离数据库

如果项目流量比较大，读写分离就派上用场了。所有写操作走主库，读操作按策略分配到从库，能明显提升数据库的吞吐能力。Yii2 原生支持这个模式，不用额外装扩展。

在 components 里定义一个 db 组件，class 还是 yii\db\Connection，但结构需要升级一下，加上 masters 和 sla ves 配置：

'masters' => [[
'dsn' => 'mysql:host=master1;dbname=app',
'username' => 'rw_user',
'password' => 'rw_pass',
]],

'sla ves' => [[
'dsn' => 'mysql:host=sla ve1;dbname=app',
'username' => 'ro_user',
'password' => 'ro_pass',
], [
'dsn' => 'mysql:host=sla ve2;dbname=app',
'username' => 'ro_user',
'password' => 'ro_pass',
]],

配置好之后，执行 find()、count() 这类读操作时，Yii2 会自动路由到从库；执行 sa ve()、delete() 这类写操作时，强制走主库。省心省力。

五、通过环境变量动态注入敏感凭证

把数据库密码硬编码在配置文件里，始终不是个好习惯。更专业的做法是用环境变量来传递敏感信息，做到配置与凭证分离。

在服务器或者本地环境里设置环境变量，比如 Linux 下执行：
export DB_PASSWORD="my_secure_pass"

然后在数据库配置里用 getenv() 获取：

'password' => getenv('DB_PASSWORD') ?: 'root',

生产环境部署前，务必确认环境变量已经通过运维流程注入，配置文件中不能有明文密码残留。这才是真正的专业做法。