YII(版本1) 权威指南学习笔记(未完结)

php
framework

posted on 19 Nov 2015 under category notes

入口脚本

WEB 应用一般为 index.php, 控制台应用一般为 yii.php 并在文件开头加上 #! /usr/bin/env php

入口脚本是定义全局常量的好地方

支持三个常量: YII_DEBUG, YII_ENV, YII_ENABLE_ERROR_HANDLER

WEB:

<?php
// 定义全局常量
defined('YII_DEBUG') or define('YII_DEBUG', true);
defined('YII_ENV') or define('YII_ENV', 'dev');

// 注册 Composer 自动加载器
require(__DIR__ . '/../vendor/autoload.php');

// 包含 Yii 类文件
require(__DIR__ . '/../vendor/yiisoft/yii2/Yii.php');

// 加载应用配置
$config = require(__DIR__ . '/../config/web.php');

// 创建、配置、运行一个应用
(new yii\web\Application($config))->run();

控制台:

#!/usr/bin/env php
<?php
defined('YII_DEBUG') or define('YII_DEBUG', true);

// fcgi 默认没有定义 STDIN 和 STDOUT
defined('STDIN') or define('STDIN', fopen('php://stdin', 'r'));
defined('STDOUT') or define('STDOUT', fopen('php://stdout', 'w'));

// 注册 Composer 自动加载器
require(__DIR__ . '/vendor/autoload.php');

// 包含 Yii 类文件
require(__DIR__ . '/vendor/yiisoft/yii2/Yii.php');

// 加载应用配置
$config = require(__DIR__ . '/config/console.php');

$application = new yii\console\Application($config);
$exitCode = $application->run();
exit($exitCode);
?>

控制器

控制器路由格式: moduleID/controllerID/actionID

控制器创建决策步骤:

如果指定了 CWebApplication::catchAllRequest, 用户指定的 ID 将被忽略. (通常用于设置应用为维护状态, 显示一个静态页面)
如果在 CWebApplication::controllerMap 中找到 ID, 相应的控制器配置则被用于创建控制器
如果 ID 为 path/to/xyz 形式, 则按控制器路由格式解析并创建

创建:

默认控制器在 CWebApplication::defaultController 中定义, 默认动作为 index, 对应的方法名为 actionIndex, 可通过 CController::defaultAction 修改
```
<?php
class SiteController extends CController {
}
?>
```

也可以由一个动作类来定义动作, 以便重用动作:

<?php
class UpdateAction extends CAction {
    public function run() {
        // place the action logic here
    }
}
?>

然后需覆盖控制器类的 actions 方法:

<?php
class PostController extends CController {
    public function actions() {
        return array(
            'edit'=>'application.controllers.post.UpdateAction',
        );
    }
}
?>

动作参数绑定:

<?php
// in PostController:
public function actionCreate(array $category, $language = 'en') {
    // 动作参数绑定功能将会把传入 action 的参数和 $_GET 中的数据绑定
    // 在此, 如果 $_GET 中没有 language 这一项, $language 默认为 'en'
    // 因为没有为 $category 提供默认值, 如果 $_GET 中没有 category 这一项则会报错
    // array 类型声明会确保 $category 为一个数组(自动将基本类型转换为数组)
}
?>

过滤器可被配置在动作执行之前或之后执行, 如访问控制过滤器, 性能过滤器(参见访问控制过滤器)

定义:

可被定义为一个 filter 前缀的控制器方法:

<?php
public function filterAccessControl($filterChain) {
    // 调用 $filterChain->run() 以继续后续过滤器与动作的执行。
}
?>

也可是一个 CFilter 或其子类的实例:

<?php
class PerformanceFilter extends CFilter {
    protected function preFilter($filterChain) {
        // 动作被执行之前应用的逻辑
        return true; // 如果动作不应被执行，此处返回 false
    }

    protected function postFilter($filterChain) {
        // 动作执行之后应用的逻辑
    }
}
?>

配置使用: 需要覆盖控制器的 filter() 方法:

<?php
class PostController extends CController {
    ......
    public function filters() {
        return array(
            'postOnly + edit, create', // 使用 filter 前缀方法定义的过滤器
            array(                     // 使用类定义的过滤器
                'application.filters.PerformanceFilter - edit, create',
                'unit'=>'second',
            ),
        );
    }
}
?>

表单模型和Active Record

<?php
$this->render('edit', array(
    'var1'=>$value1,
    'var2'=>$value2,
));
?>

protected/views/layouts/main.php 是默认的布局文件, 可通过 CWebApplication::layout 自定义. 要渲染一个不带布局的视图, 需调用 CController::renderPartial

小物件是 CWidget 或其子类的实例, 它也可以有自己的视图文件

定义

<?php
class MyWidget extends CWidget {
    public function init() {
        // 此方法会被 CController::beginWidget() 调用
    }

    public function run() {
        // 此方法会被 CController::endWidget() 调用
    }
}
?>

按如下视图脚本来使用一个小物件:

<?php $this->beginWidget('path.to.WidgetClass', $config); ?>
...可能会由小物件获取的内容主体...
<?php $this->endWidget(); ?>
// 或
<?php $this->widget('path.to.WidgetClass', $config); ?>

系统视图用于展示 Yii 的错误和日志消息, 如如果 CHttpException 抛出一个 404 错误, 那么 error404 就会被展示. Yii 在 framework/views 下提供了默认的系统视图, 也可以通过在 protected/views/system 下创建同名视图文件进行自定义

<?php
public function onClicked($event) {
    $this->raiseEvent('onClicked', $event);
}
?>

定义事件回调

<?php
function callbackName($event) {
    ......
}
?>

绑定事件回调

<?php
$component->onClicked=$callback;
// 或使用匿名函数
$component->onclicked=function($event) {
}
?>

组件行为

行为类必须实现 IBehavior
大多数行为可继承自 CBehavior, 如果行为需要绑定到模型, 则也可以继承自 CModelBehavior 或 CActiveRecordBehavior
两个同名行为绑定到同一个组件下是有可能的, 在这种情况下, 先绑定的行为则拥有优先权
当和 events, 一起使用时, 行为会更加强大. 当行为被绑定到组件时,行为里的一些方法就可以绑定到组件的一些事件上了. 这样一来,行为就有机观察或者改变组件的常规执行流程
一个行为的属性也可以通过绑定到的组件来访问. 这些属性包含公共成员变量以及通过 getters 和/或 setters 方式设置的属性. 例如, 若一个行为有一个 xyz 的属性，此行为被绑定到组件 $a, 然后我们可以使用表达式 $a->xyz 访问此行为的属性

绑定行为:

<?php
// $name 在组件中实现了对行为的唯一识别
$component->attachBehavior($name,$behavior);
// test() 是行为中的方法。
$component->test();
?>

访问行为:

<?php
$behavior=$component->tree;
// 等于下行代码：
// $behavior=$component->asa('tree');
?>

禁用行为:

<?php
$component->disableBehavior($name);
// 下面的代码将抛出一个异常
$component->test();
$component->enableBehavior($name);
// 现在就可以使用了
$component->test();
?>

forum/
   ForumModule.php            模块类文件
   components/                包含可复用的用户组件
      views/                  包含小物件的视图文件
   controllers/               包含控制器类文件
      DefaultController.php   默认的控制器类文件
   extensions/                包含第三方扩展
   models/                    包含模块类文件
   views/                     包含控制器视图和布局文件
      layouts/                包含布局文件
      default/                包含 DefaultController 的视图文件
         index.php            首页视图文件

<?php
Yii::$classMap=array(
    'ClassName1' => 'path/to/ClassName1.php',
    'ClassName2' => 'path/to/ClassName2.php',
    ......
);
?>

导入目录: Yii::import('system.web.*');

使用表单

<?php
class LoginForm extends CFormModel {
    // 定义特性(我们把用于存储用户输入或数据库数据的属性成为特性(attribute))
    public $username;
    public $password;
    public $rememberMe=false;

    private $_identity;

    // 验证规则
    public function rules() {
        /**
         * 每个验证规则的格式为: 
         * array('AttributeList', 'Validator', 'on'=>'ScenarioList', ...附加选项)
         * 有三种方法指定 Validator
         * 1. 指定为模型类中的一个方法, 该方法定义格式为
         * public function ValidatiorName($attributes, $params) {...}
         * 2. 一个继承自 CValidator 的验证器类, 此时附加选项用于初始化实例的属性值
         * 3. 一个预定义的验证器类的别名, 以下是完整列表
         * boolean, captcha, compare, email, default, exists, file
         * filter, in, length, match, numerical, required, type, unique, url
         */
        return array(
            array('username, password', 'required'), // 必填
            array('rememberMe', 'boolean'),          // 布尔
            array('password', 'authenticate'),       // 需验证
        );
    }

    /**
     * authenticate Validator
     */
    public function authenticate($attribute,$params)
    {
        $this->_identity=new UserIdentity($this->username,$this->password);
        if(!$this->_identity->authenticate())
            $this->addError('password','错误的用户名或密码。');
    }
}
?>

块赋值(massive assignment)

<?php
$model = new LoginForm();
if (isset($_POST['LoginForm'])) {
    /**
     * 只有被认为 '安全' 的特性才会被赋值
     * 特性如果出现在相应场景的一个验证规则中, 即被认为是安全的
     * 也可以用特殊的 `safe` Validator 来让特性变为安全的
     * 
     * 为了使块赋值正确工作, 对应于模型类 `C` 中的特性 `a` 的表单域, 请命名其为  `C[a]`
     */
    $model->attributes = $_POST['LoginForm'];
}
?>

触发验证

验证是基于 场景(scenario) 的
可以手动调用 CModel::validate() 触发; 对于 CActiveRecord, 会在 CAcitveRecord::save() 时自动触发验证
验证错误可以使用 CModel::getError() 或 CModel::getErrors() 获取

标签

CModel 默认将返回特性的名字作为其标签
也可使用 CModel::attributesLabels 方法自定义标签

<?php
public function actionLogin() {
    $model=new LoginForm;
    if(isset($_POST['LoginForm'])) {
        // 收集用户输入的数据
        $model->attributes=$_POST['LoginForm'];
        // 验证用户输入，并在判断输入正确后重定向到前一页
        if($model->validate())
            $this->redirect(Yii::app()->user->returnUrl);
    }
    // 显示登录表单
    $this->render('login',array('model'=>$model));
}
?>

<div class="form">
<?php $form=$this->beginWidget('CActiveForm'); ?>

    <?php echo $form->errorSummary($model); ?>

    <div class="row">
        <?php echo $form->label($model,'username'); ?>
        <?php echo $form->textField($model,'username') ?>
    </div>

    <div class="row">
        <?php echo $form->label($model,'password'); ?>
        <?php echo $form->passwordField($model,'password') ?>
    </div>

    <div class="row rememberMe">
        <?php echo $form->checkBox($model,'rememberMe'); ?>
        <?php echo $form->label($model,'rememberMe'); ?>
    </div>

    <div class="row submit">
        <?php echo CHtml::submitButton('Login'); ?>
    </div>

<?php $this->endWidget(); ?>
</div><!-- form -->

<?php
public function actionBatchUpdate()
{
    // 假设每一项（item）是一个 'Item' 类的实例，
    // 提取要通过批量模式更新的项
    $items=$this->getItemsToUpdate();
    if(isset($_POST['Item']))
    {
        $valid=true;
        foreach($items as $i=>$item)
        {
            if(isset($_POST['Item'][$i]))
                $item->attributes=$_POST['Item'][$i];
            $valid=$valid && $item->validate();
        }
        if($valid)  // 如果所有项目有效
            // ...则在此处做一些操作
    }
    // 显示视图收集表格输入
    $this->render('batchUpdate',array('items'=>$items));
}
?>

view:

<div class="form">
<?php echo CHtml::beginForm(); ?>
<table>
<tr><th>Name</th><th>Price</th><th>Count</th><th>Description</th></tr>
<?php foreach($items as $i=>$item): ?>
<tr>
<td><?php echo CHtml::activeTextField($item,"[$i]name"); ?></td>
<td><?php echo CHtml::activeTextField($item,"[$i]price"); ?></td>
<td><?php echo CHtml::activeTextField($item,"[$i]count"); ?></td>
<td><?php echo CHtml::activeTextArea($item,"[$i]description"); ?></td>
</tr>
<?php endforeach; ?>
</table>

<?php echo CHtml::submitButton('Save'); ?>
<?php echo CHtml::endForm(); ?>
</div>

使用表单生成器 @todo

数据访问对象(DAO)

执行 SQL 语句

<?php
// 1. 数据查询

// SELECT *
select()
// SELECT `id`, `username`
select('id, username')
// SELECT `tbl_user`.`id`, `username` AS `name`
select('tbl_user.id, username as name')
// SELECT `id`, `username`
select(array('id', 'username'))
// SELECT `id`, count(*) as num
select(array('id', 'count(*) as num'))

// SELECT DISTINCT `id`, `username`
selectDistinct('id, username')

// FROM `tbl_user`
from('tbl_user')
// FROM `tbl_user` `u`, `public`.`tbl_profile` `p`
from('tbl_user u, public.tbl_profile p')
// FROM `tbl_user`, `tbl_profile`
from(array('tbl_user', 'tbl_profile'))
// FROM `tbl_user`, (select * from tbl_profile) p
from(array('tbl_user', '(select * from tbl_profile) p'))

// WHERE id=1 or id=2
where('id=1 or id=2')
// WHERE id=:id1 or id=:id2
where('id=:id1 or id=:id2', array(':id1'=>1, ':id2'=>2))
// WHERE id=1 OR id=2
where(array('or', 'id=1', 'id=2'))
// WHERE id=1 AND (type=2 OR type=3)
where(array('and', 'id=1', array('or', 'type=2', 'type=3')))
// WHERE `id` IN (1, 2)
where(array('in', 'id', array(1, 2))
// WHERE `id` NOT IN (1, 2)
where(array('not in', 'id', array(1,2)))
// when using LIKE, remember to escape user inputed `%` and `_`
// WHERE `name` LIKE '%Qiang%'
where(array('like', 'name', '%Qiang%'))
// WHERE `name` LIKE '%Qiang' AND `name` LIKE '%Xue'
where(array('like', 'name', array('%Qiang', '%Xue')))
// WHERE `name` LIKE '%Qiang' OR `name` LIKE '%Xue'
where(array('or like', 'name', array('%Qiang', '%Xue')))
// WHERE `name` NOT LIKE '%Qiang%'
where(array('not like', 'name', '%Qiang%'))
// WHERE `name` NOT LIKE '%Qiang%' OR `name` NOT LIKE '%Xue%'
where(array('or not like', 'name', array('%Qiang%', '%Xue%')))

// WHERE ... OR ...
orWhere()

// WHERE ... AND ...
andWhere()

// ORDER BY `name`, `id` DESC
order('name, id desc')
// ORDER BY `tbl_profile`.`name`, `id` DESC
order(array('tbl_profile.name', 'id desc'))

// LIMIT 10
limit(10)
// LIMIT 10 OFFSET 20
limit(10, 20)

// OFFSET 20
offset(20)

// JOIN `tbl_profile` ON user_id=id
join('tbl_profile', 'user_id=id')

// LEFT JOIN `pub`.`tbl_profile` `p` ON p.user_id=id AND type=1
leftJoin('pub.tbl_profile p', 'p.user_id=id AND type=:type', array(':type'=>1))

// RIGHT JOIN
rightJoin()

// CROSS JOIN
crossJoin()

// NATURAL JOIN
natrualJoin()

// GROUP BY `name`, `id`
group('name, id')
// GROUP BY `tbl_profile`.`name`, `id`
group(array('tbl_profile.name', 'id'))

// HAVING id=1 or id=2
having('id=1 or id=2')
// HAVING id=1 OR id=2
having(array('or', 'id=1', 'id=2'))

// UNION (select * from tbl_profile)
union('select * from tbl_profile')

// 2. 数据操作(不同于数据查询, 数据操作会立即执行)

// INSERT INTO `tbl_user` (`name`, `email`) VALUES (:name, :email)
$command->insert('tbl_user', array(
    'name'=>'Tester',
    'email'=>'tester@example.com',
));

// UPDATE `tbl_user` SET `name`=:name WHERE id=:id
$command->update('tbl_user', array(
    'name'=>'Tester',
), 'id=:id', array(':id'=>1));

// DELETE FROM `tbl_user` WHERE id=:id
$command->delete('tbl_user', 'id=:id', array(':id'=>1));

// 3. Schema 操作

// CREATE TABLE `tbl_user` (
//     `id` int(11) NOT NULL AUTO_INCREMENT PRIMARY KEY,
//     `username` varchar(255) NOT NULL,
//     `location` point
// ) ENGINE=InnoDB
createTable('tbl_user', array(
    'id' => 'pk',
    'username' => 'string NOT NULL',
    'location' => 'point',
), 'ENGINE=InnoDB')

// RENAME TABLE `tbl_users` TO `tbl_user`
renameTable('tbl_users', 'tbl_user')

// DROP TABLE `tbl_user`
dropTable('tbl_user')

// TRUNCATE TABLE `tbl_user`
truncateTable('tbl_user')

// ALTER TABLE `tbl_user` ADD `email` varchar(255) NOT NULL
addColumn('tbl_user', 'email', 'string NOT NULL')

// ALTER TABLE `tbl_user` DROP COLUMN `location`
dropColumn('tbl_user', 'location')

// ALTER TABLE `tbl_users` CHANGE `name` `username` varchar(255) NOT NULL
renameColumn('tbl_user', 'name', 'username')

// ALTER TABLE `tbl_user` CHANGE `username` `username` varchar(255) NOT NULL
alterColumn('tbl_user', 'username', 'string NOT NULL')

// ALTER TABLE `tbl_profile` ADD CONSTRAINT `fk_profile_user_id`
// FOREIGN KEY (`user_id`) REFERENCES `tbl_user` (`id`)
// ON DELETE CASCADE ON UPDATE CASCADE
addForeignKey('fk_profile_user_id', 'tbl_profile', 'user_id',
    'tbl_user', 'id', 'CASCADE', 'CASCADE')

// ALTER TABLE `tbl_profile` DROP FOREIGN KEY `fk_profile_user_id`
dropForeignKey('fk_profile_user_id', 'tbl_profile')

// CREATE INDEX `idx_username` ON `tbl_user` (`username`)
createIndex('idx_username', 'tbl_user', 'username')

// DROP INDEX `idx_username` ON `tbl_user`
dropIndex('idx_username', 'tbl_user')
?>

也可通过使用属性赋值方式:

<?php
$command->select = array('id', 'username');
?>

或在创建 CDbCommand 是传配置参数的方式构建:

<?php
$row = Yii::app()->db->createCommand(array(
    'select' => array('id', 'username'),
    'from' => 'tbl_user',
    'where' => 'id=:id',
    'params' => array(':id'=>1),
))->queryRow();
?>

构建完成后, 可以使用在执行 SQL 语句中讲到的方法执行之; 也可使用 CDbCommand::getText() 获取最后构建完工后的 SQL 语句, 绑定的参数被保存在 CDbCommand::params 中

同一个 CDbCommand 实例可用于多次构建不同的查询, 但是记得要再另一次之前调用 CDbCommand::reset() 以清理上次的查询

Active Record

每个 AR 类代表一个数据表(或视图), 数据表(或视图)的列在 AR 类中体现为类的属性, 一个 AR 实例则表示表中的一行

最佳应用是模型化数据表为 PHP 结构和执行不包含复杂 SQL 语句的查询. 对于复杂查询的场景, 应使用 Yii DAO

如果你数据库的表结构很少改动, 你应该通过配置 CDbConnection::schemaCachingDuration 属性的值为一个大于零的值开启表结构缓存

通过 AR 使用多个数据库有两种方式. 如果数据库的结构不同, 你可以创建不同的 AR 基类实现不同的 getDbConnection(); 否则, 动态改变静态变量 CActiveRecord::db 是一个好主意

由于 AR 类经常在多处被引用, 我们可以导入包含 AR 类的整个目录, 而不是一个个导入. 见路径别名和命名空间

通过 Yii 的日志功能, 可以查看 AR 在背后到底执行了那些语句

如果要确定两个 AR 是否是同一个记录, 只需对比它们的主键值, 或直接调用 CActiveRecord::equals()

关系型 Active Record

占位符方法	含义
beforeValidate, afterValidate	在验证之前(后)执行
beforeSave, afterSave	在保存 AR 实例之前(后)执行
beforeFind, afterFind	在执行查询之前(后)执行
afterConstruct	在 AR 实例化之后执行

在 AR 查询中, 基础表的别名为 t, 其他关联表的别名和关系的名称一样

数据库迁移 @todo

配置

存取操作

<?php 
// 此值将在30秒后失效
// 也可能因依赖的文件发生了变化而更快失效
Yii::app()->cache->set($id, $value, 30, new CFileCacheDependency('FileName'));
// 可用的依赖有:
// - CFileCacheDependency: 如果文件的最后修改时间发生改变
// - CDirectoryCacheDependency: 如果目录和其子目录中的文件发生改变
// - CDbCacheDependency: 如果指定 SQL 语句的查询结果发生改变
// - CGlobalStateCacheDependency: 如果指定的全局状态发生改变
// - CChainedCacheDependency: 如果链中的任何依赖发生改变
// - CExpressionDependency: 如果指定的 PHP 表达式的结果发生改变
 ?>

基本使用方法

<?php if($this->beginCache(
            $id, 
            array(
                // 过期时间, 默认 60
                'duration' => 3600,
                // 依赖, 可以是一个实现 `ICacheDependency` 的对象, 
                // 或能生成依赖对象想的配置数组
                // 参见数据缓存
                'dependency' => array(
                    'class'=>'system.caching.dependencies.CDbCacheDependency',
                    'sql'=>'SELECT MAX(lastModified) FROM Post'
                ),
                // 变化, 指定缓存将根据哪些因素变化
                // 其他可用的有: `varyByRoute`, `varyBySession`, `varyByParam`, `varyByLanguage`
                'varyByExpression' => 'Yii::app()->user->isGuest',
                // 请求类型: 只对指定的请求类型启用缓存
                'requestTypes' => array('GET')
                )
            )
        ) { ?>
        ...被缓存的内容...
<?php $this->endCache(); } ?>

页面缓存

如果想要缓存整个页面, 我们应该跳过产生网页内容的动作执行. 我们可以使用 COutputCache 或 CHttpCacheFilter 作为动作过滤器来完成这一任务

COutputCache

CHttpCacheFilter

<?php if($this->beginCache($id)) { ?>
...被缓存的片段内容...
    <?php $this->renderDynamic($callback); ?>
...被缓存的片段内容...
<?php $this->endCache(); } ?>

URL 管理

<?php
class UserIdentity extends CUserIdentity {
    private $_id;

    /**
     * 这是身份类的主要工作, 实现验证
     */
    public function authenticate() {
        // 使用 User AR 获取数据
        $record=User::model()->findByAttributes(array('username'=>$this->username));
        if($record===null) {
            $this->errorCode=self::ERROR_USERNAME_INVALID;
        } else if {
            ($record->password!==md5($this->password))
            $this->errorCode=self::ERROR_PASSWORD_INVALID;
        } else {
            $this->_id=$record->id;
            // 使用 setState 把 title 信息存储为状态传递给 CWebUser
            // 之后便可以使用 Yii::app()->user->title 访问
            // CWebUser 默认会存储状态信息到 session, 但如果 CWebUser::allowAutoLogin 为 true, 则会存到 cookie, 切勿将敏感信息存入 cookie
            $this->setState('title', $record->title);
            $this->errorCode=self::ERROR_NONE;
        }
        return !$this->errorCode;
    }

    /**
     * 重写 getId, 默认的实现是直接返回用户名
     */
    public function getId() {
        return $this->_id;
    }
}
?>

登录和注销:

<?php
// 1. 使用提供的用户名和密码登录用户
$identity=new UserIdentity($username,$password);
if($identity->authenticate()) {
    // 将用户身份信息存入持久存储(默认为 Session)
    // 之后便可以用 `Yii::app->user->isGuest` 判断用户是否登录
    Yii::app()->user->login($identity);
} else {
    echo $identity->errorMessage;
}
......

// 注销当前用户
Yii::app()->user->logout();

// 2. 使用 Cookie 登录
// 要确保用户部件的allowAutoLogin被设置为true。
// 保留用户登陆状态时间7天
Yii::app()->user->login($identity,3600*24*7);
?>

如果使用 cookie 登录, 要确保不要保存敏感信息到 State, 而是保存到持久存储(数据库) 上, 最好(参见安全):

当用户成功登录时, 保存同一个随机串到 cookie State 和数据库
在之后的的自动 cookie 登录时, 对比 cookie 中和数据库中的随机串是否一致
如果用户通过登录表单登录, 刷新这个随机串

过滤器

过滤器定义之后, 还要通过重载 CController::accessRules 指定具体授权规则

<?php
class PostController extends CController {
    /**
     * 配置数组的值可为
     * 第一项: `deny` 或者 `allow`
     * actions: action 名字
     * users: *: 任何用户, ?: 匿名用户, @: 验证通过的用户 
     */
    public function accessRules() {
        return array(
            array('deny',
                'actions'=>array('create', 'edit'),
                'users'=>array('?'),
            ),
            array('allow',
                'actions'=>array('delete'),
                'roles'=>array('admin'),
            ),
            array('deny',
                'actions'=>array('delete'),
                'users'=>array('*'),
            ),
            // 为了确保某类动作在没允许情况下不被执行
            array('deny',
                    'action'=>'delete',
            )
        );
    }
}
?>

如果授权失败

已经配置 CWebUser::loingUrl, 则重定向到此 URL, 可以这样配置:

<?php
array(
    ......
    'components'=>array(
        'user'=>array(
            // 这实际上是默认值
            'loginUrl'=>array('site/login'),
        ),
    ),
)
?>

否则显示一个 401 HTTP 例外

如果希望在用户登录成功后转到之前页面:

<?php
Yii::app()->request->redirect(Yii::app()->user->returnUrl);
?>

基于角色的访问控制(Role-Based Access Control)

授权项目可分为操作(operations), 任务(tasks) 和角色(roles) 一个角色由若干任务组成, 一个任务由若干操作组成，而一个操作就是一个许可, 不可再分. Yii 还允许一个角色包含其他角色或操作, 一个任务可以包含其他操作, 一个操作可以包括其他操作. 授权项目是通过它的名字唯一识别的

一个授权项目可能与一个业务规则关联. 业务规则是一段 PHP 代码, 在进行涉及授权项目的访问检查时将会被执行. 仅在执行返回 true 时, 用户才会被视为拥有此授权项目所代表的权限许可

Yii 提供了两种授权管理器： CPhpAuthManager 和 CDbAuthManager. 前者将授权数据存储在一个 PHP 脚本文件中而后者存储在数据库中. 配置 CWebApplication::authManager 应用组件时, 我们需要指定使用哪个授权管理器组件类, 以及所选授权管理器组件的初始化属性值:

默认角色就是一个隐式分配给每个用户的角色, 这些用户包括通过身份验证的用户和游客

Paul Walko

入口脚本

控制器

表单模型和Active Record

`<?php $this->render('edit', array( 'var1'=>$value1, 'var2'=>$value2, )); ?>`

`<?php public function onClicked($event) { $this->raiseEvent('onClicked', $event); } ?>`

`<?php Yii::$classMap=array( 'ClassName1' => 'path/to/ClassName1.php', 'ClassName2' => 'path/to/ClassName2.php', ...... ); ?>`

导入目录: `Yii::import('system.web.*');`

使用表单

使用表单生成器 @todo

数据访问对象(DAO)

执行 SQL 语句

Active Record

关系型 Active Record

数据库迁移 @todo

配置

存取操作

基本使用方法

页面缓存

COutputCache

CHttpCacheFilter

`<?php if($this->beginCache($id)) { ?> ...被缓存的片段内容... <?php $this->renderDynamic($callback); ?> ...被缓存的片段内容... <?php $this->endCache(); } ?>`

URL 管理

基于角色的访问控制(Role-Based Access Control)

入口脚本

控制器

表单模型和Active Record

<?php $this->render('edit', array( 'var1'=>$value1, 'var2'=>$value2, )); ?>

<?php public function onClicked($event) { $this->raiseEvent('onClicked', $event); } ?>

<?php Yii::$classMap=array( 'ClassName1' => 'path/to/ClassName1.php', 'ClassName2' => 'path/to/ClassName2.php', ...... ); ?> 导入目录: Yii::import('system.web.*');

使用表单

使用表单生成器 @todo

数据访问对象(DAO)

执行 SQL 语句

Active Record

关系型 Active Record

数据库迁移 @todo

配置

存取操作

基本使用方法

页面缓存

COutputCache

CHttpCacheFilter

<?php if($this->beginCache($id)) { ?> ...被缓存的片段内容... <?php $this->renderDynamic($callback); ?> ...被缓存的片段内容... <?php $this->endCache(); } ?>

URL 管理

基于角色的访问控制(Role-Based Access Control)

`<?php $this->render('edit', array( 'var1'=>$value1, 'var2'=>$value2, )); ?>`

`<?php public function onClicked($event) { $this->raiseEvent('onClicked', $event); } ?>`

`<?php Yii::$classMap=array( 'ClassName1' => 'path/to/ClassName1.php', 'ClassName2' => 'path/to/ClassName2.php', ...... ); ?>`

导入目录: `Yii::import('system.web.*');`

`<?php if($this->beginCache($id)) { ?> ...被缓存的片段内容... <?php $this->renderDynamic($callback); ?> ...被缓存的片段内容... <?php $this->endCache(); } ?>`