CWebApplication
Package | system.web |
---|---|
Inheritance | class CWebApplication » CApplication » CModule » CComponent |
Since | 1.0 |
Source Code | framework/web/CWebApplication.php |
CWebApplication manages the controllers in MVC pattern, and provides the following additional core application components:
- urlManager: provides URL parsing and constructing functionality;
- request: encapsulates the Web request information;
- session: provides the session-related functionalities;
- assetManager: manages the publishing of private asset files.
- user: represents the user session information.
- themeManager: manages themes.
- authManager: manages role-based access control (RBAC).
- clientScript: manages client scripts (javascripts and CSS).
- widgetFactory: creates widgets and supports widget skinning.
User requests are resolved as controller-action pairs and additional parameters. CWebApplication creates the requested controller instance and let it to handle the actual user request. If the user does not specify controller ID, it will assume defaultController is requested (which defaults to 'site').
Controller class files must reside under the directory controllerPath (defaults to 'protected/controllers'). The file name and the class name must be the same as the controller ID with the first letter in upper case and appended with 'Controller'. For example, the controller 'article' is defined by the class 'ArticleController' which is in the file 'protected/controllers/ArticleController.php'.
Public Properties
Property | Type | Description | Defined By |
---|---|---|---|
assetManager | CAssetManager | the asset manager component | CWebApplication |
authManager | IAuthManager | the authorization manager component | CWebApplication |
basePath | string | Returns the root path of the application. | CApplication |
baseUrl | string | Returns the relative URL for the application. | CApplication |
behaviors | array | the behaviors that should be attached to the module. | CModule |
cache | CCache | Returns the cache component. | CApplication |
catchAllRequest | array | the configuration specifying a controller which should handle all user requests. | CWebApplication |
charset | string | the charset currently used for the application. | CApplication |
clientScript | CClientScript | Returns the client script manager. | CWebApplication |
components | array | Returns the application components. | CModule |
controller | CController | the currently active controller | CWebApplication |
controllerMap | array | mapping from controller ID to controller configurations. | CWebApplication |
controllerNamespace | string | Namespace that should be used when loading controllers. | CWebApplication |
controllerPath | string | the directory that contains the controller classes. | CWebApplication |
coreMessages | CPhpMessageSource | Returns the core message translations component. | CApplication |
dateFormatter | CDateFormatter | Returns the locale-dependent date formatter. | CApplication |
db | CDbConnection | Returns the database connection component. | CApplication |
defaultController | string | the route of the default controller, action or module. | CWebApplication |
errorHandler | CErrorHandler | Returns the error handler component. | CApplication |
extensionPath | string | Returns the root directory that holds all third-party extensions. | CApplication |
format | CFormatter | Returns the formatter component. | CApplication |
homeUrl | string | the homepage URL | CApplication |
id | string | Returns the unique identifier for the application. | CApplication |
language | string | Returns the language that the user is using and the application should be targeted to. | CApplication |
layout | mixed | the application-wide layout. | CWebApplication |
layoutPath | string | the root directory of layout files. | CWebApplication |
locale | CLocale | Returns the locale instance. | CApplication |
localeClass | string | the class used to get locale data. | CApplication |
localeDataPath | string | Returns the directory that contains the locale data. | CApplication |
messages | CMessageSource | Returns the application message translations component. | CApplication |
modulePath | string | Returns the directory that contains the application modules. | CModule |
modules | array | Returns the configuration of the currently installed modules. | CModule |
name | string | the application name. | CApplication |
numberFormatter | CNumberFormatter | the locale-dependent number formatter. | CApplication |
params | CAttributeCollection | Returns user-defined parameters. | CModule |
parentModule | CModule | Returns the parent module. | CModule |
preload | array | the IDs of the application components that should be preloaded. | CModule |
request | CHttpRequest | Returns the request component. | CApplication |
runtimePath | string | Returns the directory that stores runtime files. | CApplication |
securityManager | CSecurityManager | Returns the security manager component. | CApplication |
session | CHttpSession | the session component | CWebApplication |
sourceLanguage | string | the language that the application is written in. | CApplication |
statePersister | CStatePersister | Returns the state persister component. | CApplication |
systemViewPath | string | the root directory of system view files. | CWebApplication |
theme | CTheme | the theme used currently. | CWebApplication |
themeManager | CThemeManager | the theme manager. | CWebApplication |
timeZone | string | Returns the time zone used by this application. | CApplication |
urlManager | CUrlManager | Returns the URL manager component. | CApplication |
user | CWebUser | the user session information | CWebApplication |
viewPath | string | the root directory of view files. | CWebApplication |
viewRenderer | IViewRenderer | Returns the view renderer. | CWebApplication |
widgetFactory | IWidgetFactory | Returns the widget factory. | CWebApplication |
Public Methods
Method | Description | Defined By |
---|---|---|
__call() | Calls the named method which is not a class method. | CComponent |
__construct() | Constructor. | CApplication |
__get() | Getter magic method. | CModule |
__isset() | Checks if a property value is null. | CModule |
__set() | Sets value of a component property. | CComponent |
__unset() | Sets a component property to be null. | CComponent |
afterControllerAction() | The post-filter for controller actions. | CWebApplication |
asa() | Returns the named behavior object. | CComponent |
attachBehavior() | Attaches a behavior to this component. | CComponent |
attachBehaviors() | Attaches a list of behaviors to the component. | CComponent |
attachEventHandler() | Attaches an event handler to an event. | CComponent |
beforeControllerAction() | The pre-filter for controller actions. | CWebApplication |
canGetProperty() | Determines whether a property can be read. | CComponent |
canSetProperty() | Determines whether a property can be set. | CComponent |
clearGlobalState() | Clears a global value. | CApplication |
configure() | Configures the module with the specified configuration. | CModule |
createAbsoluteUrl() | Creates an absolute URL based on the given controller and action information. | CApplication |
createController() | Creates a controller instance based on a route. | CWebApplication |
createUrl() | Creates a relative URL based on the given controller and action information. | CApplication |
detachBehavior() | Detaches a behavior from the component. | CComponent |
detachBehaviors() | Detaches all behaviors from the component. | CComponent |
detachEventHandler() | Detaches an existing event handler. | CComponent |
disableBehavior() | Disables an attached behavior. | CComponent |
disableBehaviors() | Disables all behaviors attached to this component. | CComponent |
displayError() | Displays the captured PHP error. | CApplication |
displayException() | Displays the uncaught PHP exception. | CApplication |
enableBehavior() | Enables an attached behavior. | CComponent |
enableBehaviors() | Enables all behaviors attached to this component. | CComponent |
end() | Terminates the application. | CApplication |
evaluateExpression() | Evaluates a PHP expression or callback under the context of this component. | CComponent |
findLocalizedFile() | Returns the localized version of a specified file. | CApplication |
findModule() | Do not call this method. This method is used internally to search for a module by its ID. | CWebApplication |
getAssetManager() | Returns the asset manager component | CWebApplication |
getAuthManager() | Returns the authorization manager component | CWebApplication |
getBasePath() | Returns the root path of the application. | CApplication |
getBaseUrl() | Returns the relative URL for the application. | CApplication |
getCache() | Returns the cache component. | CApplication |
getClientScript() | Returns the client script manager. | CWebApplication |
getComponent() | Retrieves the named application component. | CModule |
getComponents() | Returns the application components. | CModule |
getController() | Returns the currently active controller | CWebApplication |
getControllerPath() | Returns the directory that contains the controller classes. Defaults to 'protected/controllers'. | CWebApplication |
getCoreMessages() | Returns the core message translations component. | CApplication |
getDateFormatter() | Returns the locale-dependent date formatter. | CApplication |
getDb() | Returns the database connection component. | CApplication |
getErrorHandler() | Returns the error handler component. | CApplication |
getEventHandlers() | Returns the list of attached event handlers for an event. | CComponent |
getExtensionPath() | Returns the root directory that holds all third-party extensions. | CApplication |
getFormat() | Returns the formatter component. | CApplication |
getGlobalState() | Returns a global value. | CApplication |
getHomeUrl() | Returns the homepage URL | CApplication |
getId() | Returns the unique identifier for the application. | CApplication |
getLanguage() | Returns the language that the user is using and the application should be targeted to. | CApplication |
getLayoutPath() | Returns the root directory of layout files. Defaults to 'protected/views/layouts'. | CWebApplication |
getLocale() | Returns the locale instance. | CApplication |
getLocaleDataPath() | Returns the directory that contains the locale data. | CApplication |
getMessages() | Returns the application message translations component. | CApplication |
getModule() | Retrieves the named application module. | CModule |
getModulePath() | Returns the directory that contains the application modules. | CModule |
getModules() | Returns the configuration of the currently installed modules. | CModule |
getNumberFormatter() | Returns the locale-dependent number formatter. The current application locale will be used. | CApplication |
getParams() | Returns user-defined parameters. | CModule |
getParentModule() | Returns the parent module. | CModule |
getRequest() | Returns the request component. | CApplication |
getRuntimePath() | Returns the directory that stores runtime files. | CApplication |
getSecurityManager() | Returns the security manager component. | CApplication |
getSession() | Returns the session component | CWebApplication |
getStatePersister() | Returns the state persister component. | CApplication |
getSystemViewPath() | Returns the root directory of system view files. Defaults to 'protected/views/system'. | CWebApplication |
getTheme() | Returns the theme used currently. Null if no theme is being used. | CWebApplication |
getThemeManager() | Returns the theme manager. | CWebApplication |
getTimeZone() | Returns the time zone used by this application. | CApplication |
getUrlManager() | Returns the URL manager component. | CApplication |
getUser() | Returns the user session information | CWebApplication |
getViewPath() | Returns the root directory of view files. Defaults to 'protected/views'. | CWebApplication |
getViewRenderer() | Returns the view renderer. | CWebApplication |
getWidgetFactory() | Returns the widget factory. | CWebApplication |
handleError() | Handles PHP execution errors such as warnings, notices. | CApplication |
handleException() | Handles uncaught PHP exceptions. | CApplication |
hasComponent() | Checks whether the named component exists. | CModule |
hasEvent() | Determines whether an event is defined. | CComponent |
hasEventHandler() | Checks whether the named event has attached handlers. | CComponent |
hasModule() | Returns a value indicating whether the specified module is installed. | CModule |
hasProperty() | Determines whether a property is defined. | CComponent |
loadGlobalState() | Loads the global state data from persistent storage. | CApplication |
onBeginRequest() | Raised right BEFORE the application processes the request. | CApplication |
onEndRequest() | Raised right AFTER the application processes the request. | CApplication |
onError() | Raised when a PHP execution error occurs. | CApplication |
onException() | Raised when an uncaught PHP exception occurs. | CApplication |
processRequest() | Processes the current request. | CWebApplication |
raiseEvent() | Raises an event. | CComponent |
run() | Runs the application. | CApplication |
runController() | Creates the controller and performs the specified action. | CWebApplication |
saveGlobalState() | Saves the global state data into persistent storage. | CApplication |
setAliases() | Defines the root aliases. | CModule |
setBasePath() | Sets the root directory of the application. | CApplication |
setComponent() | Puts a component under the management of the module. | CModule |
setComponents() | Sets the application components. | CModule |
setController() | Sets the currently active controller | CWebApplication |
setControllerPath() | Sets the directory that contains the controller classes. | CWebApplication |
setExtensionPath() | Sets the root directory that holds all third-party extensions. | CApplication |
setGlobalState() | Sets a global value. | CApplication |
setHomeUrl() | Sets the homepage URL | CApplication |
setId() | Sets the unique identifier for the application. | CApplication |
setImport() | Sets the aliases that are used in the module. | CModule |
setLanguage() | Specifies which language the application is targeted to. | CApplication |
setLayoutPath() | Sets the root directory of layout files. | CWebApplication |
setLocaleDataPath() | Sets the directory that contains the locale data. | CApplication |
setModulePath() | Sets the directory that contains the application modules. | CModule |
setModules() | Configures the sub-modules of this module. | CModule |
setParams() | Sets user-defined parameters. | CModule |
setRuntimePath() | Sets the directory that stores runtime files. | CApplication |
setSystemViewPath() | Sets the root directory of system view files. | CWebApplication |
setTheme() | Sets the theme name | CWebApplication |
setTimeZone() | Sets the time zone used by this application. | CApplication |
setViewPath() | Sets the root directory of view files. | CWebApplication |
Protected Methods
Method | Description | Defined By |
---|---|---|
init() | Initializes the application. | CWebApplication |
initSystemHandlers() | Initializes the error handlers. | CApplication |
parseActionParams() | Parses a path info into an action ID and GET variables. | CWebApplication |
preinit() | Preinitializes the module. | CModule |
preloadComponents() | Loads static application components. | CModule |
registerCoreComponents() | Registers the core application components. | CWebApplication |
Events
Event | Description | Defined By |
---|---|---|
onBeginRequest | Raised right BEFORE the application processes the request. | CApplication |
onEndRequest | Raised right AFTER the application processes the request. | CApplication |
onException | Raised when an uncaught PHP exception occurs. | CApplication |
onError | Raised when a PHP execution error occurs. | CApplication |
Property Details
assetManager property read-only
public CAssetManager getAssetManager()
the asset manager component
authManager property read-only
public IAuthManager getAuthManager()
the authorization manager component
catchAllRequest property
public array $catchAllRequest;
the configuration specifying a controller which should handle all user requests. This is mainly used when the application is in maintenance mode and we should use a controller to handle all incoming requests. The configuration specifies the controller route (the first element) and GET parameters (the rest name-value pairs). For example,
array( 'offline/notice', 'param1'=>'value1', 'param2'=>'value2', )Defaults to null, meaning catch-all is not effective.
clientScript property read-only
public CClientScript getClientScript()
Returns the client script manager.
controller property
public CController getController()
public void setController(CController $value)
the currently active controller
controllerMap property
public array $controllerMap;
mapping from controller ID to controller configurations. Each name-value pair specifies the configuration for a single controller. A controller configuration can be either a string or an array. If the former, the string should be the class name or class path alias of the controller. If the latter, the array must contain a 'class' element which specifies the controller's class name or class path alias. The rest name-value pairs in the array are used to initialize the corresponding controller properties. For example,
array( 'post'=>array( 'class'=>'path.to.PostController', 'pageTitle'=>'something new', ), 'user'=>'path.to.UserController', )
Note, when processing an incoming request, the controller map will first be checked to see if the request can be handled by one of the controllers in the map. If not, a controller will be searched for under the default controller path.
controllerNamespace property (available since v1.1.11)
public string $controllerNamespace;
Namespace that should be used when loading controllers. Default is to use global namespace.
controllerPath property
public string getControllerPath()
public void setControllerPath(string $value)
the directory that contains the controller classes. Defaults to 'protected/controllers'.
defaultController property
public string $defaultController;
the route of the default controller, action or module. Defaults to 'site'.
layout property
public mixed $layout;
the application-wide layout. Defaults to 'main' (relative to layoutPath). If this is false, then no layout will be used.
layoutPath property
public string getLayoutPath()
public void setLayoutPath(string $path)
the root directory of layout files. Defaults to 'protected/views/layouts'.
session property read-only
public CHttpSession getSession()
the session component
systemViewPath property
public string getSystemViewPath()
public void setSystemViewPath(string $path)
the root directory of system view files. Defaults to 'protected/views/system'.
theme property
public CTheme getTheme()
public void setTheme(string $value)
the theme used currently. Null if no theme is being used.
themeManager property read-only
public CThemeManager getThemeManager()
the theme manager.
user property read-only
public CWebUser getUser()
the user session information
viewPath property
public string getViewPath()
public void setViewPath(string $path)
the root directory of view files. Defaults to 'protected/views'.
viewRenderer property read-only
public IViewRenderer getViewRenderer()
Returns the view renderer. If this component is registered and enabled, the default view rendering logic defined in CBaseController will be replaced by this renderer.
widgetFactory property read-only (available since v1.1)
public IWidgetFactory getWidgetFactory()
Returns the widget factory.
Method Details
afterControllerAction() method
public void afterControllerAction(CController $controller, CAction $action) | ||
$controller | CController | the controller |
$action | CAction | the action |
public function afterControllerAction($controller,$action)
{
}
The post-filter for controller actions. This method is invoked after the currently requested controller action and all its filters are executed. You may override this method with logic that needs to be done after all controller actions.
beforeControllerAction() method
public boolean beforeControllerAction(CController $controller, CAction $action) | ||
$controller | CController | the controller |
$action | CAction | the action |
{return} | boolean | whether the action should be executed. |
public function beforeControllerAction($controller,$action)
{
return true;
}
The pre-filter for controller actions. This method is invoked before the currently requested controller action and all its filters are executed. You may override this method with logic that needs to be done before all controller actions.
createController() method
public array createController(string $route, CWebModule $owner=NULL) | ||
$route | string | the route of the request. |
$owner | CWebModule | the module that the new controller will belong to. Defaults to null, meaning the application instance is the owner. |
{return} | array | the controller instance and the action ID. Null if the controller class does not exist or the route is invalid. |
public function createController($route,$owner=null)
{
if($owner===null)
$owner=$this;
if((array)$route===$route || ($route=trim($route,'/'))==='')
$route=$owner->defaultController;
$caseSensitive=$this->getUrlManager()->caseSensitive;
$route.='/';
while(($pos=strpos($route,'/'))!==false)
{
$id=substr($route,0,$pos);
if(!preg_match('/^\w+$/',$id))
return null;
if(!$caseSensitive)
$id=strtolower($id);
$route=(string)substr($route,$pos+1);
if(!isset($basePath)) // first segment
{
if(isset($owner->controllerMap[$id]))
{
return array(
Yii::createComponent($owner->controllerMap[$id],$id,$owner===$this?null:$owner),
$this->parseActionParams($route),
);
}
if(($module=$owner->getModule($id))!==null)
return $this->createController($route,$module);
$basePath=$owner->getControllerPath();
$controllerID='';
}
else
$controllerID.='/';
$className=ucfirst($id).'Controller';
$classFile=$basePath.DIRECTORY_SEPARATOR.$className.'.php';
if($owner->controllerNamespace!==null)
$className=$owner->controllerNamespace.'\\'.str_replace('/','\\',$controllerID).$className;
if(is_file($classFile))
{
if(!class_exists($className,false))
require($classFile);
if(class_exists($className,false) && is_subclass_of($className,'CController'))
{
$id[0]=strtolower($id[0]);
return array(
new $className($controllerID.$id,$owner===$this?null:$owner),
$this->parseActionParams($route),
);
}
return null;
}
$controllerID.=$id;
$basePath.=DIRECTORY_SEPARATOR.$id;
}
}
Creates a controller instance based on a route. The route should contain the controller ID and the action ID. It may also contain additional GET variables. All these must be concatenated together with slashes.
This method will attempt to create a controller in the following order:
- If the first segment is found in controllerMap, the corresponding controller configuration will be used to create the controller;
- If the first segment is found to be a module ID, the corresponding module will be used to create the controller;
- Otherwise, it will search under the controllerPath to create the corresponding controller. For example, if the route is "admin/user/create", then the controller will be created using the class file "protected/controllers/admin/UserController.php".
findModule() method
public CWebModule findModule(string $id) | ||
$id | string | module ID |
{return} | CWebModule | the module that has the specified ID. Null if no module is found. |
public function findModule($id)
{
if(($controller=$this->getController())!==null && ($module=$controller->getModule())!==null)
{
do
{
if(($m=$module->getModule($id))!==null)
return $m;
} while(($module=$module->getParentModule())!==null);
}
if(($m=$this->getModule($id))!==null)
return $m;
}
Do not call this method. This method is used internally to search for a module by its ID.
getAssetManager() method
public CAssetManager getAssetManager() | ||
{return} | CAssetManager | the asset manager component |
public function getAssetManager()
{
return $this->getComponent('assetManager');
}
getAuthManager() method
public IAuthManager getAuthManager() | ||
{return} | IAuthManager | the authorization manager component |
public function getAuthManager()
{
return $this->getComponent('authManager');
}
getClientScript() method
public CClientScript getClientScript() | ||
{return} | CClientScript | the client script manager |
public function getClientScript()
{
return $this->getComponent('clientScript');
}
Returns the client script manager.
getController() method
public CController getController() | ||
{return} | CController | the currently active controller |
public function getController()
{
return $this->_controller;
}
getControllerPath() method
public string getControllerPath() | ||
{return} | string | the directory that contains the controller classes. Defaults to 'protected/controllers'. |
public function getControllerPath()
{
if($this->_controllerPath!==null)
return $this->_controllerPath;
else
return $this->_controllerPath=$this->getBasePath().DIRECTORY_SEPARATOR.'controllers';
}
getLayoutPath() method
public string getLayoutPath() | ||
{return} | string | the root directory of layout files. Defaults to 'protected/views/layouts'. |
public function getLayoutPath()
{
if($this->_layoutPath!==null)
return $this->_layoutPath;
else
return $this->_layoutPath=$this->getViewPath().DIRECTORY_SEPARATOR.'layouts';
}
getSession() method
public CHttpSession getSession() | ||
{return} | CHttpSession | the session component |
public function getSession()
{
return $this->getComponent('session');
}
getSystemViewPath() method
public string getSystemViewPath() | ||
{return} | string | the root directory of system view files. Defaults to 'protected/views/system'. |
public function getSystemViewPath()
{
if($this->_systemViewPath!==null)
return $this->_systemViewPath;
else
return $this->_systemViewPath=$this->getViewPath().DIRECTORY_SEPARATOR.'system';
}
getTheme() method
public CTheme getTheme() | ||
{return} | CTheme | the theme used currently. Null if no theme is being used. |
public function getTheme()
{
if(is_string($this->_theme))
$this->_theme=$this->getThemeManager()->getTheme($this->_theme);
return $this->_theme;
}
getThemeManager() method
public CThemeManager getThemeManager() | ||
{return} | CThemeManager | the theme manager. |
public function getThemeManager()
{
return $this->getComponent('themeManager');
}
getUser() method
public CWebUser getUser() | ||
{return} | CWebUser | the user session information |
public function getUser()
{
return $this->getComponent('user');
}
getViewPath() method
public string getViewPath() | ||
{return} | string | the root directory of view files. Defaults to 'protected/views'. |
public function getViewPath()
{
if($this->_viewPath!==null)
return $this->_viewPath;
else
return $this->_viewPath=$this->getBasePath().DIRECTORY_SEPARATOR.'views';
}
getViewRenderer() method
public IViewRenderer getViewRenderer() | ||
{return} | IViewRenderer | the view renderer. |
public function getViewRenderer()
{
return $this->getComponent('viewRenderer');
}
Returns the view renderer. If this component is registered and enabled, the default view rendering logic defined in CBaseController will be replaced by this renderer.
getWidgetFactory() method (available since v1.1)
public IWidgetFactory getWidgetFactory() | ||
{return} | IWidgetFactory | the widget factory |
public function getWidgetFactory()
{
return $this->getComponent('widgetFactory');
}
Returns the widget factory.
init() method
protected void init() |
protected function init()
{
parent::init();
// preload 'request' so that it has chance to respond to onBeginRequest event.
$this->getRequest();
}
Initializes the application. This method overrides the parent implementation by preloading the 'request' component.
parseActionParams() method
protected string parseActionParams(string $pathInfo) | ||
$pathInfo | string | path info |
{return} | string | action ID |
protected function parseActionParams($pathInfo)
{
if(($pos=strpos($pathInfo,'/'))!==false)
{
$manager=$this->getUrlManager();
$manager->parsePathInfo((string)substr($pathInfo,$pos+1));
$actionID=substr($pathInfo,0,$pos);
return $manager->caseSensitive ? $actionID : strtolower($actionID);
}
else
return $pathInfo;
}
Parses a path info into an action ID and GET variables.
processRequest() method
public void processRequest() |
public function processRequest()
{
if(is_array($this->catchAllRequest) && isset($this->catchAllRequest[0]))
{
$route=$this->catchAllRequest[0];
foreach(array_splice($this->catchAllRequest,1) as $name=>$value)
$_GET[$name]=$value;
}
else
$route=$this->getUrlManager()->parseUrl($this->getRequest());
$this->runController($route);
}
Processes the current request. It first resolves the request into controller and action, and then creates the controller to perform the action.
registerCoreComponents() method
protected void registerCoreComponents() |
protected function registerCoreComponents()
{
parent::registerCoreComponents();
$components=array(
'session'=>array(
'class'=>'CHttpSession',
),
'assetManager'=>array(
'class'=>'CAssetManager',
),
'user'=>array(
'class'=>'CWebUser',
),
'themeManager'=>array(
'class'=>'CThemeManager',
),
'authManager'=>array(
'class'=>'CPhpAuthManager',
),
'clientScript'=>array(
'class'=>'CClientScript',
),
'widgetFactory'=>array(
'class'=>'CWidgetFactory',
),
);
$this->setComponents($components);
}
Registers the core application components. This method overrides the parent implementation by registering additional core components.
See Also
runController() method
public void runController(string $route) | ||
$route | string | the route of the current request. See createController for more details. |
public function runController($route)
{
if(($ca=$this->createController($route))!==null)
{
list($controller,$actionID)=$ca;
$oldController=$this->_controller;
$this->_controller=$controller;
$controller->init();
$controller->run($actionID);
$this->_controller=$oldController;
}
else
throw new CHttpException(404,Yii::t('yii','Unable to resolve the request "{route}".',
array('{route}'=>$route===''?$this->defaultController:$route)));
}
Creates the controller and performs the specified action.
setController() method
public void setController(CController $value) | ||
$value | CController | the currently active controller |
public function setController($value)
{
$this->_controller=$value;
}
setControllerPath() method
public void setControllerPath(string $value) | ||
$value | string | the directory that contains the controller classes. |
public function setControllerPath($value)
{
if(($this->_controllerPath=realpath($value))===false || !is_dir($this->_controllerPath))
throw new CException(Yii::t('yii','The controller path "{path}" is not a valid directory.',
array('{path}'=>$value)));
}
setLayoutPath() method
public void setLayoutPath(string $path) | ||
$path | string | the root directory of layout files. |
public function setLayoutPath($path)
{
if(($this->_layoutPath=realpath($path))===false || !is_dir($this->_layoutPath))
throw new CException(Yii::t('yii','The layout path "{path}" is not a valid directory.',
array('{path}'=>$path)));
}
setSystemViewPath() method
public void setSystemViewPath(string $path) | ||
$path | string | the root directory of system view files. |
public function setSystemViewPath($path)
{
if(($this->_systemViewPath=realpath($path))===false || !is_dir($this->_systemViewPath))
throw new CException(Yii::t('yii','The system view path "{path}" is not a valid directory.',
array('{path}'=>$path)));
}
setTheme() method
public void setTheme(string $value) | ||
$value | string | the theme name |
public function setTheme($value)
{
$this->_theme=$value;
}
setViewPath() method
public void setViewPath(string $path) | ||
$path | string | the root directory of view files. |
public function setViewPath($path)
{
if(($this->_viewPath=realpath($path))===false || !is_dir($this->_viewPath))
throw new CException(Yii::t('yii','The view path "{path}" is not a valid directory.',
array('{path}'=>$path)));
}
© 2008–2017 by Yii Software LLC
Licensed under the three clause BSD license.
http://www.yiiframework.com/doc/api/1.1/CWebApplication