AR(Active Record 活跃记录)
Yii 2.0 框架的 AR 类,是基于 ORM(Object Relation Mapping 对象关系映射)技术的,它提供了一个面向对象的接口, 用于访问数据库中的数据。
一个 AR 类关联一张数据表, 每个 AR 对象对应表中的一行,对象的属性(即 AR 的特性Attribute)映射到数据行的对应列。 一条活动记录(AR对象)对应数据表的一行,AR对象的属性则映射该行的相应列。 您可以直接以面向对象的方式来操纵数据表中的数据, 再也不用担心需要写原生的 SQL 语句了。
由于 AR 类 操作数据库的速度比 DAO 要慢,故后台管理系统可用 AR 操作,而前台页面最好用 DAO 操作。
示例:
以 Yii 2.0 基础版为例,高级版类似。
首先,在模型层 basic/models 目录下新建一个 UserAR.php 模型类,内容如下:
然后,在控制器层 basic/controllers 目录下新建一个 DemoController.php 控制器,用于测试,内容如下:
username = 'ar01';
$user->passwd = '123456';
$res = $user->save(); // 通过 new 创建AR对象时,save方法会执行插入操作
var_dump($res);
}
/**
* 查询记录
*/
public function actionQuery(){
/* // 查询多条记录
$res = UserAR::find()->where(array('>','id','3'))
->asArray()
->all();
echo json_encode($res); */
// 删除单条记录
/* // 第一种写法,操作符格式,较安全
$res = UserAR::find()->where(array('=','id','1'))
->asArray()
->one(); */
/* // 第二种写法,字符串+参数绑定 的形式,防止sql注入
$res = UserAR::find()->where('id=:id', array(':id'=>1))
->asArray()
->one(); */
// 第三种写法,数组的形式,较安全,推荐使用。(但仅限于多个 and 的 等值条件)
$res = UserAR::find()->where(array('id'=>1))
->asArray()
->one();
var_dump($res);
}
/**
* 更新记录
*/
public function actionUpdate(){
/* // 更新单条记录
$id = 1;
$user = UserAR::findOne($id);
// var_dump($user);exit;
$user->username = 'jack01';
$res = $user->save(); // 如果一个 AR 是由 find 获取的, 则 save() 会执行更新操作
var_dump($res); */
// 更新多条记录
$res = UserAR::updateAll(['passwd'=>'ar0001'], 'id>:id', ['id'=>5]); //更新id大于5的记录
var_dump($res);
/* // 增量或减量操作
$res = UserAR::updateAllCounters(['age'=>2], 'id>:id', array('id'=>5)); // id大于5的记录,age的值加2
var_dump($res); */
}
/**
* 删除记录
*/
public function actionDel(){
/* // 删除单条记录
$id = 13;
$user = UserAR::findOne($id);
if($user){
$res = $user->delete(); // 返回影响记录的行数
}else{
$res = '记录不存在!';
}
var_dump($res); */
// 删除多条记录
/* // 删除条件采用 字符串形式,并用参数绑定防止sql注入
$id = 8;
$res = UserAR::deleteAll('id > :id', [':id'=>$id]); // 删除 id 大于8的记录,返回影响记录的行数
var_dump($res); */
// 删除条件采用 操作符格式
$id = 10;
$res = UserAR::deleteAll(['>', 'id', $id]); // 删除 id 大于10的记录
var_dump($res);
}
/**
* 事务的支持,和 DAO 操作类似,这里不作详述
*/
public function trans(){
$db = \Yii::$app->db;
$trans = $db->beginTransaction();
try {
//...
$trans->commit();
return true;
} catch (\Exception $e) {
$trans->rollBack();
return false;
}
}
}
最后,在浏览器地址栏输入以下地址,查看对应的效果:
http://basic.com/demo/save
http://basic.com/demo/query
http://basic.com/demo/update
http://basic.com/demo/del