Yii框架数据库配置详解

文章小白一枚，正在不断学习积累知识，现将学习到的知识记录一下，也是将我的所得分享给大家！而今天这篇文章《Yii框架数据库配置教程》带大家来了解一下##content_title##，希望对大家的知识积累有所帮助，从而弥补自己的不足，助力实战开发！

首先配置数据库连接，再通过ActiveRecord或Query Builder实现增删改查。在config/web.php中设置'db'组件的DSN、用户名、密码和字符集，确保PDO扩展启用；用Gii生成继承ActiveRecord的模型类；通过find()、save()、delete()等方法操作数据；支持原生SQL与参数绑定防止注入；可配置多个数据库连接并在模型中指定使用。

在使用 Yii 框架开发 Web 应用时，数据库的配置和操作是核心环节。Yii 提供了强大的数据库抽象层（通过 ActiveRecord 和 Query Builder），让开发者可以高效地进行数据操作。下面详细介绍如何在 Yii 框架中配置数据库连接，并进行基本的数据库操作。

1. 配置数据库连接信息

Yii 使用 components 来定义数据库连接。配置文件通常位于 config/db.php 或直接写在 config/web.php 中。

打开你的项目配置文件（如 config/web.php），找到 'components' 数组，添加或修改 'db' 配置：

'db' => [
    'class' => 'yii\db\Connection',
    'dsn' => 'mysql:host=localhost;dbname=yii2_test',  // 数据库类型、主机、数据库名
    'username' => 'root',                              // 数据库用户名
    'password' => '123456',                            // 数据库密码
    'charset' => 'utf8mb4',                            // 字符编码
],

说明：

• dsn：数据源名称，格式为 数据库类型:host=主机;dbname=数据库名，支持 MySQL、PostgreSQL、SQLite 等。
• username / password：数据库登录凭证。
• charset：推荐使用 utf8mb4 支持 emoji 表情等特殊字符。

确保 PHP 已启用 PDO 扩展（如 pdo_mysql），否则会报错。

2. 测试数据库连接

可以在控制器或入口脚本中测试数据库是否连接成功：

use Yii;
try {
Yii::$app->db->open();
echo "数据库连接成功！";
} catch (\Exception $e) {
echo "连接失败：" . $e->getMessage();
}

如果输出“连接成功”，说明配置无误。

3. 创建模型（Model）

Yii 推荐使用 Gii 工具自动生成模型类。假设有一张表 user，可通过以下步骤生成模型：

• 访问 http://your-site/index.php?r=gii
• 点击 “Model Generator”
• 输入表名（如 user）
• 生成对应的 Model 类（如 User.php）

生成的模型会继承 ActiveRecord，可直接用于数据库操作。

4. 使用 ActiveRecord 进行数据库操作

ActiveRecord 是 Yii 实现 ORM 的核心类，支持面向对象方式操作数据库。

查询数据：

// 查找所有用户
$users = User::find()->all();
// 查找 ID 为 1 的用户
$user = User::findOne(1);
// 条件查询
$user = User::find()->where(['name' => 'John'])->one();
// 查询多条
$users = User::find()->where(['status' => 1])->orderBy('id')->all();

插入数据：

$user = new User();
$user->name = 'Alice';
$user->email = 'alice@example.com';
$user->created_at = time();
$user->save(); // 成功返回 true

更新数据：

$user = User::findOne(1);
if ($user) {
    $user->email = 'newemail@example.com';
    $user->save();
}

删除数据：

$user = User::findOne(1);
$user->delete();
// 或批量删除
User::deleteAll(['status' => 0]);

5. 使用原生 SQL 查询（Query Builder）

对于复杂查询，可使用 Query Builder 构建安全的 SQL：

use yii\db\Query;
$query = new Query();
$query->select(['id', 'name'])
->from('user')
->where(['status' => 1])
->orderBy('id');
$command = $query->createCommand();
$rows = $command->queryAll();

也可直接执行原生 SQL：

$sql = "SELECT * FROM user WHERE status = :status";
$users = Yii::$app->db->createCommand($sql)
             ->bindValue(':status', 1)
             ->queryAll();

使用参数绑定防止 SQL 注入。

6. 配置多个数据库连接（可选）

若需连接多个数据库，可在 components 中定义多个 db 组件：

'db1' => [
    'class' => 'yii\db\Connection',
    'dsn' => 'mysql:host=localhost;dbname=db1',
    'username' => 'root',
    'password' => '123456',
    'charset' => 'utf8mb4',
],
'db2' => [
    'class' => 'yii\db\Connection',
    'dsn' => 'mysql:host=localhost;dbname=db2',
    'username' => 'root',
    'password' => '123456',
    'charset' => 'utf8mb4',
],

在模型中指定使用哪个连接：

public static function getDb()
{
    return Yii::$app->db2; // 使用 db2
}

基本上就这些。配置好数据库后，结合 Gii 和 ActiveRecord，能快速完成增删改查操作。关键是确保 DSN、用户名、密码正确，并合理使用模型和查询构造器。

本篇关于《Yii框架数据库配置详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！