Yii2数据库操作详解及CURD教程

Yii2通过ActiveRecord和QueryBuilder实现数据库操作。首先配置db组件连接数据库，然后创建继承ActiveRecord的模型类。插入数据使用new实例并调用save()；查询可用findOne、findAll或find()->where()等方法；更新调用对象save()或静态updateAll()；删除用delete()或deleteAll()。复杂查询推荐QueryBuilder，通过select/from/where构建语句，执行原生SQL用createCommand。事务处理通过beginTransaction/commit/rollback确保数据一致性。合理使用模型验证与关联提升代码质量。

Yii2 提供了强大的数据库操作支持，通过 ActiveRecord（AR）和 Query Builder 两种方式实现常见的增删改查（CURD）操作。下面详细介绍如何在 Yii2 中进行数据库的基本操作。

配置数据库连接

在使用数据库前，先在 config/db.php 或 common/config/main-local.php 中配置数据库连接信息：

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

确保数据库已创建，并可通过该配置正常连接。

使用 ActiveRecord 实现 CURD

ActiveRecord 是 Yii2 中最常用的模型类，用于映射数据表并提供便捷的数据库操作方法。

1. 创建模型
使用 Gii 工具或手动创建一个继承自 yii\db\ActiveRecord 的模型，例如 User.php：

class User extends \yii\db\ActiveRecord
{
    public static function tableName()
    {
        return 'user';
    }
}

2. 插入数据（Create）

$user = new User();
$user->username = 'john';
$user->email = 'john@example.com';
$user->created_at = time();
$user->save(); // 返回布尔值表示是否成功

3. 查询数据（Read）

• 查询单条记录：User::findOne(1) 或 User::find()->where(['username' => 'john'])->one()
• 查询多条记录：User::findAll([1, 2, 3]) 或 User::find()->all()
• 带条件查询：User::find()->where(['>', 'id', 10])->orderBy('id DESC')->limit(5)->all()

4. 更新数据（Update）

• 更新对象：$user->email = 'new@example.com'; $user->save();
• 批量更新：User::updateAll(['status' => 1], ['status' => 0]);

5. 删除数据（Delete）

• 删除对象：$user->delete();
• 批量删除：User::deleteAll(['status' => 0]);

使用 Query Builder 操作数据库

Query Builder 更适合复杂查询或不希望通过模型操作的场景。

use yii\db\Query;
$query = new Query();
$query->select(['id', 'username', 'email'])
->from('user')
->where(['status' => 1])
->orderBy('id DESC')
->limit(10);
$rows = $query->all();

执行原生 SQL 可使用 createCommand：

Yii::$app->db->createCommand("INSERT INTO user (username, email) VALUES (:username, :email)")
    ->bindValue(':username', 'jane')
    ->bindValue(':email', 'jane@example.com')
    ->execute();

查询示例：

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

事务处理

对于需要保证一致性的操作，使用事务：

$db = Yii::$app->db;
$transaction = $db->beginTransaction();
try {
$user = new User();
$user->username = 'alice';
$user->save();
// 其他操作...

$transaction->commit();
} catch (\Exception $e) {
$transaction->rollBack();
throw $e;
}

基本上就这些。掌握 ActiveRecord 和 Query Builder 的基本用法，就能高效完成 Yii2 中的数据库操作。注意合理使用模型验证、作用域和关系关联，能让代码更清晰健壮。