Error202
/
yii2-bootstrap
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
Browse Source

.

tags/2.0.0-beta
Qiang Xue 13 years ago
parent
2dabbb8cc7
commit
9f7164881f
2 changed files with 77 additions and 258 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Unified View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 332
      framework/base/Application.php
  2. 3
      framework/base/Module.php

332
framework/base/Application.php
Unescape View File

@ -9,6 +9,8 @@
namespace yii\base; namespace yii\base;
use yii\base\Exception;
/** /**
* Application is the base class for all application classes. * Application is the base class for all application classes.
* *
@ -84,18 +86,15 @@ abstract class Application extends Module
/** /**
* @var string the language that the application is written in. This mainly refers to * @var string the language that the application is written in. This mainly refers to
* the language that the messages and view files are in. Defaults to 'en_us' (US English). * the language that the messages and view files are in. Defaults to 'en_us' (US English).
* @see language
*/ */
public $sourceLanguage = 'en_us'; public $sourceLanguage = 'en_us';
private $_id;
private $_basePath;
private $_runtimePath; private $_runtimePath;
private $_extensionPath;
private $_globalState; private $_globalState;
private $_stateChanged; private $_stateChanged;
private $_ended = false; private $_ended = false;
private $_language; private $_language;
private $_homeUrl;
/** /**
* Processes the request. * Processes the request.
@ -113,38 +112,25 @@ abstract class Application extends Module
* which should point to the directory containing all application logic, template and data. * which should point to the directory containing all application logic, template and data.
* If not, the directory will be defaulted to 'protected'. * If not, the directory will be defaulted to 'protected'.
*/ */
public function __construct($config = null) public function __construct($basePath)
{ {
\Yii::$application = $this; \Yii::$application = $this;
$this->setBasePath($basePath);
// set basePath at early as possible to avoid trouble
if (is_string($config)) {
$config = require($config);
}
if (isset($config['basePath'])) {
$this->setBasePath($config['basePath']);
unset($config['basePath']);
} else
{
$this->setBasePath('protected');
}
\Yii::setAlias('application', $this->getBasePath()); \Yii::setAlias('application', $this->getBasePath());
\Yii::setAlias('webroot', dirname($_SERVER['SCRIPT_FILENAME']));
\Yii::setAlias('ext', $this->getBasePath() . DIRECTORY_SEPARATOR . 'extensions');
$this->preinit();
$this->initSystemHandlers(); $this->initSystemHandlers();
$this->registerCoreComponents(); $this->registerCoreComponents();
}
$this->configure($config); /**
$this->attachBehaviors($this->behaviors); * Initializes the module.
* This method is called after the module is created and initialized with property values
* given in configuration.
*/
public function init()
{
$this->preloadComponents(); $this->preloadComponents();
$this->init();
} }
/** /**
* Runs the application. * Runs the application.
* This method loads static application components. Derived classes usually overrides this * This method loads static application components. Derived classes usually overrides this
@ -153,27 +139,23 @@ abstract class Application extends Module
*/ */
public function run() public function run()
{ {
if ($this->hasEventHandlers('beforeRequest')) { $this->beforeRequest();
$this->beforeRequest(new CEvent($this));
}
$this->processRequest(); $this->processRequest();
if ($this->hasEventHandlers('afterRequest')) { $this->afterRequest();
$this->afterRequest(new CEvent($this));
}
} }
/** /**
* Terminates the application. * Terminates the application.
* This method replaces PHP's exit() function by calling * This method replaces PHP's exit() function by calling [[afterRequest()]] before exiting.
* {@link onEndRequest} before exiting.
* @param integer $status exit status (value 0 means normal exit while other values mean abnormal exit). * @param integer $status exit status (value 0 means normal exit while other values mean abnormal exit).
* @param boolean $exit whether to exit the current request. This parameter has been available since version 1.1.5. * @param boolean $exit whether to exit the current request.
* It defaults to true, meaning the PHP's exit() function will be called at the end of this method. * It defaults to true, meaning the PHP's exit() function will be called at the end of this method.
*/ */
public function end($status = 0, $exit = true) public function end($status = 0, $exit = true)
{ {
if ($this->hasEventHandlers('onEndRequest')) { if (!$this->_ended) {
$this->onEndRequest(new CEvent($this)); $this->_ended = true;
$this->afterRequest();
} }
if ($exit) { if ($exit) {
exit($status); exit($status);
@ -181,24 +163,19 @@ abstract class Application extends Module
} }
/** /**
* Raised right BEFORE the application processes the request. * Raises the [[beforeRequest]] event right BEFORE the application processes the request.
* @param Event $event the event parameter
*/ */
public function beforeRequest($event) public function beforeRequest()
{ {
$this->trigger('beforeRequest', $event); $this->trigger('beforeRequest');
} }
/** /**
* Raised right AFTER the application processes the request. * Raises the [[afterRequest]] event right AFTER the application processes the request.
* @param Event $event the event parameter
*/ */
public function afterRequest($event) public function afterRequest()
{ {
if (!$this->_ended) { $this->trigger('afterRequest');
$this->_ended = true;
$this->trigger('afterRequest', $event);
}
} }
/** /**
@ -207,44 +184,11 @@ abstract class Application extends Module
*/ */
public function getId() public function getId()
{ {
if ($this->_id !== null) { if (($id = parent::getId()) === null) {
return $this->_id; $id = sprintf('%x', crc32($this->getBasePath() . $this->name));
} else $this->setId($id);
{
return $this->_id = sprintf('%x', crc32($this->getBasePath() . $this->name));
}
}
/**
* Sets the unique identifier for the application.
* @param string $id the unique identifier for the application.
*/
public function setId($id)
{
$this->_id = $id;
}
/**
* Returns the root path of the application.
* @return string the root directory of the application. Defaults to 'protected'.
*/
public function getBasePath()
{
return $this->_basePath;
}
/**
* Sets the root directory of the application.
* This method can only be invoked at the begin of the constructor.
* @param string $path the root directory of the application.
* @throws CException if the directory does not exist.
*/
public function setBasePath($path)
{
if (($this->_basePath = realpath($path)) === false || !is_dir($this->_basePath)) {
throw new \yii\base\Exception(\Yii::t('yii', 'Application base path "{path}" is not a valid directory.',
array('{path}' => $path)));
} }
return $id;
} }
/** /**
@ -255,8 +199,7 @@ abstract class Application extends Module
{ {
if ($this->_runtimePath !== null) { if ($this->_runtimePath !== null) {
return $this->_runtimePath; return $this->_runtimePath;
} else } else {
{
$this->setRuntimePath($this->getBasePath() . DIRECTORY_SEPARATOR . 'runtime'); $this->setRuntimePath($this->getBasePath() . DIRECTORY_SEPARATOR . 'runtime');
return $this->_runtimePath; return $this->_runtimePath;
} }
@ -265,43 +208,20 @@ abstract class Application extends Module
/** /**
* Sets the directory that stores runtime files. * Sets the directory that stores runtime files.
* @param string $path the directory that stores runtime files. * @param string $path the directory that stores runtime files.
* @throws CException if the directory does not exist or is not writable * @throws Exception if the directory does not exist or is not writable
*/ */
public function setRuntimePath($path) public function setRuntimePath($path)
{ {
if (($runtimePath = realpath($path)) === false || !is_dir($runtimePath) || !is_writable($runtimePath)) { if (!is_dir($path) || !is_writable($path)) {
throw new \yii\base\Exception(\Yii::t('yii', 'Application runtime path "{path}" is not valid. Please make sure it is a directory writable by the Web server process.', throw new \yii\base\Exception("Application runtime path \"$path\" is invalid. Please make sure it is a directory writable by the Web server process.");
array('{path}' => $path)));
} }
$this->_runtimePath = $runtimePath; $this->_runtimePath = $path;
} }
/** /**
* Returns the root directory that holds all third-party extensions. * Returns the language that the end user is using.
* @return string the directory that contains all extensions. Defaults to the 'extensions' directory under 'protected'. * @return string the language that the user is using (e.g. 'en_US', 'zh_CN').
*/ * Defaults to the value of [[sourceLanguage]].
public function getExtensionPath()
{
return \Yii::getPathOfAlias('ext');
}
/**
* Sets the root directory that holds all third-party extensions.
* @param string $path the directory that contains all third-party extensions.
*/
public function setExtensionPath($path)
{
if (($extensionPath = realpath($path)) === false || !is_dir($extensionPath)) {
throw new \yii\base\Exception(\Yii::t('yii', 'Extension path "{path}" does not exist.',
array('{path}' => $path)));
}
\Yii::setAlias('ext', $extensionPath);
}
/**
* Returns the language that the user is using and the application should be targeted to.
* @return string the language that the user is using and the application should be targeted to.
* Defaults to the {@link sourceLanguage source language}.
*/ */
public function getLanguage() public function getLanguage()
{ {
@ -309,13 +229,10 @@ abstract class Application extends Module
} }
/** /**
* Specifies which language the application is targeted to. * Specifies which language the end user is using.
* * This is the language that the application should use to display to end users.
* This is the language that the application displays to end users. * By default, [[language]] and [[sourceLanguage]] are the same.
* If set null, it uses the {@link sourceLanguage source language}. * Do not set this property unless your application needs to support multiple languages.
*
* Unless your application needs to support multiple languages, you should always
* set this language to null to maximize the application's performance.
* @param string $language the user language (e.g. 'en_US', 'zh_CN'). * @param string $language the user language (e.g. 'en_US', 'zh_CN').
* If it is null, the {@link sourceLanguage} will be used. * If it is null, the {@link sourceLanguage} will be used.
*/ */
@ -429,7 +346,7 @@ abstract class Application extends Module
/** /**
* Returns the database connection component. * Returns the database connection component.
* @return CDbConnection the database connection * @return \yii\db\dao\Connection the database connection
*/ */
public function getDb() public function getDb()
{ {
@ -438,7 +355,7 @@ abstract class Application extends Module
/** /**
* Returns the error handler component. * Returns the error handler component.
* @return CErrorHandler the error handler application component. * @return ErrorHandler the error handler application component.
*/ */
public function getErrorHandler() public function getErrorHandler()
{ {
@ -447,7 +364,7 @@ abstract class Application extends Module
/** /**
* Returns the security manager component. * Returns the security manager component.
* @return CSecurityManager the security manager application component. * @return SecurityManager the security manager application component.
*/ */
public function getSecurityManager() public function getSecurityManager()
{ {
@ -465,7 +382,7 @@ abstract class Application extends Module
/** /**
* Returns the cache component. * Returns the cache component.
* @return CCache the cache application component. Null if the component is not enabled. * @return \yii\caching\Cache the cache application component. Null if the component is not enabled.
*/ */
public function getCache() public function getCache()
{ {
@ -474,7 +391,7 @@ abstract class Application extends Module
/** /**
* Returns the core message translations component. * Returns the core message translations component.
* @return CPhpMessageSource the core message translations * @return \yii\i18n\MessageSource the core message translations
*/ */
public function getCoreMessages() public function getCoreMessages()
{ {
@ -483,7 +400,7 @@ abstract class Application extends Module
/** /**
* Returns the application message translations component. * Returns the application message translations component.
* @return CMessageSource the application message translations * @return \yii\i18n\MessageSource the application message translations
*/ */
public function getMessages() public function getMessages()
{ {
@ -492,7 +409,7 @@ abstract class Application extends Module
/** /**
* Returns the request component. * Returns the request component.
* @return CHttpRequest the request component * @return Request the request component
*/ */
public function getRequest() public function getRequest()
{ {
@ -500,93 +417,6 @@ abstract class Application extends Module
} }
/** /**
* Returns the URL manager component.
* @return CUrlManager the URL manager component
*/
public function getUrlManager()
{
return $this->getComponent('urlManager');
}
/**
* @return CController the currently active controller. Null is returned in this base class.
*/
public function getController()
{
return null;
}
/**
* Creates a relative URL based on the given controller and action information.
* @param string $route the URL route. This should be in the format of 'ControllerID/ActionID'.
* @param array $params additional GET parameters (name=>value). Both the name and value will be URL-encoded.
* @param string $ampersand the token separating name-value pairs in the URL.
* @return string the constructed URL
*/
public function createUrl($route, $params = array(), $ampersand = '&')
{
return $this->getUrlManager()->createUrl($route, $params, $ampersand);
}
/**
* Creates an absolute URL based on the given controller and action information.
* @param string $route the URL route. This should be in the format of 'ControllerID/ActionID'.
* @param array $params additional GET parameters (name=>value). Both the name and value will be URL-encoded.
* @param string $schema schema to use (e.g. http, https). If empty, the schema used for the current request will be used.
* @param string $ampersand the token separating name-value pairs in the URL.
* @return string the constructed URL
*/
public function createAbsoluteUrl($route, $params = array(), $schema = '', $ampersand = '&')
{
$url = $this->createUrl($route, $params, $ampersand);
if (strpos($url, 'http') === 0) {
return $url;
} else
{
return $this->getRequest()->getHostInfo($schema) . $url;
}
}
/**
* Returns the relative URL for the application.
* This is a shortcut method to {@link CHttpRequest::getBaseUrl()}.
* @param boolean $absolute whether to return an absolute URL. Defaults to false, meaning returning a relative one.
* This parameter has been available since 1.0.2.
* @return string the relative URL for the application
* @see CHttpRequest::getBaseUrl()
*/
public function getBaseUrl($absolute = false)
{
return $this->getRequest()->getBaseUrl($absolute);
}
/**
* @return string the homepage URL
*/
public function getHomeUrl()
{
if ($this->_homeUrl === null) {
if ($this->getUrlManager()->showScriptName) {
return $this->getRequest()->getScriptUrl();
} else
{
return $this->getRequest()->getBaseUrl() . '/';
}
} else
{
return $this->_homeUrl;
}
}
/**
* @param string $value the homepage URL
*/
public function setHomeUrl($value)
{
$this->_homeUrl = $value;
}
/**
* Returns a global value. * Returns a global value.
* *
* A global value is one that is persistent across users sessions and requests. * A global value is one that is persistent across users sessions and requests.
@ -600,12 +430,7 @@ abstract class Application extends Module
if ($this->_globalState === null) { if ($this->_globalState === null) {
$this->loadGlobalState(); $this->loadGlobalState();
} }
if (isset($this->_globalState[$key])) { return isset($this->_globalState[$key]) ? $this->_globalState[$key] : $defaultValue;
return $this->_globalState[$key];
} else
{
return $defaultValue;
}
} }
/** /**
@ -630,14 +455,13 @@ abstract class Application extends Module
unset($this->_globalState[$key]); unset($this->_globalState[$key]);
$this->_stateChanged = true; $this->_stateChanged = true;
} }
} elseif (!isset($this->_globalState[$key]) || $this->_globalState[$key] !== $value) } elseif (!isset($this->_globalState[$key]) || $this->_globalState[$key] !== $value) {
{
$this->_globalState[$key] = $value; $this->_globalState[$key] = $value;
$this->_stateChanged = true; $this->_stateChanged = true;
} }
if ($this->_stateChanged !== $changed) { if ($this->_stateChanged !== $changed) {
$this->attachEventHandler('onEndRequest', array($this, 'saveGlobalState')); $this->on('afterRequest', array($this, 'saveGlobalState'));
} }
} }
@ -649,7 +473,7 @@ abstract class Application extends Module
*/ */
public function clearGlobalState($key) public function clearGlobalState($key)
{ {
$this->setGlobalState($key, true, true); $this->setGlobalState($key, null);
} }
/** /**
@ -664,19 +488,19 @@ abstract class Application extends Module
$this->_globalState = array(); $this->_globalState = array();
} }
$this->_stateChanged = false; $this->_stateChanged = false;
$this->detachEventHandler('onEndRequest', array($this, 'saveGlobalState')); $this->off('afterRequest', array($this, 'saveGlobalState'));
} }
/** /**
* Saves the global state data into persistent storage. * Saves the global state data into persistent storage.
* @see getStatePersister * @see getStatePersister
* @throws CException if the state persister is not available * @throws \yii\base\Exception if the state persister is not available
*/ */
public function saveGlobalState() public function saveGlobalState()
{ {
if ($this->_stateChanged) { if ($this->_stateChanged) {
$this->_stateChanged = false; $this->_stateChanged = false;
$this->detachEventHandler('onEndRequest', array($this, 'saveGlobalState')); $this->off('afterRequest', array($this, 'saveGlobalState'));
$this->getStatePersister()->save($this->_globalState); $this->getStatePersister()->save($this->_globalState);
} }
} }
@ -954,41 +778,35 @@ abstract class Application extends Module
* Registers the core application components. * Registers the core application components.
* @see setComponents * @see setComponents
*/ */
protected function registerCoreComponents() public function registerCoreComponents()
{ {
$components = array( $this->setComponents(array(
'errorHandler' => array(
'class' => 'yii\base\ErrorHandler',
),
'request' => array(
'class' => 'yii\base\Request',
),
'response' => array(
'class' => 'yii\base\Request',
),
'format' => array(
'class' => 'yii\base\Formatter',
),
'coreMessages' => array( 'coreMessages' => array(
'class' => 'CPhpMessageSource', 'class' => 'yii\i18n\PhpMessageSource',
'language' => 'en_us', 'language' => 'en_us',
'basePath' => YII_PATH . DIRECTORY_SEPARATOR . 'messages', 'basePath' => YII_PATH . DIRECTORY_SEPARATOR . 'messages',
), ),
'db' => array(
'class' => 'CDbConnection',
),
'messages' => array( 'messages' => array(
'class' => 'CPhpMessageSource', 'class' => 'yii\i18n\PhpMessageSource',
), ),
// TODO: uncomment when error handler is properly implemented
// 'errorHandler' => array(
// 'class' => 'CErrorHandler',
// ),
'securityManager' => array( 'securityManager' => array(
'class' => 'CSecurityManager', 'class' => 'yii\base\SecurityManager',
), ),
'statePersister' => array( 'statePersister' => array(
'class' => 'CStatePersister', 'class' => 'yii\base\StatePersister',
),
'urlManager' => array(
'class' => 'CUrlManager',
),
'request' => array(
'class' => 'CHttpRequest',
), ),
'format' => array( ));
'class' => 'CFormatter',
),
);
$this->setComponents($components);
} }
} }

3
framework/base/Module.php
Unescape View File

@ -88,7 +88,8 @@ abstract class Module extends Component implements Initable
/** /**
* Initializes the module. * Initializes the module.
* This method is called after the module is created and initialized with property values * This method is called after the module is created and initialized with property values
* given in configuration. * given in configuration. The default implement will create a path alias using the module [[id]]
* and then call [[preloadComponents()]] to load components that are declared in [[preload]].
*/ */
public function init() public function init()
{ {

Write Preview
Loading…
Cancel
Save