diff --git a/framework/base/Application.php b/framework/base/Application.php index f9d65ea..9b1b331 100644 --- a/framework/base/Application.php +++ b/framework/base/Application.php @@ -38,9 +38,9 @@ namespace yii\base; *
  • load application configuration;
  • *
  • set up class autoloader and error handling;
  • *
  • load static application components;
  • - *
  • {@link onBeginRequest}: preprocess the user request;
  • + *
  • {@link beforeRequest}: preprocess the user request; `beforeRequest` event raised.
  • *
  • {@link processRequest}: process the user request;
  • - *
  • {@link onEndRequest}: postprocess the user request;
  • + *
  • {@link afterRequest}: postprocess the user request; `afterRequest` event raised.
  • * * * Starting from lifecycle 3, if a PHP error or an uncaught exception occurs, @@ -153,12 +153,12 @@ abstract class Application extends Module */ public function run() { - if ($this->hasEventHandlers('onBeginRequest')) { - $this->onBeginRequest(new CEvent($this)); + if ($this->hasEventHandlers('beforeRequest')) { + $this->beforeRequest(new CEvent($this)); } $this->processRequest(); - if ($this->hasEventHandlers('onEndRequest')) { - $this->onEndRequest(new CEvent($this)); + if ($this->hasEventHandlers('afterRequest')) { + $this->afterRequest(new CEvent($this)); } } @@ -182,22 +182,22 @@ abstract class Application extends Module /** * Raised right BEFORE the application processes the request. - * @param CEvent $event the event parameter + * @param Event $event the event parameter */ - public function onBeginRequest($event) + public function beforeRequest($event) { - $this->raiseEvent('onBeginRequest', $event); + $this->trigger('beforeRequest', $event); } /** * Raised right AFTER the application processes the request. - * @param CEvent $event the event parameter + * @param Event $event the event parameter */ - public function onEndRequest($event) + public function afterRequest($event) { if (!$this->_ended) { $this->_ended = true; - $this->raiseEvent('onEndRequest', $event); + $this->trigger('afterRequest', $event); } } @@ -687,7 +687,7 @@ abstract class Application extends Module * This method is implemented as a PHP exception handler. It requires * that constant YII_ENABLE_EXCEPTION_HANDLER be defined true. * - * This method will first raise an {@link onException} event. + * This method will first raise an `exception` event. * If the exception is not handled by any event handler, it will call * {@link getErrorHandler errorHandler} to process the exception. * @@ -757,7 +757,7 @@ abstract class Application extends Module * This method is implemented as a PHP error handler. It requires * that constant YII_ENABLE_ERROR_HANDLER be defined true. * - * This method will first raise an {@link onError} event. + * This method will first raise an `error` event. * If the error is not handled by any event handler, it will call * {@link getErrorHandler errorHandler} to process the error. * @@ -844,31 +844,31 @@ abstract class Application extends Module /** * Raised when an uncaught PHP exception occurs. * - * An event handler can set the {@link CExceptionEvent::handled handled} + * An event handler can set the {@link ExceptionEvent::handled handled} * property of the event parameter to be true to indicate no further error * handling is needed. Otherwise, the {@link getErrorHandler errorHandler} * application component will continue processing the error. * - * @param CExceptionEvent $event event parameter + * @param ExceptionEvent $event event parameter */ public function onException($event) { - $this->raiseEvent('onException', $event); + $this->trigger('exception', $event); } /** * Raised when a PHP execution error occurs. * - * An event handler can set the {@link CErrorEvent::handled handled} + * An event handler can set the {@link ErrorEvent::handled handled} * property of the event parameter to be true to indicate no further error * handling is needed. Otherwise, the {@link getErrorHandler errorHandler} * application component will continue processing the error. * - * @param CErrorEvent $event event parameter + * @param ErrorEvent $event event parameter */ public function onError($event) { - $this->raiseEvent('onError', $event); + $this->trigger('error', $event); } /** diff --git a/framework/db/ar/ActiveRecord.php b/framework/db/ar/ActiveRecord.php index bf7b21c..d6d504e 100644 --- a/framework/db/ar/ActiveRecord.php +++ b/framework/db/ar/ActiveRecord.php @@ -26,18 +26,19 @@ use yii\util\Text; * @author Qiang Xue * @since 2.0 * - * @property array $attributes + * @property array $attributes attribute values indexed by attribute names * - * Events: - * - beforeInsert. Raised before the record is saved. + * ActiveRecord provides a set of events for further customization: + * + * - `beforeInsert`. Raised before the record is saved. * By setting [[\yii\base\ModelEvent::isValid]] to be false, the normal [[save()]] will be stopped. - * - afterInsert. Raised after the record is saved. - * - beforeUpdate. Raised before the record is saved. + * - `afterInsert`. Raised after the record is saved. + * - `beforeUpdate`. Raised before the record is saved. * By setting [[\yii\base\ModelEvent::isValid]] to be false, the normal [[save()]] will be stopped. - * - afterUpdate. Raised after the record is saved. - * - beforeDelete. Raised before the record is deleted. + * - `afterUpdate`. Raised after the record is saved. + * - `beforeDelete`. Raised before the record is deleted. * By setting [[\yii\base\ModelEvent::isValid]] to be false, the normal [[delete()]] process will be stopped. - * - afterDelete. Raised after the record is deleted. + * - `afterDelete`. Raised after the record is deleted. * */ abstract class ActiveRecord extends Model @@ -832,7 +833,7 @@ abstract class ActiveRecord extends Model /** * This method is invoked before saving a record (after validation, if any). - * The default implementation raises the {@link beforeSave} event. + * The default implementation raises the `beforeSave` event. * You may override this method to do any preparation work for record saving. * Use {@link isNewRecord} to determine whether the saving is * for inserting or updating record. @@ -848,7 +849,7 @@ abstract class ActiveRecord extends Model /** * This method is invoked after saving a record successfully. - * The default implementation raises the {@link afterSave} event. + * The default implementation raises the `afterSave` event. * You may override this method to do postprocessing after record saving. * Make sure you call the parent implementation so that the event is raised properly. */ @@ -859,7 +860,7 @@ abstract class ActiveRecord extends Model /** * This method is invoked before saving a record (after validation, if any). - * The default implementation raises the {@link beforeSave} event. + * The default implementation raises the `beforeSave` event. * You may override this method to do any preparation work for record saving. * Use {@link isNewRecord} to determine whether the saving is * for inserting or updating record. @@ -875,7 +876,7 @@ abstract class ActiveRecord extends Model /** * This method is invoked after saving a record successfully. - * The default implementation raises the {@link afterSave} event. + * The default implementation raises the `afterSave` event. * You may override this method to do postprocessing after record saving. * Make sure you call the parent implementation so that the event is raised properly. */ @@ -886,7 +887,7 @@ abstract class ActiveRecord extends Model /** * This method is invoked before deleting a record. - * The default implementation raises the {@link beforeDelete} event. + * The default implementation raises the `beforeDelete` event. * You may override this method to do any preparation work for record deletion. * Make sure you call the parent implementation so that the event is raised properly. * @return boolean whether the record should be deleted. Defaults to true. @@ -900,7 +901,7 @@ abstract class ActiveRecord extends Model /** * This method is invoked after deleting a record. - * The default implementation raises the {@link afterDelete} event. + * The default implementation raises the `afterDelete` event. * You may override this method to do postprocessing after the record is deleted. * Make sure you call the parent implementation so that the event is raised properly. */ diff --git a/framework/logging/Logger.php b/framework/logging/Logger.php index aec34bc..fc1480f 100644 --- a/framework/logging/Logger.php +++ b/framework/logging/Logger.php @@ -16,6 +16,10 @@ namespace yii\logging; * call [[flush]] to send logged messages to different log targets, such as * file, email, Web. * + * Logger provides a set of events for further customization: + * + * - `flush`. Raised on logs flush. + * * @author Qiang Xue * @since 2.0 */ @@ -164,7 +168,7 @@ class Logger extends \yii\base\Component /** * Removes all recorded messages from the memory. - * This method will raise an {@link onFlush} event. + * This method will raise a `flush` event. * The attached event handlers can process the log messages before they are removed. * @param boolean $export whether to notify log targets to export the filtered messages they have received. */ @@ -175,12 +179,12 @@ class Logger extends \yii\base\Component } /** - * Raises an `onFlush` event. + * Raises a `flush` event. * @param \yii\base\Event $event the event parameter */ public function onFlush($event) { - $this->raiseEvent('onFlush', $event); + $this->trigger('flush', $event); } /**