CController

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

Property Details

action property

public CAction getAction()
public void setAction(CAction $value)

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

actionParams property read-only (available since v1.1.7)

public array getActionParams()

Returns the request parameters that will be used for action parameter binding. By default, this method will return $_GET. You may override this method if you want to use other request parameters (e.g. $_GET+$_POST).

cachingStack property read-only

public CStack getCachingStack(boolean $createIfNull=true)

stack of COutputCache objects

clips property read-only

public CMap getClips()

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

defaultAction property

public string $defaultAction;

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

id property read-only

public string getId()

ID of the controller

layout property

public mixed $layout;

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. The module layout will be used if the controller belongs to a module and this layout property is null.

module property read-only

public CWebModule getModule()

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

pageTitle property

public string getPageTitle()
public void setPageTitle(string $value)

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

route property read-only (available since v1.1.0)

public string getRoute()

the route (module ID, controller ID and action ID) of the current request.

uniqueId property read-only

public string getUniqueId()

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

viewPath property read-only

public string getViewPath()

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, the default view path is the module view path appended with the controller ID.

Method Details

__construct() method

public void __construct(string $id, CWebModule $module=NULL)

public function __construct($id,$module=null)
{
    $this->_id=$id;
    $this->_module=$module;
    $this->attachBehaviors($this->behaviors());
}

accessRules() method

public array accessRules()

public function accessRules()
{
    return array();
}

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

actions() method

public array actions()

public function actions()
{
    return array();
}

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',
        ),
    ),
)

afterAction() method

protected void afterAction(CAction $action)

protected function afterAction($action)
{
}

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

afterRender() method (available since v1.1.5)

protected void afterRender(string $view, string &$output)

protected function afterRender($view, &$output)
{
}

This method is invoked after the specified view is rendered by calling render(). Note that this method is invoked BEFORE processOutput(). You may override this method to do some postprocessing for the view rendering.

beforeAction() method

protected boolean beforeAction(CAction $action)

protected function beforeAction($action)
{
    return true;
}

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.

beforeRender() method (available since v1.1.5)

protected boolean beforeRender(string $view)

protected function beforeRender($view)
{
    return true;
}

This method is invoked at the beginning of render(). You may override this method to do some preprocessing when rendering a view.

behaviors() method

public array behaviors()

public function behaviors()
{
    return array();
}

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',
)

clearPageStates() method

public void clearPageStates()

public function clearPageStates()
{
    $this->_pageStates=array();
}

Removes all page states.

createAbsoluteUrl() method

public string createAbsoluteUrl(string $route, array $params=array ( ), string $schema='', string $ampersand='&')

public function createAbsoluteUrl($route,$params=array(),$schema='',$ampersand='&')
{
    $url=$this->createUrl($route,$params,$ampersand);
    if(strpos($url,'http')===0)
        return $url;
    else
        return Yii::app()->getRequest()->getHostInfo($schema).$url;
}

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

createAction() method

public CAction createAction(string $actionID)

public function createAction($actionID)
{
    if($actionID==='')
        $actionID=$this->defaultAction;
    if(method_exists($this,'action'.$actionID) && strcasecmp($actionID,'s')) // we have actions method
        return new CInlineAction($this,$actionID);
    else
    {
        $action=$this->createActionFromMap($this->actions(),$actionID,$actionID);
        if($action!==null && !method_exists($action,'run'))
            throw new CException(Yii::t('yii', 'Action class {class} must implement the "run" method.', array('{class}'=>get_class($action))));
        return $action;
    }
}

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.

createActionFromMap() method

protected CAction createActionFromMap(array $actionMap, string $actionID, string $requestActionID, array $config=array ( ))

protected function createActionFromMap($actionMap,$actionID,$requestActionID,$config=array())
{
    if(($pos=strpos($actionID,'.'))===false && isset($actionMap[$actionID]))
    {
        $baseConfig=is_array($actionMap[$actionID]) ? $actionMap[$actionID] : array('class'=>$actionMap[$actionID]);
        return Yii::createComponent(empty($config)?$baseConfig:array_merge($baseConfig,$config),$this,$requestActionID);
    }
    elseif($pos===false)
        return null;

    // the action is defined in a provider
    $prefix=substr($actionID,0,$pos+1);
    if(!isset($actionMap[$prefix]))
        return null;
    $actionID=(string)substr($actionID,$pos+1);

    $provider=$actionMap[$prefix];
    if(is_string($provider))
        $providerType=$provider;
    elseif(is_array($provider) && isset($provider['class']))
    {
        $providerType=$provider['class'];
        if(isset($provider[$actionID]))
        {
            if(is_string($provider[$actionID]))
                $config=array_merge(array('class'=>$provider[$actionID]),$config);
            else
                $config=array_merge($provider[$actionID],$config);
        }
    }
    else
        throw new CException(Yii::t('yii','Object configuration must be an array containing a "class" element.'));

    $class=Yii::import($providerType,true);
    $map=call_user_func(array($class,'actions'));

    return $this->createActionFromMap($map,$actionID,$requestActionID,$config);
}

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.

createUrl() method

public string createUrl(string $route, array $params=array ( ), string $ampersand='&')

public function createUrl($route,$params=array(),$ampersand='&')
{
    if($route==='')
        $route=$this->getId().'/'.$this->getAction()->getId();
    elseif(strpos($route,'/')===false)
        $route=$this->getId().'/'.$route;
    if($route[0]!=='/' && ($module=$this->getModule())!==null)
        $route=$module->getId().'/'.$route;
    return Yii::app()->createUrl(trim($route,'/'),$params,$ampersand);
}

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

filterAccessControl() method

public void filterAccessControl(CFilterChain $filterChain)

public function filterAccessControl($filterChain)
{
    $filter=new CAccessControlFilter;
    $filter->setRules($this->accessRules());
    $filter->filter($filterChain);
}

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

filterAjaxOnly() method

public void filterAjaxOnly(CFilterChain $filterChain)

public function filterAjaxOnly($filterChain)
{
    if(Yii::app()->getRequest()->getIsAjaxRequest())
        $filterChain->run();
    else
        throw new CHttpException(400,Yii::t('yii','Your request is invalid.'));
}

The filter method for 'ajaxOnly' filter. This filter throws an exception (CHttpException with code 400) if the applied action is receiving a non-AJAX request.

filterPostOnly() method

public void filterPostOnly(CFilterChain $filterChain)

public function filterPostOnly($filterChain)
{
    if(Yii::app()->getRequest()->getIsPostRequest())
        $filterChain->run();
    else
        throw new CHttpException(400,Yii::t('yii','Your request is invalid.'));
}

The filter method for 'postOnly' filter. This filter throws an exception (CHttpException with code 400) if the applied action is receiving a non-POST request.

filters() method

public array filters()

public function filters()
{
    return array();
}

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',
    ...
)

forward() method (available since v1.1.0)

public void forward(string $route, boolean $exit=true)

public function forward($route,$exit=true)
{
    if(strpos($route,'/')===false)
        $this->run($route);
    else
    {
        if($route[0]!=='/' && ($module=$this->getModule())!==null)
            $route=$module->getId().'/'.$route;
        Yii::app()->runController($route);
    }
    if($exit)
        Yii::app()->end();
}

Processes the request using another controller action. This is like redirect, but the user browser's URL remains unchanged. In most cases, you should call redirect instead of this method.

getAction() method

public CAction getAction()

public function getAction()
{
    return $this->_action;
}

getActionParams() method (available since v1.1.7)

public array getActionParams()

public function getActionParams()
{
    return $_GET;
}

Returns the request parameters that will be used for action parameter binding. By default, this method will return $_GET. You may override this method if you want to use other request parameters (e.g. $_GET+$_POST).

getCachingStack() method

public CStack getCachingStack(boolean $createIfNull=true)

public function getCachingStack($createIfNull=true)
{
    if(!$this->_cachingStack)
        $this->_cachingStack=new CStack;
    return $this->_cachingStack;
}

getClips() method

public CMap getClips()

public function getClips()
{
    if($this->_clips!==null)
        return $this->_clips;
    else
        return $this->_clips=new CMap;
}

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

getId() method

public string getId()

public function getId()
{
    return $this->_id;
}

getLayoutFile() method

public string getLayoutFile(mixed $layoutName)

public function getLayoutFile($layoutName)
{
    if($layoutName===false)
        return false;
    if(($theme=Yii::app()->getTheme())!==null && ($layoutFile=$theme->getLayoutFile($this,$layoutName))!==false)
        return $layoutFile;

    if(empty($layoutName))
    {
        $module=$this->getModule();
        while($module!==null)
        {
            if($module->layout===false)
                return false;
            if(!empty($module->layout))
                break;
            $module=$module->getParentModule();
        }
        if($module===null)
            $module=Yii::app();
        $layoutName=$module->layout;
    }
    elseif(($module=$this->getModule())===null)
        $module=Yii::app();

    return $this->resolveViewFile($layoutName,$module->getLayoutPath(),Yii::app()->getViewPath(),$module->getViewPath());
}

Looks for the layout view script based on the layout name.

The layout name can be specified in one of the following ways:

• layout is false: returns false, meaning no layout.
• layout is null: the currently active module's layout will be used. If there is no active module, the application's layout will be used.
• a regular view name.

• When a theme is currently active, this method will call CTheme::getLayoutFile to determine which view file should be returned.
• absolute view within a module: the view name starts with a single slash '/'. In this case, the view will be searched for under the currently active module's view path. If there is no active module, the view will be searched for under the application's view path.
• absolute view within the application: the view name starts with double slashes '//'. In this case, the view will be searched for under the application's view path. This syntax has been available since version 1.1.3.
• aliased view: the view name contains dots and refers to a path alias. The view file is determined by calling YiiBase::getPathOfAlias(). Note that aliased views cannot be themed because they can refer to a view file located at arbitrary places.
• relative view: otherwise. Relative views will be searched for under the currently active module's layout path. In case when there is no active module, the view will be searched for under the application's layout path.

getModule() method

public CWebModule getModule()

public function getModule()
{
    return $this->_module;
}

getPageState() method

public mixed getPageState(string $name, mixed $defaultValue=NULL)

public function getPageState($name,$defaultValue=null)
{
    if($this->_pageStates===null)
        $this->_pageStates=$this->loadPageStates();
    return isset($this->_pageStates[$name])?$this->_pageStates[$name]:$defaultValue;
}

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.

getPageTitle() method

public string getPageTitle()

public function getPageTitle()
{
    if($this->_pageTitle!==null)
        return $this->_pageTitle;
    else
    {
        $name=ucfirst(basename($this->getId()));
        if($this->getAction()!==null && strcasecmp($this->getAction()->getId(),$this->defaultAction))
            return $this->_pageTitle=Yii::app()->name.' - '.ucfirst($this->getAction()->getId()).' '.$name;
        else
            return $this->_pageTitle=Yii::app()->name.' - '.$name;
    }
}

getRoute() method (available since v1.1.0)

public string getRoute()

public function getRoute()
{
    if(($action=$this->getAction())!==null)
        return $this->getUniqueId().'/'.$action->getId();
    else
        return $this->getUniqueId();
}

getUniqueId() method

public string getUniqueId()

public function getUniqueId()
{
    return $this->_module ? $this->_module->getId().'/'.$this->_id : $this->_id;
}

getViewFile() method

public string getViewFile(string $viewName)

public function getViewFile($viewName)
{
    if(($theme=Yii::app()->getTheme())!==null && ($viewFile=$theme->getViewFile($this,$viewName))!==false)
        return $viewFile;
    $moduleViewPath=$basePath=Yii::app()->getViewPath();
    if(($module=$this->getModule())!==null)
        $moduleViewPath=$module->getViewPath();
    return $this->resolveViewFile($viewName,$this->getViewPath(),$basePath,$moduleViewPath);
}

Looks for the view file according to the given view name.

When a theme is currently active, this method will call CTheme::getViewFile to determine which view file should be returned.

Otherwise, this method will return the corresponding view file based on the following criteria:

• absolute view within a module: the view name starts with a single slash '/'. In this case, the view will be searched for under the currently active module's view path. If there is no active module, the view will be searched for under the application's view path.
• absolute view within the application: the view name starts with double slashes '//'. In this case, the view will be searched for under the application's view path. This syntax has been available since version 1.1.3.
• aliased view: the view name contains dots and refers to a path alias. The view file is determined by calling YiiBase::getPathOfAlias(). Note that aliased views cannot be themed because they can refer to a view file located at arbitrary places.
• relative view: otherwise. Relative views will be searched for under the currently active controller's view path.

getViewPath() method

public string getViewPath()

public function getViewPath()
{
    if(($module=$this->getModule())===null)
        $module=Yii::app();
    return $module->getViewPath().DIRECTORY_SEPARATOR.$this->getId();
}

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, the default view path is the module view path appended with the controller ID.

init() method

public void init()

public function init()
{
}

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.

invalidActionParams() method (available since v1.1.7)

public void invalidActionParams(CAction $action)

public function invalidActionParams($action)
{
    throw new CHttpException(400,Yii::t('yii','Your request is invalid.'));
}

This method is invoked when the request parameters do not satisfy the requirement of the specified action. The default implementation will throw a 400 HTTP exception.

isCachingStackEmpty() method

public boolean isCachingStackEmpty()

public function isCachingStackEmpty()
{
    return $this->_cachingStack===null || !$this->_cachingStack->getCount();
}

Returns whether the caching stack is empty.

loadPageStates() method

protected array loadPageStates()

protected function loadPageStates()
{
    if(!empty($_POST[self::STATE_INPUT_NAME]))
    {
        if(($data=base64_decode($_POST[self::STATE_INPUT_NAME]))!==false)
        {
            if(extension_loaded('zlib'))
                $data=@gzuncompress($data);
            if(($data=Yii::app()->getSecurityManager()->validateData($data))!==false)
                return unserialize($data);
        }
    }
    return array();
}

Loads page states from a hidden input.

missingAction() method

public void missingAction(string $actionID)

public function missingAction($actionID)
{
    throw new CHttpException(404,Yii::t('yii','The system is unable to find the requested action "{action}".',
        array('{action}'=>$actionID==''?$this->defaultAction:$actionID)));
}

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.

processDynamicOutput() method

public string processDynamicOutput(string $output)

public function processDynamicOutput($output)
{
    if($this->_dynamicOutput)
    {
        $output=preg_replace_callback('/<###dynamic-(\d+)###>/',array($this,'replaceDynamicOutput'),$output);
    }
    return $output;
}

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

processOutput() method

public string processOutput(string $output)

public function processOutput($output)
{
    Yii::app()->getClientScript()->render($output);

    // if using page caching, we should delay dynamic output replacement
    if($this->_dynamicOutput!==null && $this->isCachingStackEmpty())
    {
        $output=$this->processDynamicOutput($output);
        $this->_dynamicOutput=null;
    }

    if($this->_pageStates===null)
        $this->_pageStates=$this->loadPageStates();
    if(!empty($this->_pageStates))
        $this->savePageStates($this->_pageStates,$output);

    return $output;
}

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.

recordCachingAction() method

public void recordCachingAction(string $context, string $method, array $params)

public function recordCachingAction($context,$method,$params)
{
    if($this->_cachingStack) // record only when there is an active output cache
    {
        foreach($this->_cachingStack as $cache)
            $cache->recordAction($context,$method,$params);
    }
}

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.

redirect() method

public void redirect(mixed $url, boolean $terminate=true, integer $statusCode=302)

public function redirect($url,$terminate=true,$statusCode=302)
{
    if(is_array($url))
    {
        $route=isset($url[0]) ? $url[0] : '';
        $url=$this->createUrl($route,array_splice($url,1));
    }
    Yii::app()->getRequest()->redirect($url,$terminate,$statusCode);
}

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

refresh() method

public void refresh(boolean $terminate=true, string $anchor='')

public function refresh($terminate=true,$anchor='')
{
    $this->redirect(Yii::app()->getRequest()->getUrl().$anchor,$terminate);
}

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).

render() method

public string render(string $view, array $data=NULL, boolean $return=false)

public function render($view,$data=null,$return=false)
{
    if($this->beforeRender($view))
    {
        $output=$this->renderPartial($view,$data,true);
        if(($layoutFile=$this->getLayoutFile($this->layout))!==false)
            $output=$this->renderFile($layoutFile,array('content'=>$output),true);

        $this->afterRender($view,$output);

        $output=$this->processOutput($output);

        if($return)
            return $output;
        else
            echo $output;
    }
}

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.

renderClip() method (available since v1.1.8)

public mixed renderClip(string $name, array $params=array ( ), boolean $return=false)

public function renderClip($name,$params=array(),$return=false)
{
    $text=isset($this->clips[$name]) ? strtr($this->clips[$name], $params) : '';

    if($return)
        return $text;
    else
        echo $text;
}

Renders a named clip with the supplied parameters. This is similar to directly accessing the clips property. The main difference is that it can take an array of named parameters which will replace the corresponding placeholders in the clip.

renderDynamic() method

public void renderDynamic(callback $callback)

public function renderDynamic($callback)
{
    $n=count($this->_dynamicOutput);
    echo "<###dynamic-$n###>";
    $params=func_get_args();
    array_shift($params);
    $this->renderDynamicInternal($callback,$params);
}

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.

renderDynamicInternal() method

public void renderDynamicInternal(callback $callback, array $params)

public function renderDynamicInternal($callback,$params)
{
    $this->recordCachingAction('','renderDynamicInternal',array($callback,$params));
    if(is_string($callback) && method_exists($this,$callback))
        $callback=array($this,$callback);
    $this->_dynamicOutput[]=call_user_func_array($callback,$params);
}

This method is internally used.

renderPartial() method

public string renderPartial(string $view, array $data=NULL, boolean $return=false, boolean $processOutput=false)

public function renderPartial($view,$data=null,$return=false,$processOutput=false)
{
    if(($viewFile=$this->getViewFile($view))!==false)
    {
        $output=$this->renderFile($viewFile,$data,true);
        if($processOutput)
            $output=$this->processOutput($output);
        if($return)
            return $output;
        else
            echo $output;
    }
    else
        throw new CException(Yii::t('yii','{controller} cannot find the requested view "{view}".',
            array('{controller}'=>get_class($this), '{view}'=>$view)));
}

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.

renderText() method

public string renderText(string $text, boolean $return=false)

public function renderText($text,$return=false)
{
    if(($layoutFile=$this->getLayoutFile($this->layout))!==false)
        $text=$this->renderFile($layoutFile,array('content'=>$text),true);

    $text=$this->processOutput($text);

    if($return)
        return $text;
    else
        echo $text;
}

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

replaceDynamicOutput() method

protected string replaceDynamicOutput(array $matches)

protected function replaceDynamicOutput($matches)
{
    $content=$matches[0];
    if(isset($this->_dynamicOutput[$matches[1]]))
    {
        $content=$this->_dynamicOutput[$matches[1]];
        $this->_dynamicOutput[$matches[1]]=null;
    }
    return $content;
}

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

resolveViewFile() method

public mixed resolveViewFile(string $viewName, string $viewPath, string $basePath, string $moduleViewPath=NULL)

public function resolveViewFile($viewName,$viewPath,$basePath,$moduleViewPath=null)
{
    if(empty($viewName))
        return false;

    if($moduleViewPath===null)
        $moduleViewPath=$basePath;

    if(($renderer=Yii::app()->getViewRenderer())!==null)
        $extension=$renderer->fileExtension;
    else
        $extension='.php';
    if($viewName[0]==='/')
    {
        if(strncmp($viewName,'//',2)===0)
            $viewFile=$basePath.$viewName;
        else
            $viewFile=$moduleViewPath.$viewName;
    }
    elseif(strpos($viewName,'.'))
        $viewFile=Yii::getPathOfAlias($viewName);
    else
        $viewFile=$viewPath.DIRECTORY_SEPARATOR.$viewName;

    if(is_file($viewFile.$extension))
        return Yii::app()->findLocalizedFile($viewFile.$extension);
    elseif($extension!=='.php' && is_file($viewFile.'.php'))
        return Yii::app()->findLocalizedFile($viewFile.'.php');
    else
        return false;
}

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

• absolute view within a module: the view name starts with a single slash '/'. In this case, the view will be searched for under the currently active module's view path. If there is no active module, the view will be searched for under the application's view path.
• absolute view within the application: the view name starts with double slashes '//'. In this case, the view will be searched for under the application's view path. This syntax has been available since version 1.1.3.
• aliased view: the view name contains dots and refers to a path alias. The view file is determined by calling YiiBase::getPathOfAlias(). Note that aliased views cannot be themed because they can refer to a view file located at arbitrary places.
• relative view: otherwise. Relative views will be searched for under the currently active controller's view path.

run() method

public void run(string $actionID)

public function run($actionID)
{
    if(($action=$this->createAction($actionID))!==null)
    {
        if(($parent=$this->getModule())===null)
            $parent=Yii::app();
        if($parent->beforeControllerAction($this,$action))
        {
            $this->runActionWithFilters($action,$this->filters());
            $parent->afterControllerAction($this,$action);
        }
    }
    else
        $this->missingAction($actionID);
}

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

runAction() method

public void runAction(CAction $action)

public function runAction($action)
{
    $priorAction=$this->_action;
    $this->_action=$action;
    if($this->beforeAction($action))
    {
        if($action->runWithParams($this->getActionParams())===false)
            $this->invalidActionParams($action);
        else
            $this->afterAction($action);
    }
    $this->_action=$priorAction;
}

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.

runActionWithFilters() method

public void runActionWithFilters(CAction $action, array $filters)

public function runActionWithFilters($action,$filters)
{
    if(empty($filters))
        $this->runAction($action);
    else
    {
        $priorAction=$this->_action;
        $this->_action=$action;
        CFilterChain::create($this,$action,$filters)->run();
        $this->_action=$priorAction;
    }
}

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.

savePageStates() method

protected void savePageStates(array $states, string &$output)

protected function savePageStates($states,&$output)
{
    $data=Yii::app()->getSecurityManager()->hashData(serialize($states));
    if(extension_loaded('zlib'))
        $data=gzcompress($data);
    $value=base64_encode($data);
    $output=str_replace(CHtml::pageStateField(''),CHtml::pageStateField($value),$output);
}

Saves page states as a base64 string.

setAction() method

public void setAction(CAction $value)

public function setAction($value)
{
    $this->_action=$value;
}

setPageState() method

public void setPageState(string $name, mixed $value, mixed $defaultValue=NULL)

public function setPageState($name,$value,$defaultValue=null)
{
    if($this->_pageStates===null)
        $this->_pageStates=$this->loadPageStates();
    if($value===$defaultValue)
        unset($this->_pageStates[$name]);
    else
        $this->_pageStates[$name]=$value;

    $params=func_get_args();
    $this->recordCachingAction('','setPageState',$params);
}

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.

setPageTitle() method

public void setPageTitle(string $value)

public function setPageTitle($value)
{
    $this->_pageTitle=$value;
}