08. Yii 2.0 数据库交互 - AR

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