@a5635268 2016-02-06T13:10:08.000000Z 字数 26678 阅读 1904

Yii框架之MVC

源码分析与使用笔记

MVC

控制器

<?php
namespace app\controllers;
use yii\web\Controller;
use app\models\EntryForm;
class IndexController extends Controller
{
  private $query;
  public function init(){
    parent::init();
    $this -> query = new \yii\db\Query();
  }
  //r=Index/hello
  public function actionHello($name = 'world'){
    return $this->render('hello', ['name' => $name]);
  }
  // yiibasc.com/index.php?r=index/mvc
  public function actionMvc(){
    /*
     * * 关于C层的概念 * *
     * 1. 参数可以为数组类型：参数 $id 会使用数组值 ['123'] ， 如果请求为 http://hostname/index.php?r=post/view&id=123 ， 参数 $id 会获取相同数 组值，因为无类型的 '123' 会自动转成数组。
     * 2. 控制器ID的实现方式是大驼峰，但真正访问时变成小写+连字符
     * 3. 可以通过yii\base\Application::controllerMap或者配置文件中建立类的映射关系。
     * 4. 在控制器创建和配置后，yii\base\Controller::init() 方法会被调用。
     * 5. 默认情况下每个 beforeAction() 方法会触发一个 beforeAction 事件，在事件中你可以追加事 件处理操作；同理还有一个afterAction。
     * 6. 在设计良好的应用中，控制器很精练，包含的操作代码简短； 如果你的控制器很复杂，通常意味着需要重 构，转移一些代码到其他类中。
     */
    /* 关于c层的疑问：
     * 1. 独立操作actions是什么概念，有什么用？
     */
    $model = new EntryForm;
    $request = \Yii::$app->request;
    if($request -> isPost){
      $post = $request -> post();
      $model -> doTest($post);
    }
    //Html::encode($name)
    return $this->render('entry', ['model' => $model]);
  }
}

模型

dataAccessObjects

http://www.yiichina.com/doc/guide/2.0/db-dao

public function dataAccessObjects(){
    $connection = \Yii::$app->db;
    # 执行select语句
    //1. 返回所有
    $command = $connection->createCommand('SELECT * FROM sc_hospital');
    $data = $command->queryAll();
    //2. 返回单行
    $command = $connection->createCommand('SELECT * FROM sc_hospital order by rand()');
    $data = $command->queryOne();
    //3. 返回多行单值
    $command = $connection -> createCommand('SELECT name FROM sc_hospital');
    $data = $command -> queryColumn();
    //4. 返回标量值/计算值
    $command = $connection -> createCommand('SELECT count(*) FROM sc_hospital');
    $data = $command -> queryScalar();
    # 执行DML语句
    $command = $connection->createCommand('update sc_hospital set name = "刚哥医院" WHERE hosp_id = 7');
    $res = $command->execute(); //成功返回true；
    //insert
    $res = $connection->createCommand()->insert('sc_hospital', [
      'name' => '和平医院',
      'region_id' => 2,
    ])->execute();
    //一次插入多行
    $res = $connection->createCommand()->batchInsert('sc_hospital', ['name', 'region_id'], [
      ['长寿医院', 30],
      ['北京医院', 20],
      ['上海第一医院', 25],
    ])->execute(); //返回插入的条数
    // UPDATE
    $connection->createCommand()->update('user', ['status' => 1], 'age > 30')->execute();
    // DELETE
    $connection->createCommand()->delete('user', 'status = 0')->execute();
    //{{%hospital}} 自动增加前缀
    $sql = "SELECT COUNT('hosp_id') FROM {{%hospital}}";
    $rowCount = $connection->createCommand($sql)->queryScalar();
    //安全的返回表名或列名
    $column = $connection->quoteColumnName('hosp_id');
    $table = $connection->quoteTableName('{{%hospital}}');
    $sql = "SELECT COUNT($column) FROM $table";
    $rowCount = $connection->createCommand($sql)->queryScalar();
    //预处理语句（防注入）
    $command = $connection->createCommand('SELECT * FROM post WHERE id=:id');
    $command->bindValue(':id', $_GET['id']);
    $post = $command->query();
    //在执行前绑定变量，然后在每个执行中改变变量的值（一般用在循环中）比较高效.
    $command = $connection->createCommand("DELETE FROM $table WHERE hosp_id=:id");
    $command->bindParam(':id', $id);
    //删除$table表中大于18而小于26的； 尼玛这个id后赋值的原理是引用传值，先把id这个地址传进入，在execute()方法调用之前改变都有效；
    $id = 18;
    while($id < 26){
      $id ++;
      $command->execute();
    }
    //执行事务，在事务内部有抛异常
    $transaction = $connection->beginTransaction();
    try {
      $connection->createCommand($sql1)->execute();
      $connection->createCommand($sql2)->execute();
      // ... 执行其他 SQL 语句 ...
      $transaction->commit();
    } catch(Exception $e) {
      $transaction->rollBack();
    }
    // 多个事务参考
    $transaction1 = $connection->beginTransaction();
    try {
      $connection->createCommand($sql1)->execute();
      // 内部事务
      $transaction2 = $connection->beginTransaction();
      try {
        $connection->createCommand($sql2)->execute();
        $transaction2->commit();
      } catch (Exception $e) {
        $transaction2->rollBack();
      }
      $transaction1->commit();
    } catch (Exception $e) {
      $transaction1->rollBack();
    }
    # http://www.yiichina.com/doc/guide/2.0/db-dao 【数据库复制和读写分离】 等主从复制和分离的博文完结后再来看
    # 操作数据库模式 更多查看：yii\db\Schema
    $schema = $connection->getSchema();
    //获得所有表名
    $tables = $schema->getTableNames();
    //可以获得该表的所有DDL信息
    $res = $schema -> getTableSchema('table_name');
    //可以获得数据库中所有表的DDL信息
    $res = $schema -> getTableSchemas('database');
  }

queryBuilder

http://www.yiichina.com/doc/guide/2.0/db-query-builder

public function queryBuilder(){
    $connection = \Yii::$app->db;
    $table = $connection->quoteTableName('{{%hospital}}');
    $query = new \yii\db\Query();
    # 查询构建器
    $rows = (new \yii\db\Query())->select(['hosp_id', 'name'])->from($table)->where(['level' => '1'])->limit(3)->all();
    /*
     *  当你调用 yii\db\Query 当中的一个查询方法的时候，实际上内在的运作机制如下：
     *  1. 在当前 yii\db\Query 的构造基础之上，调用 yii\db\QueryBuilder 来生成一条 SQL 语句；
     *  2. 利用生成的 SQL 语句创建一个 yii\db\Command 对象；
     *  3. 调用 yii\db\Command 的查询方法（例如，queryAll()）来执行这条 SQL 语句，并检索数据。
     */
    /*
     * # select
     * 1. select(['user_id' => 'user.id', 'email']); //user.id as user_id,如果不用此方法默认是*
     * 2. select可以用字符串，但当使用函数时就必须要用到数组了$query->select(["CONCAT(first_name, ' ', last_name) AS full_name", 'email']);
     * 3. $query->select('user_id')->distinct(); 去除重复行
     * 4. $query->select(['id', 'username']) ->addSelect(['email']); 增加附加字段，一般用在判断中
     */
    /*
     * # from
     * 1. $query->from('public.user u, public.post p');
     * 2. $query->from(['u' => 'public.user', 'p' => 'public.post']);
     * 3. $subQuery = (new Query())->select('id')->from('user')->where('status=1');
     *    $query->from(['u' => $subQuery]);//SELECT * FROM (SELECT `id` FROM `user` WHERE status=1) u
     */
    /*
     * # where
     * 1. 字符串格式，例如： 'status=1';
     * 2. 哈希格式，例如： ['status' => 1, 'type' => 2]
     * 3. 操作符格式，例如： ['like', 'name', 'test']
     */
    //字符串格式
    $query->where('status=:status', [':status' => $status]); //防注入，动态替换掉:status
    $query->where('status=:status')->addParams([':status' => $status]);
    //哈希格式
    // ...WHERE (`status` = 10) AND (`type` IS NULL) AND (`id` IN (4, 8, 15))
    $query->where(
      [
        'status' => 10,
        'type' => null,
        'id' => [4, 8, 15],
      ]
    );
    $userQuery = (new Query())->select('id')->from('user');
    // ...WHERE `id` IN (SELECT `id` FROM `user`)
    $query->where(['id' => $userQuery]);
    /*
      * # where
      * [操作符, 操作数1, 操作数2, ...]
      * 1. and : 操作数会被 AND 关键字串联起来。例如， ['and', 'id=1', 'id=2'] 将会生成 id=1 AND id=2 。如果操作数是一个数组，它也会按上述规则转换成 字符串。例如，
      * ['and', 'type=1', ['or', 'id=1', 'id=2']] 将会生成 type=1 AND (id=1 OR id=2) 。 这个方法不会自动加引号或者转义。
      *
      * 2. or : 用法和 and 操作符类似，这里就不再赘述。
      *
      * 3. between : 第一个操作数为字段名称，第二个和第三个操作数代表的是这个字段的取值范围。例如， ['between', 'id', 1, 10] 将会生成 id BETWEEN 1 AND 10 。
      * not between : 用法和 BETWEEN 操作符类似，这里就不再赘述。
      *
      * 4. in : 第一个操作数应为字段名称或者 DB 表达式。第二个操作符既可以是一个数组， 也可以是一个 Query 对象。它会转换成 IN 条件语句。如果第二个操作数是一个 数组，那么它代表的是字段或 DB 表达式的取值范围。如果第二个操作数是 Query 对象，那么这个子查询的结果集将会作为第一个操 作符的字段或者 DB 表达式的取值范围。 例如， ['in', 'id', [1, 2, 3]] 将生成 id IN (1, 2, 3) 。 该方法将正确地为字段名加引号以及为取值范围转义。 in 操作符还支持组合字段，此时， 操作数1应该是 一个字段名数组，而操作数2应该是一个数组或者 Query 对象， 代表这些字段的取值范围。
      * not in : 用法和 in 操作符类似，这里就不再赘述。
      *
      * 5. like : 第一个操作数应为一个字段名称或 DB 表达式，第二个操作数可以使字符串或数组， 代表第一 个操作数需要模糊查询的值。比如， ['like', 'name', 'tester'] 会生成 name LIKE '%tester%' 。 如果范围值是一个数组，那么将会生成用 AND 串联起来的 多个 like 语句。例如， ['like', 'name', ['test', 'sample']] 将会生成 name LIKE '%test%' AND name LIKE '%sample%' 。 你也可以提供第三个可选的操作数来指定应该如何转义数值当中的特殊字符。 该操作数是一个从需要被转义的特殊字符到转义副本的数组映射。 如果没有提供这个操作数，将会使用默认的转义映射。 如果需要禁用转义的功能， 只需要将参数设置为 false 或者传入一个空数组即可。需要注意的是， 当使用转义映射（又或者没有提供第三个操作数的时候），第二个操作数的值的前后 将会被加上百分 号。
      *
      * 6. exists : 需要一个操作数，该操作数必须是代表子查询 yii\db\Query 的一个实例， 它将会构建一个 EXISTS (sub-query) 表达式。
      *
      * 7. > , <= , 或者其他包含两个操作数的合法 DB 操作符: 第一个操作数必须为字段的名称， 而第二个操 作数则应为一个值。例如， ['>', 'age', 10] 将会生成 age>10 。
      *
      * 8. 你可以使用 yii\db\Query::andWhere() 或者 yii\db\Query::orWhere() 在原有条件的基础上 附加额外的 条件。你可以多次调用这些方法来分别追加不同的条件
      *
      * 9. 使用yii\db\Query::filterWhere()可以忽略空值，类似于 [yii\db\Query::andWhere()|andWhere()]] 和 yii\db\Query::orWhere(), 你可以使用 yii\db\Query::andFilterWhere() 和 yii\db\Query::orFilterWhere() 方法 来追加额外的过滤条件。
    */
    # yii\db\Query::orderBy()
    // ... ORDER BY `id` ASC, `name` DESC
    $query->orderBy([
                      'id' => SORT_ASC,
                      'name' => SORT_DESC,
                    ]);
    $query->orderBy('id ASC, name DESC');
    $query->orderBy('id ASC')->addOrderBy('name DESC');
    # yii\db\Query::groupBy()
    // ... GROUP BY `id`, `status`
    $query->groupBy(['id', 'status']);
    $query->groupBy('id, status');
    $query->groupBy(['id', 'status'])->addGroupBy('age');
    # yii\db\Query::having()
    // ... HAVING `status` = 1，使用方式和where一样
    $query->having(['status' => 1]);
    // ... HAVING (`status` = 1) AND (`age` > 30)
    $query->having(['status' => 1])->andHaving(['>', 'age', 30]);
    # yii\db\Query::limit() 和 yii\db\Query::offset()
    $query->limit(10)->offset(20);
    # yii\db\Query::join()
    // ... LEFT JOIN post ON post.user_id = user.id
    $query->join('LEFT JOIN', 'post', 'post.user_id = user.id');
    /*
     * join($type, $table, $on, $params);
     * $on: 可选参数，连接条件，即 ON 子句。请查阅 where() 获取更多有关于条件定义的细节。
     * $params: 可选参数，与连接条件绑定的参数(防注入替换)。
     */
    $query->leftJoin('post', 'post.user_id = user.id');
    $subQuery = (new \yii\db\Query())->from('post');
    $query->leftJoin(['u' => $subQuery], 'u.id = author_id'); //将子查询放到一个数组当中，而数组当中的键，则为这个子查询的别名
    # yii\db\Query::union()
    $query1 = (new \yii\db\Query())->select("id, category_id AS type, name")->from('post')->limit(10);
    $query2 = (new \yii\db\Query())->select('id, type, name')->from('user')->limit(10);
    $query1->union($query2);
    # 查询输出
    // SELECT `id`, `email` FROM `user`
    $rows = (new \yii\db\Query())->select(['id', 'email'])->from('user')->all();
    // 返回结果集的第一行:SELECT * FROM `user` WHERE `username` LIKE `%test%`
    // 注意one方法只返回查询结果当中的第一条数据， 条件语句中不会加上 LIMIT 1 条件。如果你清楚的知道查询将会只返回一行或几行数据 （例如， 如果你是通过某些主键来查询的），这很好也提倡这样做。但是，如果查询结果 有机会返回大量的数据时，那么你应该显示调用 limit(1) 方法，以改善性能。
    $row = (new \yii\db\Query())->from('user')->where(['like', 'username', 'test'])->one();
    // 执行 SQL: SELECT COUNT(*) FROM `user` WHERE `last_name`=:last_name
    $count = (new \yii\db\Query())->from('user')->where(['last_name' => 'Smith'])->count();
    //yii\db\Query::column(): 返回结果集的第一列。
    $res = $this -> query -> from('sc_user') -> column();
    //yii\db\Query::scalar(): 返回结果集的第一行第一列的标量值。
    $res = $this -> query -> from('sc_user') -> scalar();
    //yii\db\Query::exists(): 无值就返回false；
    $res =  (new \yii\db\Query()) -> from('sc_user') -> where(['username' => 'admin2']) -> exists();
    //想要测试或者使用一个由 yii\db\Query 对象创建的 SQL 语句。 你可以使用以下的代码来达到目的：
    $command = (new \yii\db\Query())
      ->select(['id', 'email'])
      ->from('user')
      ->where(['last_name' => 'Smith'])
      ->limit(10)
      ->createCommand();
    // 打印 SQL 语句
    echo $command->sql;
    // 打印被绑定的参数
    print_r($command->params);
    // 返回查询结果的所有行
    $rows = $command->queryAll();
    # 查询结果重建数组索引
    // 返回 [100 => ['id' => 100, 'username' => '...', ...], 101 => [...], 103 => [...], ...]
    $query = (new \yii\db\Query())->from('user')->limit(10)->indexBy('id')->all();
    //使用表达式
    $query = (new \yii\db\Query())->from('user')->indexBy(function ($row) { return $row['id'] . $row['username']; }
    )->all();
    # 批处理查询(可用在采集，数据处理时)
    /*
     * yii\db\Query::batch() 和 yii\db\Query::each() 方法将会返回一个实现了Iterator 接口 yii\db\BatchQueryResult 的对象，可以用在 foreach 结构当中使用。在第一次迭代取数据的时候， 数据库会执行一次 SQL 查询，然后在剩下的迭代中，将直接从结果集中批量获取数据。默认情况下， 一批的大小为 100，也就意味着一批获取的数据是 100 行。你可以通过给 batch() 或者 each() 方法的第一个参数传值来改变每批行数的大小。
      相对于 yii\db\Query::all() 方法，批处理查询每次只读取 100 行的数据到内存。 如果你在处理完这些数据后及时丢弃这些数据，那么批处理查询可以很好的帮助降低内存的占用率。
      如果你通过 yii\db\Query::indexBy() 方法为查询结果指定了索引字段，那么批处理查询将仍然保持相对应的索引方案
     */
    $query = (new \yii\db\Query())
      ->from('user')
      ->indexBy('username');
    foreach ($query->batch() as $users) {
      // $users 的 “username” 字段将会成为索引
    }
    foreach ($query->each() as $username => $user) {
    }
  }

非数据库模型

http://www.yiichina.com/doc/guide/2.0/structure-models

<?php
namespace app\models;
use yii\base\Model;
class EntryForm extends Model
{
/*
 * 1. yii\base\Model支持 ArrayAccess 数组访问 和 ArrayIterator 数组迭代器；可以拿模型当一个大数组来用
 * 2. 这是一个普通的模型，与数据库没有关联
 * 3. 默认情况下你的模型类直接从yii\base\Model继承，所有non-static public非静态公有成员变量都是属性，另一种方式是可覆盖 yii\base\Model::attributes() 来定义属性，该方法返回模型的属性名(直接返回一个数组既可)。
 * 4. 可以通过$this -> getAttributeLabel('name')来获取name的表单name，可以覆盖yii\base\Model::attributeLabels() 方法明确指定属性标签(见以下方法)
 * 5. 可以通过覆盖 yii\base\Model::scenarios()方法来自定义行为，用于不同场景下的表单验证和收集
 * 6. 可以通过$model->attributes = \Yii::$app->request->post('ContactForm');来为模型的属性进行赋值；该种赋值方式是基于场景指定的；非场景指定的属性不被赋值
 *
 */
public $name;
public $email;
public $password;
public function rules($arr = array())
{
  return $arr?:[
    [['name', 'email'], 'required'], //required 换成 safe就表示不需要验证，如果在属性名前加一个！号就该属性就不被块赋值
    ['email', 'email'],
  ];
}
  public function scenarios(){
    /*
      * 场景作为属性来设置
      $model = new User;
      $model->scenario = 'login';
      * 场景通过构造初始化配置来设置
      $model = new User(['scenario' => 'login']);
     */
    return [
      'login' => ['username','password'], //用于登录时
      'regiser' => ['username','email','password'] //用于注册时,在验证规则中加上 'on' => 'register'既可，如果没有指定on就是在所有的场景中使用
    ];
  }
//默认实现会返回所有yii\base\Model::rules()方法申明的验证规则中的场景， 当覆盖 scenarios() 时，如果你想在默认场景外使用新场景，可以编写类似如下代码
public function scenarios()
{
  $scenarios = parent::scenarios();
  $scenarios['login'] = ['username', 'password'];
  $scenarios['register'] = ['username', 'email', 'password'];
  return $scenarios;
}
public function attributeLabels(){
  //还可以应对多语言情况哦
  return [
    'name' => '姓名',
    'email' => '邮件'
  ];
}
public function doTest($data){
  if(!($this -> load($data) && $this -> validate())){
    //输出错误
    print_r($this -> getErrors());
  };
}
// 明确列出每个字段，特别用于你想确保数据表或模型属性改变不会导致你的字段改变(保证后端的API兼容).
public function fields()
{
  return [
    // 字段名和属性名相同
    'id',
    // 字段名为 "email"，对应属性名为 "email_address"
    'email' => 'email_address',
    // 字段名为 "name", 值通过PHP代码返回
    'name' => function () {
      return $this->first_name . ' ' . $this->last_name;
    },
  ];
}
// 过滤掉一些字段，特别用于你想继承父类实现并不想用一些敏感字段
public function fields()
{
  $fields = parent::fields();
  // 去掉一些包含敏感信息的字段
  unset($fields['auth_key'], $fields['password_hash'], $fields['password_reset_token']);
  return $fields;
}
}

AR模型

http://www.yiichina.com/doc/guide/2.0/db-active-record

<?php
namespace app\models;
use yii\db\ActiveRecord;
class Orders extends ActiveRecord
{
  const WAIT = 1; //相较于直接在代码中写死字符串或数字，使用一个更有意义的常量名称是一种更好的编程习惯。
  const CHECK = 2;
  /**
   * @return string 返回该AR类关联的数据表名
   */
  public static function tableName()
  {
    return '{{%orders}}';
  }
  public function query(){
    //查询方法大致跟queryBuilder一样，但是，返回的是对象；
    $res = $this::find()->where(['and','user_id=27',['in','o_id',[328,329,330]]]) ->orderBy('o_id')->all();
    $res = $this::find() -> where(['o_id' => 328]) -> one();
    $res = $this::find() -> indexBy('o_id') -> all();
    $res = $this::find() -> count(); //直接是数值不是对象
    // 用原生 SQL 语句检索客户：
    $sql = 'SELECT * FROM customer';
    $customers = Customer::findBySql($sql)->all();
    //返回主键为328的数据
    $res = $this::findOne(328);
    //可以把条件
    $res = $this::findOne(
      [
        'o_id' => 328,
        'status' => $this::WAIT
      ]
    );
    // 返回id为1、2、3的一组客户
    $customers = Customer::findAll([1, 2, 3]);
    // 返回所有状态为 "deleted" 的客户
    $customer = Customer::findAll(
      [
        'status' => Customer::STATUS_DELETED,
      ]
    );
    // 以数组而不是对象形式取回客户信息：
    $customers = Customer::find()->asArray()->all();
  }
  # 关联查询篇
  /*
   * 由于在Component.php的_get()函数中实现了$getter = 'get'.modelName，然后自动补上了all方法返回，所以以下方法可以在控制器中通过 Orders -> users 获得数据
   *  yii\db\ActiveQuery对象有关联上下文的相关信息，因此可以只查询关联数据。也就是说在 Orders -> users 前面做的任何关于order的一条查询，都可以关联出来
   */
  public function getUsers(){
    // 客户和订单通过 Order.customer_id -> id 关联建立一对多关系
    return $this->hasMany(Users::className(), ['user_id' => 'user_id']);
  }
/*
 *  //取得该订单所关联的客户
 *  $orders = Orders::findOne(1);
 *  $users = $orders -> Customer;
 *  相当于
 *  SELECT * FROM customer WHERE id=1;
 *  SELECT * FROM order WHERE customer_id=1;
 *  再次用表达式 $customer->orders将不会执行第二次 SQL 查询， SQL 查询只在该表达式第一次使用时执行。 数据库访问只返回缓存在内部前一次取回的结果集，如果你想查询新的 关联数据，先要注销现有结果集：unset($customer->orders);。
 *
 *  一对多关联 ↓↓
 *  Order.customer_id 要被关联的放在前面
 *  return $this->hasMany(Order::className(), ['customer_id' => 'id']);
 */
  public function getCustomer()
  {
    //想取什么就关联什么,而且是在同一命名空间下，也不用use了
    return $this->hasOne(Customer::className(), ['id' => 'customer_id']);
  }
  /**
   * 多对多关联1
   * # question: 没搞明白，关联不起来，主要是外键都在中间表内
   * @var $this Hospital
   * @return
   */
  public function getOutpatient(){
    return $this->hasMany(Outpatient::className(), ['opt_id' => 'hosp_id'])
      ->viaTable('sc_hospital_outpatient', ['hosp_id' => 'opt_id']);
  }
  /**
   * 换成getOutpatient和getHospOpt配合起来就可以关联
   * @var $this Hospital
   * $hospObj = Hospital::findOne(18);
   * $opts = $hospObj -> outpatient;
   * @return
   */
    public function getOutpatient(){
      return $this -> hasMany(Outpatient::className(),['opt_id' => 'opt_id']) -> select(['opt_name','opt_id']) -> indexBy('opt_id') -> via('hospOpt') -> asArray();
    }
    public function getHospOpt(){
      return $this -> hasMany(HospOpt::className(),['hosp_id' => 'hosp_id']);
    }
  //批量处理数据
  public function batch(){
    // 一次提取 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){
        }
  }
  //待筛选条件；
  public function getBigOrders($threshold = 100)
  {
    return $this->hasMany(Order::className(), ['customer_id' => 'id'])
      ->where('subtotal > :threshold', [':threshold' => $threshold])
      ->orderBy('id');
  }
}

延迟加载和即时加载

# 延时加载
// SQL executed: SELECT * FROM customer WHERE id=1
$customer = Customer::findOne(1);
// SQL executed: SELECT * FROM order WHERE customer_id=1
$orders = $customer->orders;
// 没有 SQL 语句被执行
$orders2 = $customer->orders; //取回上次查询的缓存数据
# 但是会在以下情况出现性能问题，会查一百多次数据库
// SQL executed: SELECT * FROM customer LIMIT 100
$customers = Customer::find()->limit(100)->all();
foreach ($customers as $customer) {
    // SQL executed: SELECT * FROM order WHERE customer_id=...
    $orders = $customer->orders;
    // ...处理 $orders...
}
# 解决方案：
// SQL executed: SELECT * FROM customer LIMIT 100;
//               SELECT * FROM orders WHERE customer_id IN (1,2,...)
// 此处的orders要在Customer模型内要声明其关系
$customers = Customer::find()->limit(100)
    ->with('orders')->all();
foreach ($customers as $customer) {
    // 没有 SQL 语句被执行
    $orders = $customer->orders;
    // ...处理 $orders...
}
# Example
//取前面100个医院，然后通过医院模型中声明的getOutpatient关系取出该医院下面的科室
# question：如何筛选数据列
$hospObj = Hospital::find() -> limit(100) -> with('outpatient') -> all();
foreach($hospObj as $hosp){
  // 以下操作都不走数据库，都是走SPL迭代器
  echo $hosp -> name; //取出当前医院的名称
  //取出当前医院下的所有科室
  $opts = $hosp -> outpatient;
  echo "<pre>";
  print_r($opts);
  echo "<pre/> <hr />";
}

$customer = Customer::findOne(1);
// 延迟加载: SELECT * FROM order WHERE customer_id=1 AND subtotal>100
$orders = $customer->getOrders()->where('subtotal>100')->all();
// 即时加载: SELECT * FROM customer LIMIT 100
//          SELECT * FROM order WHERE customer_id IN (1,2,...) AND subtotal>100
$with = [
  //query就是SELECT * FROM order WHERE customer_id IN (1,2,...) query对象，然后可以随意的加andwhere 和 orwhere；
  'orders' => function($query) {
    $query->andWhere('subtotal>100');
  },
];
$customers = Customer::find()->limit(100)->with($with)->all();

逆关系

# question：试验效果无效
$user = Users::findOne(25);
$orders = $user -> orders[0];
echo $orders -> user === $user ? '相同':'不相同';
//↑↑定义了相反的关联关系后，按道理返回的应该是相同；
# @var $this Users 
return $this->hasMany(Orders::className(), ['user_id' => 'user_id']) -> inverseOf('user');
//注意'user'为Orders类里面getUser；

JOIN 类型关联查询

# Model @var $this Order; 
return $this->hasMany(Users::className(), ['user_id' => 'user_id']) -> select(['user_id','truename']) -> asArray();
# controller 此处with里面的依旧是model里面的getter方法，默认是leftJoin
$users = Orders::find() -> joinWith('user') -> limit(1) -> all();
foreach($users as $user){
 $r = $user -> user; //每个订单下面的用户
}
// 连接多重关系
// 找出24小时内注册客户包含书籍的订单
// 每个with都要在model里面定义
$orders = Order::find()->innerJoinWith([
    'books',
    'customer' => function ($query) {
        $query->where('customer.created_at > ' . (time() - 24 * 3600));
    }
])->all();
// 连接嵌套关系：连接 books 表及其 author 列
$orders = Order::find()->joinWith('books.author')->all();
// 查找包括书籍的所有订单，但 "books" 表不使用即时加载
$orders = Order::find()->innerJoinWith('books', false)->all();
// 等价于：
$orders = Order::find()->joinWith('books', false, 'INNER JOIN')->all();

# 有时连接两个表时，需要在关联查询的 ON 部分指定额外条件。 这可以通过调用 yii\db\ActiveQuery::onCondition() 方法实现：
# 也就是 on...and...语句
class User extends ActiveRecord
{
    public function getBooks()
    {
        return $this->hasMany(Item::className(), ['owner_id' => 'id'])->onCondition(['category_id' => 1]);
    }
}

作用域

默认作用域

# 在一个baseModel里面可以重写find
# question 到时候试验一下吧
public static function find()
{
return parent::find()->where(['deleted' => false]);
}

自定义作用域

namespace app\models;
use yii\db\ActiveQuery;
class CommentQuery extends ActiveQuery
{
    public function active($state = true)
    {
        $this->andWhere(['active' => $state]);
        return $this;
    }
}

namespace app\models;
use yii\db\ActiveRecord;
class Comment extends ActiveRecord
{
    /**
     * @inheritdoc
     * @return CommentQuery
     */
    public static function find()
    {
        return new CommentQuery(get_called_class());
    }
}

读取默认值

如果没有该字段就以默认值代替；

$customer = new Customer(); 
$customer->loadDefaultValues(); // ... 渲染 $customer 的 HTML 表单 ...

DML操作

AR 提供以下方法插入、更新和删除与 AR 对象关联的那张表中的某一行：

yii\db\ActiveRecord::save()
yii\db\ActiveRecord::insert()
yii\db\ActiveRecord::update()
yii\db\ActiveRecord::delete()

AR 同时提供了一下静态方法，可以应用在与某 AR 类所关联的整张表上。用这些方法的时候千万要小心，因为他们作用于整张表！比如，deleteAll() 会删除掉表里所有的记录。

yii\db\ActiveRecord::updateCounters()
yii\db\ActiveRecord::updateAll()
yii\db\ActiveRecord::updateAllCounters()
yii\db\ActiveRecord::deleteAll()

// 插入新客户的记录
$customer = new Customer();
$customer->name = 'James';
$customer->email = 'james@example.com';
$customer->save();  // 等同于 $customer->insert();
// 更新现有客户记录
$customer = Customer::findOne($id);
$customer->email = 'james@example.com';
$customer->save();  // 等同于 $customer->update();
// ↑↑ 注意此处的$customer如果是通过new获得的话就是插入，如果是通过find获得的话就是更新；
// 删除已有客户记录
$customer = Customer::findOne($id);
$customer->delete();
// 删除多个年龄大于20，性别为男（Male）的客户记录
Customer::deleteAll('age > :age AND gender = :gender', [':age' => 20, ':gender' => 'M']);
// 所有客户的age（年龄）字段加1：
Customer::updateAllCounters(['age' => 1]);

数据输入与有效性验证

由于AR继承自yii\base\Model，所以它同样也支持Model的数据输入、验证等特性。
当你调用 save()、insert()、update() 这三个方法时，会自动调用yii\base\Model::validate()方法。如果验证失败，数据将不会保存进数据库。

// 新建一条记录
$model = new Customer;
if ($model->load(Yii::$app->request->post()) && $model->save()) {
    // 获取用户输入的数据，验证并保存
}
// 更新主键为$id的AR
$model = Customer::findOne($id);
if ($model === null) {
    throw new NotFoundHttpException;
}
if ($model->load(Yii::$app->request->post()) && $model->save()) {
    // 获取用户输入的数据，验证并保存
}

yii\base\Model::rules() 方法应返回一个由规则所组成的数组，每一个规则都呈现为以下这类格式的小数组：

[
    // 必填项，用于指定那些模型特性需要通过此规则的验证。
    // 对于只有一个特性的情况，可以直接写特性名，而不必用数组包裹。
    ['attribute1', 'attribute2', ...],
    // 必填项，用于指定规则的类型。
    // 它可以是类名，验证器昵称，或者是验证方法的名称。
    'validator',
    // 可选项，用于指定在场景（scenario）中，需要启用该规则
    // 若不提供，则代表该规则适用于所有场景
    // 若你需要提供除了某些特定场景以外的所有其他场景，你也可以配置 "except" 选项
    'on' => ['scenario1', 'scenario2', ...],
    // 可选项，用于指定对该验证器对象的其他配置选项
    'property1' => 'value1', 'property2' => 'value2', ...
]

对于每个规则，你至少需要指定该规则适用于哪些特性，以及本规则的类型是什么。你可以指定以下的规则类型之一：

核心验证器的昵称，具体参考http://www.yiichina.com/doc/guide/2.0/tutorial-core-validators

yii\validators\Validator::builtInValidators 属性声明了所有被支持的验证器昵称
其实从第三个元素起就是验证类中的属性，用到什么验证类就去该类中看看,然后以键值对的形式表现出来

[
    # yii\validators\RequiredValidator
    [['email', 'password'], 'required'],
    # yii\validators\BooleanValidator 这是一个二选一的验证器，不仅仅是验证是否布尔值
    // 检查 "selected" 是否为 0 或 1，无视数据类型
    ['selected', 'boolean'],
    // 检查 "deleted" 是否为布尔类型，即 true 或 false,strict如果为true的话就严格在true和false之间验证；
    ['deleted', 'boolean', 'trueValue' => true, 'falseValue' => false, 'strict' => true],
    # yii\captcha\CaptchaValidator 用于验证验证码是否正确
    ['verificationCode', 'captcha'],
    # yii\validators\CompareValidator 比较验证器
    // 检查 "password" 特性的值是否与 "password_repeat" 的值相同，第三参数compareValue默认回来第一参数后面加上repeat
    ['password', 'compare'],
    // 检查年龄是否大于等于 30
    ['age', 'compare', 'compareValue' => 30, 'operator' => '>='],
    # yii\validators\DateValidator，基本上关于时间的验证能想到的都有，具体的去类里面看看；
    [['from', 'to'], 'date'],
    # yii\validators\DefaultValueValidator 
    // 若 "age" 为空，则将其设为 null
    ['age', 'default', 'value' => null],
    // 若 "from" 和 "to" 为空，则分别给他们分配自今天起，3 天后和 6 天后的日期。
    [['from', 'to'], 'default', 'value' => function ($model, $attribute) {
        return date('Y-m-d', strtotime($attribute === 'to' ? '+3 days' ：'+6 days'));
    }]
    # yii\validators\NumberValidator 
     // 检查 "salary" 是否为浮点数
    ['salary', 'double'],
    # yii\validators\EmailValidator 
     // 检查 "email" 是否为有效的邮箱地址
    ['email', 'email'],
    # yii\validators\FileValidator 
    // 检查 "primaryImage" 是否为 PNG, JPG 或 GIF 格式的上传图片。
    // 文件大小必须小于  1MB
    ['primaryImage', 'file', 'extensions' => ['png', 'jpg', 'gif'], 'maxSize' => 1024*1024*1024],
    # yii\validators\FilterValidator 
    // trim 掉 "username" 和 "email" 输入
    [['username', 'email'], 'filter', 'filter' => 'trim', 'skipOnArray' => true],
    // 标准化 "phone" 输入
    ['phone', 'filter', 'filter' => function ($value) {
        // 在此处标准化输入的电话号码
        return $value;
    }],
    # yii\validators\ImageValidator
     // 检查 "primaryImage" 是否为适当尺寸的有效图片
    ['primaryImage', 'image', 'extensions' => 'png, jpg',
        'minWidth' => 100, 'maxWidth' => 1000,
        'minHeight' => 100, 'maxHeight' => 1000,
    ],
    # yii\validators\RangeValidator 
    // 检查 "level" 是否为 1、2 或 3 中的一个
    ['level', 'in', 'range' => [1, 2, 3]],
    # yii\validators\NumberValidator 
    // 检查 "age" 是否为整数
    ['age', 'integer'],
    // 检查 "salary" 是否为数字
    ['salary', 'number'],
    # yii\validators\RegularExpressionValidator 
    // 检查 "username" 是否由字母开头，且只包含单词字符
    ['username', 'match', 'pattern' => '/^[a-z]\w*$/i']
    # yii\validators\SafeValidator 
    // 标记 "description" 为安全特性
    ['description', 'safe'],
    # yii\validators\StringValidator 
    // 检查 "username" 是否为长度 4 到 24 之间的字符串
    ['username', 'string', 'length' => [4, 24]],
    # yii\validators\FilterValidator 
    // trim 掉 "username" 和 "email" 两侧的多余空格
    [['username', 'email'], 'trim'],
    # yii\validators\UniqueValidator 
    // a1 需要在 "a1" 特性所代表的字段内唯一
    ['a1', 'unique'],
    // a1 需要唯一，但检验的是 a1 的值在字段 a2 中的唯一性
    ['a1', 'unique', 'targetAttribute' => 'a2'],
    // a1 和 a2 的组合需要唯一，且它们都能收到错误提示
    [['a1', 'a2'], 'unique', 'targetAttribute' => ['a1', 'a2']],
    // a1 和 a2 的组合需要唯一，只有 a1 能接收错误提示
    ['a1', 'unique', 'targetAttribute' => ['a1', 'a2']],
    // 通过同时在 a2 和 a3 字段中检查 a2 和 a3 的值来确定 a1 的唯一性
    ['a1', 'unique', 'targetAttribute' => ['a2', 'a1' => 'a3']],
    // 检查 "website" 是否为有效的 URL。若没有 URI 方案，则给 "website" 特性加 "http://" 前缀
    ['website', 'url', 'defaultScheme' => 'http'],
]

验证提示信息改为中文

array('name,type', 'required', 'message' => '{attribute}不能为空') //利用{attribute}可以动态获取属性名称

视图

yii\base\Controller::render(): 渲染一个视图名并使用一个布局返回到渲染结果。
yii\base\Controller::renderPartial(): 渲染一个视图名并且不使用布局。
yii\web\Controller::renderAjax(): 渲染一个视图名并且不使用布局，并注入所有注册的JS/CSS脚本和文件，通常使用在响应AJAX网页请求的情况下。
yii\base\Controller::renderFile(): 渲染一个视图文件目录或别名下的视图文件。

# Controller
 public $layout = 'post'; //本控制器视图用的布局都是post
 public function actionView($id)
{
    $model = Post::findOne($id);
    if ($model === null) {
        throw new NotFoundHttpException;
    }
    // 渲染一个名称为"view"的视图并使用布局
    return $this->render('view', [
        'model' => $model,
    ]);
}

yii\base\View::beginPage(): 该方法应在布局的开始处调用，它触发表明页面开始的 yii\base\View::EVENT_BEGIN_PAGE 事件。
yii\base\View::endPage(): 该方法应在布局的结尾处调用，它触发表明页面结尾的 yii\base\View::EVENT_END_PAGE 事件。
yii\web\View::head(): 该方法应在HTML页面的标签中调用，它生成一个占位符，在页面渲染结束时会被注册的头部HTML代码（如，link标签, meta标签）替换。
yii\web\View::beginBody(): 该方法应在标签的开始处调用，它触发 yii\web\View::EVENT_BEGIN_BODY 事件并生成一个占位符，会被注册的HTML代码（如JavaScript）在页面主体开始处替换。
yii\web\View::endBody(): 该方法应在标签的结尾处调用，它触发 yii\web\View::EVENT_END_BODY 事件并生成一个占位符，会被注册的HTML代码（如JavaScript）在页面主体结尾处替换。

<?php
/* @var $this \yii\web\View */
/* @var $content string */
use yii\helpers\Html;
use yii\bootstrap\Nav;
use yii\bootstrap\NavBar;
use yii\widgets\Breadcrumbs;
use app\assets\AppAsset;
AppAsset::register($this);
?>
<?php $this->beginPage() ?>
<!DOCTYPE html>
<html lang="<?= Yii::$app->language ?>">
<head>
    <meta charset="<?= Yii::$app->charset ?>">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <?= Html::csrfMetaTags() ?>
    <title><?= Html::encode($this->title) ?></title>
    <?php $this->head() ?>
</head>
<body>
<?php $this->beginBody() ?>
<div class="wrap">
    <?php
    NavBar::begin([
        'brandLabel' => 'My Company',
        'brandUrl' => Yii::$app->homeUrl,
        'options' => [
            'class' => 'navbar-inverse navbar-fixed-top',
        ],
    ]);
    echo Nav::widget([
        'options' => ['class' => 'navbar-nav navbar-right'],
        'items' => [
            ['label' => 'Home', 'url' => ['/site/index']],
            ['label' => 'About', 'url' => ['/site/about']],
            ['label' => 'Contact', 'url' => ['/site/contact']],
            Yii::$app->user->isGuest ?
                ['label' => 'Login', 'url' => ['/site/login']] :
                [
                    'label' => 'Logout (' . Yii::$app->user->identity->username . ')',
                    'url' => ['/site/logout'],
                    'linkOptions' => ['data-method' => 'post']
                ],
        ],
    ]);
    NavBar::end();
    ?>
    <div class="container">
        <?= Breadcrumbs::widget([
            'links' => isset($this->params['breadcrumbs']) ? $this->params['breadcrumbs'] : [],
        ]) ?>
        <?= $content ?>
    </div>
</div>
<footer class="footer">
    <div class="container">
        <p class="pull-left">&copy; My Company <?= date('Y') ?></p>
        <p class="pull-right"><?= Yii::powered() ?></p>
    </div>
</footer>
<?php $this->endBody() ?>
</body>
</html>
<?php $this->endPage() ?>

数据块

...
<?php $this->beginBlock('block1'); ?>
...content of block1...
<?php $this->endBlock(); ?>
...
<?php $this->beginBlock('block3'); ?>
...content of block3...
<?php $this->endBlock(); ?>

# 用子视图中的数据块覆盖
<?php if (isset($this->blocks['block1'])): ?>
    <?= $this->blocks['block1'] ?>
<?php else: ?>
    ... default content for block1 ...
<?php endif; ?>

元信息

<title><?= Html::encode($this->title) ?></title>
<?php
$this->registerMetaTag(['name' => 'keywords', 'content' => 'yii, framework, php']);
$this->registerMetaTag(['name' => 'description', 'content' => 'This website is about funny raccoons.'], 'description');
$this->registerLinkTag([
    'title' => 'Live News for Yii',
    'rel' => 'alternate',
    'type' => 'application/rss+xml',
    'href' => 'http://www.yiiframework.com/rss.xml/',
]);
//生成如下link标签： <link title="Live News for Yii" rel="alternate" type="application/rss+xml" href="http://www.yiiframework.com/rss.xml/">
?>

嵌套布局

# 子布局，类似数据块，数据块都是写在模板里面
<?php $this->beginContent('@app/views/layouts/base.php'); ?>
...child layout content here...
<?php $this->endContent(); ?>

在视图中渲染另外一个视图

yii\base\View::render(): 渲染一个视图名.
yii\web\View::renderAjax(): 渲染一个视图名并注入所有注册的JS/CSS脚本和文件，通常使用在响应AJAX网页请求的情况下。
yii\base\View::renderFile(): 渲染一个视图文件目录或别名下的视图文件。

<?= $this->render('_overview') ?> //在本视图中再渲染一个视图

视图与视图间传递数据

# 推送，必须是键值对，然后以对应的键名取出来
echo $this->render('report', [
    'foo' => 1,
    'bar' => 2,
]);
# 拉取
略

视图间共享数据

yii\base\View视图组件提供yii\base\View::params参数属性来让不同视图共享数据。