08. Yii 2.0 数据库交互

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 模型类，内容如下：

  1  2  3  4  5  6  7  8  9 10 11 12 13 14

<?php
namespace app\models;
use yii\db\ActiveRecord;
class UserAR extends ActiveRecord {
    /**
     * 必须重写 tableName 方法，返回表名
     * @return string
     */
    public static function tableName(){
        return "{{%basic_user}}";    // 推荐这种写法，可支持数据库配置中的表前缀和跨数据库类型
    }
}

 来自CODE的代码片

snippet_file_0.php

然后，在控制器层 basic/controllers 目录下新建一个 DemoController.php 控制器，用于测试，内容如下：

   1   2   3   4   5   6   7   8   9  10  11  12  13  14  15  16  17  18  19  20  21  22  23  24  25  26  27  28  29  30  31  32  33  34  35  36  37  38  39  40  41  42  43  44  45  46  47  48  49  50  51  52  53  54  55  56  57  58  59  60  61  62  63  64  65  66  67  68  69  70  71  72  73  74  75  76  77  78  79  80  81  82  83  84  85  86  87  88  89  90  91  92  93  94  95  96  97  98  99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120

<?php
namespace app\controllers;
use yii\web\Controller;
use app\models\UserAR;
class DemoController extends Controller {
/*     数据输入与有效性验证    
    由于AR继承自yii\base\Model，所以它同样也支持Model的数据输入、验证等特性。例如，你可以声明一个rules方法用来覆盖掉yii\base\Model::rules()里的；你也可以给AR实例批量赋值；你也可以通过调用yii\base\Model::validate()执行数据验证。
    当你调用 save()、insert()、update() 这三个方法时，会自动调用yii\base\Model::validate()方法。如果验证失败，数据将不会保存进数据库。 */
    /**
     * 新增记录
     */
    public function actionSave(){
        $user = new UserAR();
        $user->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;
        }
    }
}

 来自CODE的代码片

snippet_file_0.php

最后，在浏览器地址栏输入以下地址，查看对应的效果：

http://basic.com/demo/save

http://basic.com/demo/query

http://basic.com/demo/update

http://basic.com/demo/del