Yii Framework2.0开发教程（6）数据库mysql--ActiveRecord

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，可以看到数据库中多了一条记录

Yii Framework2.0开发教程（6）数据库mysql--ActiveRecord

查询数据

// 获取 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()]]

YII2 中文手册