Active Record(活动记录,以下简称AR)提供了一个面向对象的接口,用以访问数据库中的数据。
一个AR 类关联一张数据表,每个 AR 对象对应表中的一行,对象的属性(即 AR 的特性Attribute)映射到数据行的对应列。
一条活动记录(AR对象)对应数据表的一行,AR对象的属性则映射该行的相应列。
您可以直接以面向对象的方式来操纵数据表中的数据,妈妈再不用担心我需要写原生 SQL 语句啦。
编辑models/Country.php
- <?php
- namespace app\models;
- use yii\db\ActiveRecord;
- //你不用在里面写任何代码。只需要像现在这样,Yii 就能根据类名去猜测对应的数据表名。
- class Country extends ActiveRecord
- {
- }
或者
- <?php
- namespace app\models;
- use yii\db\ActiveRecord;
- //你不用在里面写任何代码。只需要像现在这样,Yii 就能根据类名去猜测对应的数据表名。
- class Country extends ActiveRecord
- {
- //@return string 返回该AR类关联的数据表名
- public static function tableName()
- {
- return 'country';
- }
- }
编辑views/zhyoulun/helloworld.php
- <?php
- $country = new \app\models\Country;
- $country->code = 'ZZ';
- $country->name = 'Youlun';
- $country->population = '1';
- $country->save();
- ?>
访问网页http://localhost/basic/web/index.php?r=zhyoulun/helloworld,可以看到数据库中多了一条记录
查询数据
- // 获取 country 表的所有行并以 name 排序
- $countries = Country::find()->orderBy('name')->all();
- echo '<table border="1">';
- for($i=0;$i<count($countries);$i++)
- {
- echo '<tr>';
- echo '<td>'.$countries[$i]['code'].'</td>';
- echo '<td>'.$countries[$i]['name'].'</td>';
- echo '<td>'.$countries[$i]['population'].'</td>';
- echo '</tr>';
- }
- echo '</table>';
- // 用原生 SQL 语句检索客户:
- $sql = 'SELECT * FROM customer';
- $customers = Customer::findBySql($sql)->all();
以数组形式获取数据
- // 以数组而不是对象形式取回客户信息:
- $customers = Customer::find()
- ->asArray()
- ->all();
- // $customers 的每个元素都是键值对数组
批量获取数据
- // 一次提取 10 个客户信息
- foreach (Customer::find()->batch(10) as $customers) {
- // $customers 是 10 个或更少的客户对象的数组
- }
- // 一次提取 10 个客户并一个一个地遍历处理
- foreach (Customer::find()->each(10) as $customer) {
- // $customer 是一个 ”Customer“ 对象
- }
- // 贪婪加载模式的批处理查询
- foreach (Customer::find()->with('orders')->each() as $customer) {
- }
操作数据(AR 提供以下方法插入、更新和删除与 AR 对象关联的那张表中的某一行)
[[yii\db\ActiveRecord::save()|save()]]
[[yii\db\ActiveRecord::insert()|insert()]]
[[yii\db\ActiveRecord::update()|update()]]
[[yii\db\ActiveRecord::delete()|delete()]]
- // 插入新客户的记录
- $customer = new Customer();
- $customer->name = '詹姆斯';
- $customer->email = '007@example.com';
- $customer->save(); // 等同于 $customer->insert();
- // 更新现有客户记录
- $customer = Customer::find($id);
- $customer->email = '邦德@demo.com';
- $customer->save(); // 等同于 $customer->update();
- // 删除已有客户记录
- $customer = Customer::find($id);
- $customer->delete();
AR 同时提供了一下静态方法,可以应用在与某 AR 类所关联的整张表上。 用这些方法的时候千万要小心,因为他们作用于整张表! 比如,deleteAll() 会删除掉表里所有的记录。
[[yii\db\ActiveRecord::updateCounters()|updateCounters()]]
[[yii\db\ActiveRecord::updateAll()|updateAll()]]
[[yii\db\ActiveRecord::updateAllCounters()|updateAllCounters()]]
[[yii\db\ActiveRecord::deleteAll()|deleteAll()]]