使用扩展

    • 从 Yii 的 扩展库 下载扩展.
    • 解压到 的子目录 extensions/xyz 下,这里的 xyz 是扩展的名称.
    • 导入, 配置和使用扩展.
      每个扩展都有一个所有扩展中唯一的名称标识.把一个扩展命名为 ,我们也可以使用路径别名定位到包含了 xyz所有文件的基目录.

    不同的扩展有着不同的导入,配置,使用要求.以下是我们通常会用到扩展的场景,按照他们在 概述 中的描述分类.

    Before we start describing the usage of third-party extensions, we would like to introducethe Zii extension library, which is a set of extensions developed by the Yii developer teamand included in every release since Yii version 1.1.0. The Zii library is hosted as aGoogle project called .

    When using a Zii extension, one must refer to the corresponding class using a path aliasin the form of zii.path.to.ClassName. Here the root alias zii is predefined by Yii. It refersto the root directory of the Zii library. For example, to use CGridView, we would use thefollowing code in a view script when referring to the extension:

    2. 应用的部件

    使用 应用的部件,首先我们需要添加一个新条目到 的 components 属性, 如下所示:

    1. return array(
    2.     // 'preload'=>array('xyz',...),
    3.     'components'=>array(
    4.         'xyz'=>array(
    5.             'class'=>'application.extensions.xyz.XyzClass',
    6.             'property1'=>'value1',
    7.             'property2'=>'value2',
    8.         ),
    9.         // 其他部件配置
    10.     ),
    11. );

    然后,我们可以在任何地方通过使用 Yii::app()->xyz 来访问部件.部件将会被 惰性创建(就是,仅当它第一次被访问时创建.) ,除非我们把它配置到 preload 属性里.

    3. Behavior

    can be used in all sorts of components.Its usage involves two steps. In the first step, a behavior is attached to a target component.In the second step, a behavior method is called via the target component. For example:

    1. // $name uniquely identifies the behavior in the component
    2. $component->attachBehavior($name,$behavior);
    3. // test() is a method of $behavior
    4. $component->test();

    More often, a behavior is attached to a component using a configurative way instead ofcalling the attachBehavior method. For example, to attach a behavior to anapplication component, we coulduse the following:

    1. return array(
    2.     'components'=>array(
    3.         'db'=>array(
    4.             'class'=>'CDbConnection',
    5.             'behaviors'=>array(
    6.                 'xyz'=>array(
    7.                     'class'=>'ext.xyz.XyzBehavior',
    8.                     'property2'=>'value2',
    9.                 ),
    10.             ),
    11.         ),
    12.         //....
    13.     ),
    14. );

    For CController, and CActiveRecord classes which usually need to be extended,attaching behaviors can be done by overriding their behaviors() method. The classes willautomatically attach any behaviors declared in this method during initialization. For example,

    主要用在 视图 里.假设组件类 XyzClass 属于 xyz 扩展,我们可以如下在视图中使用它:

    1. // 组件不需要主体内容
    2. <?php $this->widget('application.extensions.xyz.XyzClass', array(
    3.     'property1'=>'value1',
    4.     'property2'=>'value2')); ?>
    5.  
    6. // 组件可以包含主体内容
    7. <?php $this->beginWidget('application.extensions.xyz.XyzClass', array(
    8.     'property1'=>'value1',
    9.     'property2'=>'value2')); ?>
    10.  
    11. ...组件的主体内容...
    12.  
    13. <?php $this->endWidget(); ?>

    5. 动作

    动作 被 用于响应指定的用户请求.假设动作的类 XyzClass 属于 xyz 扩展,我们可以在我们的控制器类里重写 CController::actions 方法来使用它:

    1. class TestController extends CController
    2. {
    3.     public function actions()
    4.     {
    5.         return array(
    6.             'xyz'=>array(
    7.                 'class'=>'application.extensions.xyz.XyzClass',
    8.                 'property1'=>'value1',
    9.                 'property2'=>'value2',
    10.             ),
    11.             // 其他动作
    12.         );
    13.     }
    14. }

    然后,我们可以通过 test/xyz 来访问.

    6. 过滤器

    也被 控制器 使用.过滤器主要用于当其被 挂起时预处理,提交处理用户请求.假设过滤器的类 XyzClass 属于 xyz 扩展,我们可以在我们的控制器类里重写 CController::filters 方法来使用它:

    1. class TestController extends CController
    2. {
    3.     {
    4.         return array(
    5.             array(
    6.                 'application.extensions.xyz.XyzClass',
    7.                 'property1'=>'value1',
    8.                 'property2'=>'value2',
    9.             ),
    10.             // 其他过滤器
    11.         );
    12.     }
    13. }

    在上述代码中,我们可以在数组的第一个元素离使用加号或者减号操作符来限定过滤器只在那些动作中生效.更多信息,请参照文档的 .

    控制器 提供了一套可以被用户请求的动作.我们需要在 里设置 CWebApplication::controllerMap 属性,才能在控制器里使用扩展:

    8. 校验器

    校验器主要用在 模型类(继承自 或者 CActiveRecord)中.假设校验器类 属于 xyz 扩展,我们可以在我们的模型类中通过 重写 CModel::rules 来使用它:

    1. class MyModel extends CActiveRecord // or CFormModel
    2. {
    3.     public function rules()
    4.     {
    5.         return array(
    6.             array(
    7.                 'attr1, attr2',
    8.                 'application.extensions.xyz.XyzClass',
    9.                 'property1'=>'value1',
    10.                 'property2'=>'value2',
    11.             ),
    12.             // 其他校验规则
    13.         );
    14.     }
    15. }

    9. 控制台命令

    控制台命令扩展通常使用一个额外的命令来增强 yiic 的功能.假设命令控制台 XyzClass 属于 xyz 扩展,我们可以通过设定控制台应用的配置来使用它:

    1. return array(
    2.     'commandMap'=>array(
    3.         'xyz'=>array(
    4.             'class'=>'application.extensions.xyz.XyzClass',
    5.             'property1'=>'value1',
    6.             'property2'=>'value2',
    7.         ),
    8.         // 其他命令
    9.     ),
    10. );

    然后,我们就能使用配备了额外命令 xyz 的 yiic 工具了.

    模块通常由多个类文件组成,且往往综合上述扩展类型.因此,你应该按照和以下一致的指令来使用模块.

    11. 通用部件

    使用一个通用 部件, 我们首先需要通过使用

      来包含它的类文件.然后,我们既可以创建一个类的实例,配置它的属性,也可以调用它的方法.我们还可以创建一个新的子类来扩展它.ss

      原文: