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 中的数据库操作。注意合理使用模型验证、作用域和关系关联,能让代码更清晰健壮。










