CController

array(
    'accessControl - login',
    'ajaxOnly + search',
    array(
        'COutputCache + list',
        'duration'=>300,
    ),
)

Property Details

the action currently being executed, null if no active action.

stack of COutputCache objects

Returns the list of clips. A clip is a named piece of rendering result that can be inserted at different places.

the name of the default action. Defaults to 'index'.

ID of the controller

the name of the layout to be applied to this controller's views. Defaults to null, meaning the application layout is used. If it is false, no layout will be applied. Since version 1.0.3, the module layout will be used if the controller belongs to a module and this layout property is null.

the module that this controller belongs to. It returns null if the controller does not belong to any module

the page title. Defaults to the controller name and the action name.

the controller ID that is prefixed with the module ID (if any).

Returns the directory containing view files for this controller. The default implementation returns 'protected/views/ControllerID'. Child classes may override this method to use customized view path. If the controller belongs to a module (since version 1.0.3), the default view path is the module view path appended with the controller ID.

Method Details

Returns the access rules for this controller. Override this method if you use the accessControl filter.

Returns a list of external action classes. Array keys are action IDs, and array values are the corresponding action class in dot syntax (e.g. 'edit'=>'application.controllers.article.EditArticle') or arrays representing the configuration of the actions, such as the following,

return array(
    'action1'=>'path.to.Action1Class',
    'action2'=>array(
        'class'=>'path.to.Action2Class',
        'property1'=>'value1',
        'property2'=>'value2',
    ),
);

return array(
    ...other actions...
    // import actions declared in ProviderClass::actions()
    // the action IDs will be prefixed with 'pro.'
    'pro.'=>'path.to.ProviderClass',
    // similar as above except that the imported actions are
    // configured with the specified initial property values
    'pro2.'=>array(
        'class'=>'path.to.ProviderClass',
        'action1'=>array(
            'property1'=>'value1',
        ),
        'action2'=>array(
            'property2'=>'value2',
        ),
    ),
)

This method is invoked right after an action is executed. You may override this method to do some postprocessing for the action.

This method is invoked right before an action is to be executed (after all possible filters.) You may override this method to do last-minute preparation for the action.

Returns a list of behaviors that this controller should behave as. The return value should be an array of behavior configurations indexed by behavior names. Each behavior configuration can be either a string specifying the behavior class or an array of the following structure:

'behaviorName'=>array(
    'class'=>'path.to.BehaviorClass',
    'property1'=>'value1',
    'property2'=>'value2',
)

Removes all page states.

Creates an absolute URL for the specified action defined in this controller.

Creates the action instance based on the action name. The action can be either an inline action or an object. The latter is created by looking up the action map specified in actions.

Creates the action instance based on the action map. This method will check to see if the action ID appears in the given action map. If so, the corresponding configuration will be used to create the action instance.

Creates a relative URL for the specified action defined in this controller.

The filter method for 'accessControl' filter. This filter is a wrapper of CAccessControlFilter. To use this filter, you must override accessRules method.

The filter method for 'ajaxOnly' filter. This filter reports an error if the applied action is receiving a non-AJAX request.

The filter method for 'postOnly' filter. This filter reports an error if the applied action is receiving a non-POST request.

Returns the filter configurations.

By overriding this method, child classes can specify filters to be applied to actions.

This method returns an array of filter specifications. Each array element specify a single filter.

For a method-based filter (called inline filter), it is specified as 'FilterName[ +|- Action1, Action2, ...]', where the '+' ('-') operators describe which actions should be (should not be) applied with the filter.

For a class-based filter, it is specified as an array like the following:

array(
    'FilterClass[ +|- Action1, Action2, ...]',
    'name1'=>'value1',
    'name2'=>'value2',
    ...
)

Returns the list of clips. A clip is a named piece of rendering result that can be inserted at different places.

Looks for the view script file for a layout. This method will look for the view under the application's layoutPath. If the view name starts with '/', the view will be looked for under the application's viewPath. If the view name is null, the application's default layout will be used. If the view name is false, this method simply returns false. Since version 1.0.2, the view name can also refer to a path alias if it contains dot characters. Since version 1.0.3, if the controller belongs to a module, the view file will be searched under the module layout path, and if the view name is null, the module default layout will be used.

Returns a persistent page state value. A page state is a variable that is persistent across POST requests of the same page. In order to use persistent page states, the form(s) must be stateful which are generated using CHtml::statefulForm.

Looks for the view file according to the given view name. This method will look for the view under the controller's viewPath. If the view name starts with '/', the view will be looked for under the application's viewPath. The view script file is named as "ViewName.php". A localized view file may be returned if internationalization is needed. See CApplication::findLocalizedFile for more details. Since version 1.0.2, the view name can also refer to a path alias if it contains dot characters. Since version 1.0.3, if the controller belongs to a module, the view file will be searched under the module view path.

Returns the directory containing view files for this controller. The default implementation returns 'protected/views/ControllerID'. Child classes may override this method to use customized view path. If the controller belongs to a module (since version 1.0.3), the default view path is the module view path appended with the controller ID.

Initializes the controller. This method is called by the application before the controller starts to execute. You may override this method to perform the needed initialization for the controller.

Loads page states from a hidden input.

Handles the request whose action is not recognized. This method is invoked when the controller cannot find the requested action. The default implementation simply throws an exception.

Generates pagination information. This method can be used to generate pagination information given item count and page size. The pagination information can then be passed to pagers for corresponding rendering.

Note: this method has been deprecated since version 1.0.1. You should directly use "new CPagination" to create a pagination object.

Postprocesses the dynamic output. This method is internally used. Do not call this method directly.

Postprocesses the output generated by render(). This method is invoked at the end of render() and renderText(). If there are registered client scripts, this method will insert them into the output at appropriate places. If there are dynamic contents, they will also be inserted. This method may also save the persistent page states in hidden fields of stateful forms in the page.

Records a method call when an output cache is in effect. When the content is served from the output cache, the recorded method will be re-invoked.

Redirects the browser to the specified URL or route (controller/action).

Refreshes the current page. The effect of this method call is the same as user pressing the refresh button on the browser (without post data).

Renders a view with a layout.

This method first calls renderPartial to render the view (called content view). It then renders the layout view which may embed the content view at appropriate place. In the layout view, the content view rendering result can be accessed via variable $content. At the end, it calls processOutput to insert scripts and dynamic contents if they are available.

By default, the layout view script is "protected/views/layouts/main.php". This may be customized by changing layout.

Renders dynamic content returned by the specified callback. This method is used together with COutputCache. Dynamic contents will always show as their latest state even if the content surrounding them is being cached. This is especially useful when caching pages that are mostly static but contain some small dynamic regions, such as username or current time. We can use this method to render these dynamic regions to ensure they are always up-to-date.

The first parameter to this method should be a valid PHP callback, while the rest parameters will be passed to the callback.

Note, the callback and its parameter values will be serialized and saved in cache. Make sure they are serializable.

This method is internally used.

Renders a view.

The named view refers to a PHP script (resolved via getViewFile) that is included by this method. If $data is an associative array, it will be extracted as PHP variables and made available to the script.

This method differs from render() in that it does not apply a layout to the rendered result. It is thus mostly used in rendering a partial view, or an AJAX response.

Renders a static text string. The string will be inserted in the current controller layout and returned back.

Replaces the dynamic content placeholders with actual content. This is a callback function used internally.

Finds a view file based on its name. The view name can be in one of the following formats:

• absolute view: the view name starts with a slash '/'.
• aliased view: the view name contains dots and refers to a path alias. The view file is determined by calling YiiBase::getPathOfAlias().
• relative view: otherwise.

Runs the named action. Filters specified via filters() will be applied.

Runs the action after passing through all filters. This method is invoked by runActionWithFilters after all possible filters have been executed and the action starts to run.

Runs an action with the specified filters. A filter chain will be created based on the specified filters and the action will be executed then.

Saves page states as a base64 string.

Saves a persistent page state value. A page state is a variable that is persistent across POST requests of the same page. In order to use persistent page states, the form(s) must be stateful which are generated using CHtml::statefulForm.