From 3e09adbe9732363b2d58e9e992d15abba28df4bf Mon Sep 17 00:00:00 2001 From: Qiang Xue Date: Fri, 2 May 2014 13:31:33 -0400 Subject: [PATCH] guide toc udpate [skip ci] --- docs/guide/README.md | 39 +++++++++---------- .../{structure-mvc.md => start-lifecycle.md} | 25 +----------- docs/guide/start-structure.md | 22 +++++++++++ 3 files changed, 43 insertions(+), 43 deletions(-) rename docs/guide/{structure-mvc.md => start-lifecycle.md} (60%) create mode 100644 docs/guide/start-structure.md diff --git a/docs/guide/README.md b/docs/guide/README.md index fa4ad289912..c44da5fa8aa 100644 --- a/docs/guide/README.md +++ b/docs/guide/README.md @@ -20,30 +20,14 @@ Getting Started * [Preparing Your Environment](start-environment.md) * [Creating Your First Yii Application](start-basic.md) -* **TBD** [Application Structure](start-structure.md) -* **TBD** [Request Lifecycle](start-lifecycle.md) +* [Application Structure](start-structure.md) +* [Request Lifecycle](start-lifecycle.md) * **TBD** [Next Steps](start-next-steps.md) -Basic Concepts --------------- - -* [Components](basic-components.md) -* [Properties](basic-properties.md) -* [Events](basic-events.md) -* [Behaviors](basic-behaviors.md) -* [Configurations](basic-configs.md) -* [Class Autoloading](basic-autoloading.md) -* [Aliases](basic-alias.md) -* **TBD** [Extensions](basic-extensions.md) -* [Service Locator](basic-service-locator.md) -* [Dependency Injection Container](basic-di-container.md) - - -Basic Structure ---------------- +Application Structure +--------------------- -* [MVC Overview](structure-mvc.md) * **TBD** [Entry Scripts](structure-entry-scripts.md) * **TBD** [Applications](structure-applications.md) * [Controllers and Actions](structure-controllers.md) @@ -65,6 +49,21 @@ Handling Requests * **TBD** [Filtering](runtime-filtering.md) +Basic Concepts +-------------- + +* [Components](basic-components.md) +* [Properties](basic-properties.md) +* [Events](basic-events.md) +* [Behaviors](basic-behaviors.md) +* [Configurations](basic-configs.md) +* [Class Autoloading](basic-autoloading.md) +* [Aliases](basic-alias.md) +* **TBD** [Extensions](basic-extensions.md) +* [Service Locator](basic-service-locator.md) +* [Dependency Injection Container](basic-di-container.md) + + Working with Databases ---------------------- diff --git a/docs/guide/structure-mvc.md b/docs/guide/start-lifecycle.md similarity index 60% rename from docs/guide/structure-mvc.md rename to docs/guide/start-lifecycle.md index f79808ab1e1..c8361465d9e 100644 --- a/docs/guide/structure-mvc.md +++ b/docs/guide/start-lifecycle.md @@ -1,29 +1,8 @@ -MVC Overview -============ +Request Lifecycle +================= > Note: This chapter is under development. -Yii implements the model-view-controller (MVC) design pattern, which is -widely adopted in Web and other application programming. MVC aims to separate business logic from -user interface considerations, allowing developers to more easily change one component of an application without affecting, or even touching, another. - -In MVC, the *model* represents both the -information (the data) and the business rules to which the data must adhere. The *view* contains elements -of the user interface, such as text, images, and form elements. The *controller* manages -the communication between the model and the view, acting as an agent that handles actions and requests. - -Besides implementing the MVC design pattern, Yii also introduces a *front-controller*, called -*application*. The front-controller encapsulates the *execution context* for the processing of a request. This means that the front-controller collects information about a user request, and -then dispatches it to an appropriate controller for the actual handling of that request. In other words, the front-controller is the primary application manager, handling all requests and delegating action accordingly. - -The following diagram shows the static structure of a Yii application: - -![Static structure of Yii application](images/structure.png) - - -A Typical Workflow ------------------- - The following diagram shows a typical workflow of a Yii application handling a user request: ![Typical workflow of a Yii application](images/flow.png) diff --git a/docs/guide/start-structure.md b/docs/guide/start-structure.md new file mode 100644 index 00000000000..e72864bda10 --- /dev/null +++ b/docs/guide/start-structure.md @@ -0,0 +1,22 @@ +Application Structure +===================== + +> Note: This chapter is under development. + +Yii implements the model-view-controller (MVC) design pattern, which is +widely adopted in Web and other application programming. MVC aims to separate business logic from +user interface considerations, allowing developers to more easily change one component of an application without affecting, or even touching, another. + +In MVC, the *model* represents both the +information (the data) and the business rules to which the data must adhere. The *view* contains elements +of the user interface, such as text, images, and form elements. The *controller* manages +the communication between the model and the view, acting as an agent that handles actions and requests. + +Besides implementing the MVC design pattern, Yii also introduces a *front-controller*, called +*application*. The front-controller encapsulates the *execution context* for the processing of a request. This means that the front-controller collects information about a user request, and +then dispatches it to an appropriate controller for the actual handling of that request. In other words, the front-controller is the primary application manager, handling all requests and delegating action accordingly. + +The following diagram shows the static structure of a Yii application: + +![Static structure of Yii application](images/structure.png) +