首先配置数据库连接，再通过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、用户名、密码正确，并合理使用模型和查询构造器。
