Merge pull request #5330 from yii2-chinesization/master

docs/guide-zh-CN/README.md

@@ -28,7 +28,7 @@ Yii 2.0 权威指南
 应用结构
 --------
 
-* **已定稿** [结构总览](structure-overview.md)
+* **已定稿** [结构概述](structure-overview.md)
 * **已定稿** [入口脚本](structure-entry-scripts.md)
 * **已定稿** [应用](structure-applications.md)
 * **已定稿** [应用组件](structure-application-components.md)
@@ -44,11 +44,12 @@ Yii 2.0 权威指南
 请求处理
 --------
 
-* **待定中** [引导（Bootstrapping）](runtime-bootstrapping.md)
-* **待定中** [路由（Routing）](runtime-routing.md)
-* **待定中** [请求（Request）](runtime-requests.md)
-* **待定中** [响应（Response）](runtime-responses.md)
-* **待定中** [Sessions（会话）和 Cookies](runtime-sessions-cookies.md)
+* **已定稿** [运行概述](runtime-overview.md)
+* **已定稿** [引导（Bootstrapping）](runtime-bootstrapping.md)
+* **已定稿** [路由（Routing）](runtime-routing.md)
+* **已定稿** [请求（Request）](runtime-requests.md)
+* **已定稿** [响应（Response）](runtime-responses.md)
+* **已定稿** [Sessions（会话）和 Cookies](runtime-sessions-cookies.md)
 * **编撰中** [URL 解析和生成](runtime-url-handling.md)
 * **编撰中** [错误处理](runtime-handling-errors.md)
 * **编撰中** [日志](runtime-logging.md)
@@ -89,7 +90,7 @@ Yii 2.0 权威指南
 显示数据
 --------
 
-* **待定中** [格式化输出数据](output-formatting.md)
+* **待定中** [格式化输出数据](output-formatter.md)
 * **待定中** [分页（Pagination）](output-pagination.md)
 * **待定中** [排序（Sorting）](output-sorting.md)
 * **编撰中** [数据提供器](output-data-providers.md)

docs/guide-zh-CN/intro-upgrade-from-v1.md

@@ -11,7 +11,7 @@
 安装
 ------------
 
-Yii 2.0 完全拥抱 [Composer](https://getcomposer.org/)，它是PHP中的一个依赖管理工具。核心框架以及扩展的安装都通过 Composer 来处理。想要了解更多如何安装 Yii 2.0 请参阅本指南的 [安装 Yii](start-installation.md) 章节。如果你想创建新扩展，或者把你已有的 Yii 1.1 的扩展改写成兼容 2.0 的版本，你可以参考 [创建扩展](extend-creating-extensions.md) 章节。
+Yii 2.0 完全拥抱 [Composer](https://getcomposer.org/)，它是事实上的 PHP 依赖管理工具。核心框架以及扩展的安装都通过 Composer 来处理。想要了解更多如何安装 Yii 2.0 请参阅本指南的 [安装 Yii](start-installation.md) 章节。如果你想创建新扩展，或者把你已有的 Yii 1.1 的扩展改写成兼容 2.0 的版本，你可以参考 [创建扩展](extend-creating-extensions.md) 章节。
 
 
 PHP 需求
@@ -33,17 +33,17 @@ Yii 2.0 需要 PHP 5.4 或更高版本，该版本相对于 Yii 1.1 所需求的
 命名空间
 ---------
 
-Yii 2.0 里最明显的改动就数命名空间的使用了。几乎每一个核心类都引入了命名空间，比如 `yii\web\Request`。1.1 版用于类名前的字母 “C” 已经不再使用。当前的命名规范与目录结构相吻合。例如，`yii\web\Request` 就表明对应的类文件是 Yii 框架文件夹下的 `web/Request.php` 文件。
+Yii 2.0 里最明显的改动就数命名空间的使用了。几乎每一个核心类都引入了命名空间，比如 `yii\web\Request`。1.1 版类名前缀 “C” 已经不再使用。当前的命名方案与目录结构相吻合。例如，`yii\web\Request` 就表明对应的类文件是 Yii 框架文件夹下的 `web/Request.php` 文件。
 
-（有了 Yii 的类自动加载器，你可以直接使用全部核心类而不需要显式包含具体文件。）
+有了 Yii 的类自动加载器，你可以直接使用全部核心类而不需要显式包含具体文件。
 
 
 组件（Component）与对象（Object）
 --------------------
 
-Yii 2.0 把 1.1 里的 `CComponent` 类拆分成了两个类：[[yii\base\Object]] 和 [[yii\base\Component]]。[[yii\base\Object|Object]] 类是一个轻量级的基类，你可以通过 getters 和 setters 来定义 [object 的属性](concept-properties.md)。[[yii\base\Component|Component]] 类继承自 [[yii\base\Object|Object]]，同时进一步支持 [事件](concept-events.md) 和 [行为](concept-behaviors.md)。
+Yii 2.0 把 1.1 中的 `CComponent` 类拆分成了两个类：[[yii\base\Object]] 和 [[yii\base\Component]]。[[yii\base\Object|Object]] 类是一个轻量级的基类，你可以通过 getters 和 setters 来定义[对象的属性](concept-properties.md)。[[yii\base\Component|Component]] 类继承自 [[yii\base\Object|Object]]，同时进一步支持 [事件](concept-events.md) 和 [行为](concept-behaviors.md)。
 
-如果你不需要用到事件或行为，应该考虑使用 [[yii\base\Object|Object]] 类作为基类。这通常是表示基本数据结构的类。
+如果你不需要用到事件或行为，应该考虑使用 [[yii\base\Object|Object]] 类作为基类。这种类通常用来表示基本的数据结构。
 
 
 对象的配置
@@ -65,12 +65,12 @@ class MyClass extends \yii\base\Object
     {
         parent::init();
 
-        // ...配置生效后的初始化过程
+        // ... 配置生效后的初始化过程
     }
 }
 ```
 
-在上面的例子里，构造方法的最后一个参数必须输入一个配置数组，包含一系列用于在方法结尾初始化相关属性的键值对。你可以重写 [[yii\base\Object::init()|init()]] 方法来执行一些需要在配置生效后进行的初始化工作。
+在上面的例子里，构造方法的最后一个参数必须传入一个配置数组，包含一系列用于在方法结尾初始化相关属性的键值对。你可以重写 [[yii\base\Object::init()|init()]] 方法来执行一些需要在配置生效后进行的初始化工作。
 
 你可以通过遵循以下约定俗成的编码习惯，来使用配置数组创建并配置新的对象：
 
@@ -95,11 +95,11 @@ $event = new \yii\base\Event;
 $component->trigger($eventName, $event);
 ```
 
-要给事件附加一个事件句柄（Event Handler 或者叫事件处理器），需要使用 [[yii\base\Component::on()|on()]] 方法：
+要给事件附加一个事件事件处理器，需要使用 [[yii\base\Component::on()|on()]] 方法：
 
 ```php
 $component->on($eventName, $handler);
-// 要解除相关句柄，使用 off 方法：
+// 解除事件处理器，使用 off 方法：
 // $component->off($eventName, $handler);
 ```
 
@@ -174,7 +174,7 @@ public function actionView($id)
 }
 ```
 
-请查看 [控制器（Controller）](structure-controllers.md) 章节了解有关控制器的更多细节。
+请查看[控制器（Controller）](structure-controllers.md)章节了解有关控制器的更多细节。
 
 
 小部件（Widget）
@@ -283,7 +283,7 @@ Yii 2.0 很多常用的静态助手类，包括：
 表单
 -----
 
-Yii 2.0 引进了**表单栏（field）**的概念，用来创建一个基于 [[yii\widgets\ActiveForm]]的表单。一个表单栏是一个由标签、输入框、错误消息（可能还有提示文字）组成的容器，被表示为 [[yii\widgets\ActiveField|ActiveField]] 对象。使用表单栏建立表单的过程比以前更整洁利落：
+Yii 2.0 引进了**表单栏（field）**的概念，用来创建一个基于 [[yii\widgets\ActiveForm]] 的表单。一个表单栏是一个由标签、输入框、错误消息（可能还有提示文字）组成的容器，被表示为一个 [[yii\widgets\ActiveField|ActiveField]] 对象。使用表单栏建立表单的过程比以前更整洁利落：
 
 ```php
 <?php $form = yii\widgets\ActiveForm::begin(); ?>
@@ -327,14 +327,14 @@ Yii 2.0 的[活动记录](db-active-record.md)改动了很多。两个最显而
 1.1 中的 `CDbCriteria` 类在 Yii 2 中被 [[yii\db\ActiveQuery]] 所替代。这个类是继承自 [[yii\db\Query]]，因此也继承了所有查询生成方法。开始拼装一个查询可以调用 [[yii\db\ActiveRecord::find()]] 方法进行：
 
 ```php
-// 检索所有 *活动的* 客户和订单，并以 ID 排序：
+// 检索所有“活动的”客户和订单，并以 ID 排序：
 $customers = Customer::find()
     ->where(['status' => $active])
     ->orderBy('id')
     ->all();
 ```
 
-要声明一个关联关系，只需简单地定义一个 getter 方法来返回一个 [[yii\db\ActiveQuery|ActiveQuery]] 对象。getter 方法定义的属性名（译者注：即 getOrders() 中的 orders）表示关联关系名。如，以下代码声明了一个名为 `orders` 的关系（1.1 中必须在 `relations()` 方法内声明关系）：
+要声明一个关联关系，只需简单地定义一个 getter 方法来返回一个 [[yii\db\ActiveQuery|ActiveQuery]] 对象。getter 方法定义的属性名代表关联表名称。如，以下代码声明了一个名为 `orders` 的关系（1.1 中必须在 `relations()` 方法内声明关系）：
 
 ```php
 class Customer extends \yii\db\ActiveRecord
@@ -360,7 +360,7 @@ $orders = $customer->getOrders()->andWhere('status=1')->all();
 $customers = Customer::find()->asArray()->all();
 ```
 
-另一个改变是你不能再通过公共数据定属性（Attribute）的默认值了。如果你需要这么做的话，可以在你的记录类的 `init` 方法中设置它们。
+另一个改变是你不能再通过公共变量定义属性（Attribute）的默认值了。如果你需要这么做的话，可以在你的记录类的 `init` 方法中设置它们。
 
 ```php
 public function init()
@@ -370,11 +370,41 @@ public function init()
 }
 ```
 
-曾几何时，在 1.1 中重写一个活动记录类的构造方法（Constructor）会导致一些问题。它们不会在 2.0 中出现了。需要注意的是，如果你需要在构造方法中添加一些参数，恐怕必须重写 [[yii\db\ActiveRecord::instantiate()]] 方法。
+曾几何时，在 1.1 中重写一个活动记录类的构造方法会导致一些问题。它们不会在 2.0 中出现了。需要注意的是，如果你需要在构造方法中添加一些参数，恐怕必须重写 [[yii\db\ActiveRecord::instantiate()]] 方法。
 
 活动记录方面还有很多其他的变化与改进，请参考[活动记录](db-active-record.md)章节以了解更多细节。
 
 
+活动记录行为（Active Record Behaviors）
+------------------------------------
+
+在 2.0 中遗弃了活动记录行为基类 `CActiveRecordBehavior`。如果你想创建活动记录行为，需要直接继承 `yii\base\Behavior`。如果行为类中需要表示一些事件，需要像这样覆写 `events()` 方法：
+
+```php
+namespace app\components;
+
+use yii\db\ActiveRecord;
+use yii\base\Behavior;
+
+class MyBehavior extends Behavior
+{
+    // ...
+
+    public function events()
+    {
+        return [
+            ActiveRecord::EVENT_BEFORE_VALIDATE => 'beforeValidate',
+        ];
+    }
+
+    public function beforeValidate($event)
+    {
+        // ...
+    }
+}
+```
+
+
 用户及身份验证接口（IdentityInterface）
 -------------------------------------
 
@@ -401,4 +431,4 @@ Yii 2.0 的 URL 管理跟 1.1 中很像。一个主要的改进是现在的 URL
 同时使用 Yii 1.1 和 2.x
 ----------------------
 
-如果你有一些遗留的 Yii 1.1 代码，需要跟 Yii 2.0 一起使用，可以参考 [1.1 和 2.0 共用](extend-using-v1-v2.md)章节。
+如果你有一些遗留的 Yii 1.1 代码，需要跟 Yii 2.0 一起使用，可以参考 [1.1 和 2.0 共用](tutorial-yii-integration.md)章节。

docs/guide-zh-CN/intro-yii.md

 Yii 是什么
 ===========
 
-Yii 是一个高性能，基于组件的 PHP 框架，用于快速开发现代 Web 应用程序。名字 Yii （读作 `易`）在中文里有 “极致简单与不断演变” 两重含义，也可看作 **Yes It Is**! 的缩写。
+Yii 是一个高性能，基于组件的 PHP 框架，用于快速开发现代 Web 应用程序。名字 Yii （读作 `易`）在中文里有“极致简单与不断演变”两重含义，也可看作 **Yes It Is**! 的缩写。
 
 
 Yii 最适合做什么？
 ---------------------
 
-Yii 是一个通用的 Web 编程框架，即可以用于开发各种基于 PHP 的 Web 应用。因为基于组件的框架结构和设计精巧的缓存支持，Yii 特别适合开发大型应用，如门户网站、论坛、内容管理系统（CMS）、电子商务项目和 RESTful Web 服务等。
+Yii 是一个通用的 Web 编程框架，即可以用于开发各种基于 PHP 的 Web 应用。因为基于组件的框架结构和设计精巧的缓存支持，它特别适合开发大型应用，如门户网站、社区、内容管理系统（CMS）、电子商务项目和 RESTful Web 服务等。
 
 Yii 和其他框架相比呢？
 -------------------------------------------
 
+如果你有其它框架使用经验，那么你会很开心看到 Yii 所做的努力：
+
 - 和其他 PHP 框架类似，Yii 实现了 MVC（Model-View-Controller）设计模式并基于该模式组织代码。
-- Yii 的代码简洁优雅，这是 Yii 的编程哲学。它永远不会为了要迎合某个设计模式而对代码进行过度的设计。
-- Yii 是一个全栈框架，提供了大量久经考验，开箱即用的特性，例如：对关系型和 NoSQL 数据库都提供了查询生成器（QueryBuilders）和 ActiveRecord；RESTful API 的开发支持；多层缓存支持，等等。
+- Yii 的代码简洁优雅，这是它的编程哲学。它永远不会为了严格遵照某种设计模式而对代码进行过度的设计。
+- Yii 是一个全栈框架，提供了大量久经考验，开箱即用的特性：对关系型和 NoSQL 数据库都提供了查询生成器和 ActiveRecord；RESTful API 的开发支持；多层缓存支持，等等。
 - Yii 非常易于扩展。你可以自定义或替换几乎任何一处核心代码。你还会受益于它坚实可靠的扩展架构，使用、再开发或再发布扩展。
 - 高性能始终是 Yii 的首要目标之一。
 
-Yii 不是一场独角戏，它由一个[强大的开发者团队](http://www.yiiframework.com/about/)提供支持，也有一个庞大的专家社区，持续不断地对 Yii 的开发作出贡献。Yii 开发者团队始终对 Web 开发最新潮流和其他框架及项目中的最佳实践和特性保持密切关注，那些有意义的最佳实践及特性会被不定期的整合进核心框架中，并提供简单优雅的接口。
+Yii 不是一场独角戏，它由一个[强大的开发者团队](http://www.yiiframework.com/about/)提供支持，也有一个庞大的专家社区，持续不断地对 Yii 的开发作出贡献。Yii 开发者团队始终对 Web 开发趋势和其他框架及项目中的最佳实践和特性保持密切关注，那些有意义的最佳实践及特性会被不定期的整合进核心框架中，并提供简单优雅的接口。
 
 
 Yii 版本
 ------------
 
-Yii 当前有两个主要版本：1.1 和 2.0。 1.1 版是上代的老版本，现在处于维护状态。2.0 版是一个完全重写的版本，采用了最新的技术和协议，包括依赖包管理器（Composer）、PHP 代码规范（PSR）、命名空间、Traits（特质）等等。 2.0 版代表了最新一代框架，是未来几年中我们的主要开发版本。本指南主要基于 2.0 版编写。
+Yii 当前有两个主要版本：1.1 和 2.0。 1.1 版是上代的老版本，现在处于维护状态。2.0 版是一个完全重写的版本，采用了最新的技术和协议，包括依赖包管理器 Composer、PHP 代码规范 PSR、命名空间、Traits（特质）等等。 2.0 版代表新一代框架，是未来几年中我们的主要开发版本。本指南主要基于 2.0 版编写。
 
 
 系统要求和先决条件
@@ -32,5 +34,5 @@ Yii 当前有两个主要版本：1.1 和 2.0。 1.1 版是上代的老版本，
 
 Yii 2.0 需要 PHP 5.4.0 或以上版本支持。你可以通过运行任何 Yii 发行包中附带的系统要求检查器查看每个具体特性所需的 PHP 配置。
 
-使用 Yii 需要对面向对象编程（OOP）有基本了解，因为 Yii 是一个纯面向对象的框架。Yii 2.0 还使用了 PHP 的最新特性，例如 [命名空间](http://www.php.net/manual/en/language.namespaces.php) 和 [Trait（特质）](http://www.php.net/manual/en/language.oop5.traits.php)。理解这些概念将有助于你更快地掌握 Yii 2.0。
+使用 Yii 需要对面向对象编程（OOP）有基本了解，因为 Yii 是一个纯面向对象的框架。Yii 2.0 还使用了 PHP 的最新特性，例如[命名空间](http://www.php.net/manual/en/language.namespaces.php)和[Trait（特质）](http://www.php.net/manual/en/language.oop5.traits.php)。理解这些概念将有助于你更快地掌握 Yii 2.0。
 

docs/guide-zh-CN/start-databases.md

 使用数据库
 ======================
 
-本章节将介绍如何如何创建一个从数据表 `country` 中获取国家数据并显示出来的页面。为了实现这个目标，你将会配置一个数据库连接，创建一个[活动记录](db-active-record.md)类，并且创建一个[操作](structure-controllers.md)及一个[视图](structure-views.md)。
+本章节将介绍如何如何创建一个从数据表 `country` 中读取国家数据并显示出来的页面。为了实现这个目标，你将会配置一个数据库连接，创建一个[活动记录](db-active-record.md)类，并且创建一个[操作](structure-controllers.md)及一个[视图](structure-views.md)。
 
 贯穿整个章节，你将会学到：
 
@@ -16,7 +16,7 @@
 准备数据库 <a name="preparing-database"></a>
 --------------------
 
-首先创建一个名为 `yii2basic` 的数据库，应用将从这个数据库中获取数据。你可以创建 SQLite，MySQL，PostregSQL，MSSQL 或 Oracle 数据库，Yii 内置多种数据库支持。简单起见后面的内容将以 MySQL 为例做演示。
+首先创建一个名为 `yii2basic` 的数据库，应用将从这个数据库中读取数据。你可以创建 SQLite，MySQL，PostregSQL，MSSQL 或 Oracle 数据库，Yii 内置多种数据库支持。简单起见，后面的内容将以 MySQL 为例做演示。
 
 然后在数据库中创建一个名为 `country` 的表并插入简单的数据。可以执行下面的语句：
 
@@ -39,7 +39,7 @@ INSERT INTO `country` VALUES ('RU','Russia',146934000);
 INSERT INTO `country` VALUES ('US','United States',278357000);
 ```
 
-于是便有了一个名为 `yii2basic` 的数据库，在这个数据库中有一个包含三个字段的数据表 `country`，表中有十行数据。
+此时便有了一个名为 `yii2basic` 的数据库，在这个数据库中有一个包含三个字段的数据表 `country`，表中有十行数据。
 
 配置数据库连接 <a name="configuring-db-connection"></a>
 ---------------------------
@@ -62,7 +62,7 @@ return [
 
 `config/db/php` 是一个典型的基于文件的[配置](concept-configurations.md)工具。这个文件配置了数据库连接 [[yii\db\Connection]] 的创建和初始化参数，应用的 SQL 查询正是基于这个数据库。
 
-上面配置的数据库连接可以在应用中通过 `Yii::$app->db` 访问。
+上面配置的数据库连接可以在应用中通过 `Yii::$app->db` 表达式访问。
 
 > 补充：`config/db.php` 将被包含在应用配置文件 `config/web.php` 中，后者指定了整个[应用](structure-applications.md)如何初始化。请参考[配置](concept-configurations.md)章节了解更多信息。
 
@@ -70,7 +70,7 @@ return [
 创建活动记录 <a name="creating-active-record"></a>
 -------------------------
 
-创建一个继承自[活动记录](db-active-record.md)类的类 `Country`，把它放在 `models/Country.php`，去表示和获取 `country` 表的数据。
+创建一个继承自[活动记录](db-active-record.md)类的类 `Country`，把它放在 `models/Country.php` 文件，去代表和读取 `country` 表的数据。
 
 ```php
 <?php
@@ -86,7 +86,7 @@ class Country extends ActiveRecord
 
 这个 `Country` 类继承自 [[yii\db\ActiveRecord]]。你不用在里面写任何代码。只需要像现在这样，Yii 就能根据类名去猜测对应的数据表名。
 
-> 补充：如果类名和数据表名不能直接对应，可以重写 [[yii\db\ActiveRecord::tableName()|tableName()]] 方法去显式指定相关表名。
+> 补充：如果类名和数据表名不能直接对应，可以覆写 [[yii\db\ActiveRecord::tableName()|tableName()]] 方法去显式指定相关表名。
 
 使用 `Country` 类可以很容易地操作 `country` 表数据，就像这段代码：
 
@@ -107,7 +107,7 @@ $country->name = 'U.S.A.';
 $country->save();
 ```
 
-> 补充：活动记录是面向对象、功能强大的访问和操作数据库数据的方式。你可以在[活动记录](db-active-record.md)章节了解更多信息。除此之外你还可以使用另一种更原生的称做[数据访问对象](db-dao)的方法操作数据库数据。
+> 补充：活动记录是面向对象、功能强大的访问和操作数据库数据的方式。你可以在[活动记录](db-active-record.md)章节了解更多信息。除此之外你还可以使用另一种更原生的被称做[数据访问对象](db-dao)的方法操作数据库数据。
 
 
 创建操作 <a name="creating-action"></a>
@@ -148,7 +148,7 @@ class CountryController extends Controller
 }
 ```
 
-把上面的代码保存在 `controllers/CountryController.php`。
+把上面的代码保存在 `controllers/CountryController.php` 文件中。
 
 `index` 操作调用了活动记录 `Country::find()` 方法，去生成查询语句并从 `country` 表中取回所有数据。为了限定每个请求所返回的国家数量，查询在 [[yii\data\Pagination]] 对象的帮助下进行分页。 `Pagination` 对象的使命主要有两点：
 
@@ -184,7 +184,7 @@ use yii\widgets\LinkPager;
 这个视图包含两部分用以显示国家数据。第一部分遍历国家数据并以无序 HTML 列表渲染出来。第二部分使用 [[yii\widgets\LinkPager]] 去渲染从操作中传来的分页信息。小部件 `LinkPager` 显示一个分页按钮的列表。点击任何一个按钮都会跳转到对应的分页。
 
 
-尝试下 <a name="trying-it-out"></a>
+试运行 <a name="trying-it-out"></a>
 -------------
 
 浏览器访问下面的 URL 看看能否工作：

docs/guide-zh-CN/start-forms.md

 使用表单
 ==================
 
-本章节将介绍如何创建一个从用户那搜集数据的表单页。该页将显示一个包含 name 输入框和 email 输入框的表单。当搜集完这两部分信息后，页面将会显示用户输入的信息。
+本章将介绍如何创建一个从用户那搜集数据的表单页。该页将显示一个包含 name 输入框和 email 输入框的表单。当搜集完这两部分信息后，页面将会显示用户输入的信息。
 
 为了实现这个目标，除了创建一个[操作](structure-controllers.md)和两个[视图](structure-views)外，还需要创建一个[模型](structure-models.md)。
 
@@ -39,11 +39,11 @@ class EntryForm extends Model
 }
 ```
 
-该类继承自 [[yii\base\Model]]，Yii 提供的一个基类，通常用来表示数据。
+该类继承自 [[yii\base\Model]]，Yii 提供的一个基类，通常用来代表表单数据。
 
-> 补充：[[yii\base\Model]] 被用于普通模型类的父类并与数据表**无关**。[[yii\db\ActiveRecord]] 通常是普通模型类的父类但与数据表有关联（译者注：[[yii\db\ActiveRecord]] 类其实也是继承自 [[yii\base\Model]]，增加了数据库处理）。
+> 补充：[[yii\base\Model]] 被用于普通模型类的父类并与数据表**无关**。[[yii\db\ActiveRecord]] 通常是普通模型类的父类但与数据表有关联。
 
-`EntryForm` 类包含 `name` 和 `email` 两个公共成员，用来储存用户输入的数据。它还包含一个名为 `rules()` 的方法，用来返回数据验证规则的集合。上面声明的验证规则表示：
+`EntryForm` 类包含 `name` 和 `email` 两个公共变量，用来储存用户输入的数据。它还包含一个名为 `rules()` 的方法，用来返回数据验证规则的集合。上面声明的验证规则表示：
 
 * `name` 和 `email` 值都是必须的
 * `mail` 的值必须满足 email 地址验证
@@ -67,7 +67,7 @@ if ($model->validate()) {
 创建操作 <a name="creating-action"></a>
 ------------------
 
-下面你得在 `site` 控制器中创建一个 `entry` 操作用于新建的模型。操作的创建和使用已经在[说一声你好](start-hello.md)小节中解释了。
+接下来你需要在 `site` 控制器中创建一个 `entry` 操作用于新建的模型。操作的创建和使用已经在[说一声你好](start-hello.md)小节中解释了。
 
 ```php
 <?php
@@ -104,7 +104,7 @@ class SiteController extends Controller
 
 > 补充：表达式 `Yii::$app` 代表[应用](structure-applications.md)实例，它是一个全局可访问的单例。同时它也是一个[服务定位器](concept-service-locator.md)，能提供 `request`，`response`，`db` 等等特定功能的组件。在上面的代码里就是使用 `request` 组件来访问应用实例收到的 `$_POST` 数据。
 
-用户提交表单后，操作将会渲染一个名为 `entry-confirm` 的视图去确认用户输入的数据。如果没填表单就提交，或数据包含错误（译者：如 email 格式不对），`entry` 视图将会渲染输出，连同表单一起输出的还有验证错误的详细信息。
+用户提交表单后，操作将会渲染一个名为 `entry-confirm` 的视图去确认用户输入的数据。如果没填表单就提交，或数据包含错误，`entry` 视图将会渲染输出，连同表单一起输出的还有验证错误的详细信息。
 
 > 注意：在这个简单例子里我们只是呈现了有效数据的确认页面。实践中你应该考虑使用 [[yii\web\Controller::refresh()|refresh()]] 或 [[yii\web\Controller::redirect()|redirect()]] 去避免[表单重复提交问题](http://en.wikipedia.org/wiki/Post/Redirect/Get)。
 
@@ -148,10 +148,10 @@ use yii\widgets\ActiveForm;
 <?php ActiveForm::end(); ?>
 ```
 
-视图使用了一个功能强大的[小部件](structure-widgets.md) [[yii\widgets\ActiveForm|ActiveForm]] 去生成 HTML 表单。其中的 `begin()` 和 `end()` 分别用来渲染表单的开始和关闭标签。在这两个方法之间使用了 [[yii\widgets\ActiveForm::field()|field()]] 方法去创建输入框。第一个输入框用于 “name”，第二个输入框用于 “email”。之后使用 [[yii\helpers\Html::submitButton()]] 方法生成提交按钮。
+视图使用了一个功能强大的[小部件](structure-widgets.md) [[yii\widgets\ActiveForm|ActiveForm]] 去生成 HTML 表单。其中的 `begin()` 和 `end()` 分别用来渲染表单的开始和关闭标签。在这两个方法之间使用了 [[yii\widgets\ActiveForm::field()|field()]] 方法去创建表单栏。第一个表单栏用于 “name”，第二个表单栏用于 “email”。之后使用 [[yii\helpers\Html::submitButton()]] 方法生成提交按钮。
 
 
-尝试下 <a name="trying-it-out"></a>
+试运行 <a name="trying-it-out"></a>
 -------------
 
 用浏览器访问下面的 URL 看它能否工作：
@@ -160,7 +160,7 @@ use yii\widgets\ActiveForm;
 http://hostname/index.php?r=site/entry
 ```
 
-你会看到一个包含两个输入框的表单的页面。每个输入框的前面都有一个标签指明应该输入的数据类型。如果什么都不填就点击提交按钮，或填入格式不正确的 email 地址，将会看到在对应的输入框下显示错误信息。
+你会看到一个包含两个表单栏的页面。每个表单栏的前面都有一个标签指明应该输入的数据类型。如果什么都不填就点击提交按钮，或填入格式不正确的 email 地址，将会看到在对应的表单栏下显示错误信息。
 
 ![验证错误的表单](images/start-form-validation.png)
 
@@ -172,13 +172,13 @@ http://hostname/index.php?r=site/entry
 
 ### 效果说明 <a name="magic-explained"></a>
 
-你可能会好奇 HTML 表单暗地里是如何工作的呢，看起来它可以为每个输入框显示文字标签，而当你没输入正确的信息时又不需要刷新页面就能给出错误提示，似乎有些神奇。
+你可能会好奇 HTML 表单暗地里是如何工作的，看起来它可以为每个表单栏显示文字标签，而当你没输入正确的信息时又不需要刷新页面就能给出错误提示，似乎有些神奇。
 
 是的，其实数据首先由客户端 JavaScript 脚本验证，然后才会提交给服务器通过 PHP 验证。[[yii\widgets\ActiveForm]] 足够智能到把你在 `EntryForm` 模型中声明的验证规则转化成客户端 JavaScript 脚本去执行验证。如果用户浏览器禁用了 JavaScript， 服务器端仍然会像 `actionEntry()` 方法里这样验证一遍数据。这保证了任何情况下用户提交的数据都是有效的。
 
-> 警告：客户端验证是提高用户体验的手段。无论它是否正常启用，服务端验证则都是必须的，请不要忽略它。
+> 警告：客户端验证只是提高用户体验的手段。无论它是否正常启用，服务端验证则都是必须的，请不要忽略它。
 
-输入框的文字标签是 `field()` 方法生成的，内容就是模型中该数据的属性名。例如模型中的 `name` 属性生成的标签就是 `Name`。
+表单栏的文字标签是 `field()` 方法生成的，内容就是模型中该数据的属性名。例如模型中的 `name` 属性生成的标签就是 `Name`。
 
 你可以在视图中自定义标签：
 
@@ -193,7 +193,7 @@ http://hostname/index.php?r=site/entry
 总结 <a name="summary"></a>
 -------
 
-本章节指南中你接触了 MVC 设计模式的每个部分。学到了如何创建一个模型代表用户数据并验证它的有效性。
+本章指南中你接触了 MVC 设计模式的每个部分。学到了如何创建一个模型代表用户数据并验证它的有效性。
 
 你还学到了如何从用户那获取数据并在浏览器上回显给用户。这本来是开发应用的过程中比较耗时的任务，好在 Yii 提供了强大的小部件让它变得如此简单。
 

docs/guide-zh-CN/start-gii.md

 使用 Gii 生成代码
 ========================
 
-本章节将介绍如何使用 [Gii](tool-gii.md) 去自动生成 Web 站点常用功能的代码。使用 Gii 生成代码非常简单，只要按照 Gii 页面上的介绍输入正确的信息即可。
+本章将介绍如何使用 [Gii](tool-gii.md) 去自动生成 Web 站点常用功能的代码。使用 Gii 生成代码非常简单，只要按照 Gii 页面上的介绍输入正确的信息即可。
 
 贯穿本章节，你将会学到：
 
@@ -25,7 +25,7 @@ if (YII_ENV_DEV) {
 }
 ```
 
-这段配置的意思是如果当前是[开发环境](concept-configurations.md#environment-constants)，应用会包含 `gii` 模块，模块类是 [[yii\gii\Module]]。
+这段配置表明，如果当前是[开发环境](concept-configurations.md#environment-constants)，应用会包含 `gii` 模块，模块类是 [[yii\gii\Module]]。
 
 如果你检查应用的[入口脚本](structure-entry-scripts.md) `web/index.php`，将看到这行代码将 `YII_ENV_DEV` 设为 true：
 
@@ -33,16 +33,18 @@ if (YII_ENV_DEV) {
 defined('YII_ENV') or define('YII_ENV', 'dev');
 ```
 
-代码设置应用处于开发模式下，按照上面的配置会打开 Gii 模块。你可以直接通过 URL 访问 Gii：
+鉴于这行代码的定义，应用处于开发模式下，按照上面的配置会打开 Gii 模块。你可以直接通过 URL 访问 Gii：
 
 ```
 http://hostname/index.php?r=gii
 ```
-> 提示：如果不是通过localhost而是通过IP地址访问Gii，出于安全考虑系统默认禁止，按照如下在配置文件的gii部分添加允许IP地址访问。
+
+> 补充： 如果你通过本机以外的机器访问 Gii，请求会被出于安全原因拒绝。你可以配置 Gii 为其添加允许访问的 IP 地址：
+>
 ```php
 'gii' => [
     'class' => 'yii\gii\Module',
-    'allowedIPs' => ['127.0.0.1', '::1', '192.168.0.*', '192.168.178.20'] // 根据你自己的需要调整
+    'allowedIPs' => ['127.0.0.1', '::1', '192.168.0.*', '192.168.178.20'] // 按需调整这里
 ],
 ```
 
@@ -61,7 +63,7 @@ http://hostname/index.php?r=gii
 
 然后点击 “Preview” 按钮。你会看到 `models/Country.php` 被列在将要生成的文件列表中。可以点击文件名预览内容。
 
-如果你已经创建过同样的文件，使用 Gii 可以覆写它，点击文件名旁边的 `diff` 能查看现有文件与将要生成的文件的内容区别。
+如果你已经创建过同样的文件，使用 Gii 会覆写它，点击文件名旁边的 `diff` 能查看现有文件与将要生成的文件的内容区别。
 
 ![模型生成器预览](images/start-gii-model-preview.png)
 
@@ -73,7 +75,7 @@ http://hostname/index.php?r=gii
 生成 CRUD 代码 <a name="generating-crud"></a>
 --------------------
 
-CRUD 代表增，查，改，删操作，这是绝大多数 Web 站点常用的数据处理方式。选择 Gii 中的 “CRUD Generator” （点击 Gii 首页的链接）去创建 CRUD 功能。之前的 “country” 例子需要像这样填写表单：
+CRUD 代表增，查，改，删操作，这是绝大多数 Web 站点常用的数据处理方式。选择 Gii 中的 “CRUD Generator” （点击 Gii 首页的链接）去创建 CRUD 功能。本例 “country” 中需要这样填写表单：
 
 * Model Class: `app\models\Country`
 * Search Model Class: `app\models\CountrySearch`
@@ -83,12 +85,12 @@ CRUD 代表增，查，改，删操作，这是绝大多数 Web 站点常用的
 
 然后点击 “Preview” 按钮。你会看到下述将要生成的文件列表。
 
-![CRUD 生成器预览](images/start-gii-crud-preview.png)
+[[NEED THE IMAGE HERE / 等待官方补充图片]]
 
-如果你之前创建过 `controllers/CountryController.php` 和 `views/country/index.php` 文件（在指南的使用数据库小节），选中 “overwrite” 下的复选框覆写它们（之前的文件没能全部支持 CRUD）。
+如果你之前创建过 `controllers/CountryController.php` 和 `views/country/index.php` 文件（在指南的使用数据库章节），选中 “overwrite” 下的复选框覆写它们（之前的文件没能全部支持 CRUD）。
 
 
-尝试下<a name="trying-it-out"></a>
+试运行 <a name="trying-it-out"></a>
 -------------
 
 用浏览器访问下面的 URL 查看生成代码的运行：
@@ -97,7 +99,7 @@ CRUD 代表增，查，改，删操作，这是绝大多数 Web 站点常用的
 http://hostname/index.php?r=country/index
 ```
 
-可以看到一个栅格显示着从数据表中获取的国家数据。支持在列头对数据进行排序，输入筛选条件进行筛选。
+可以看到一个栅格显示着从数据表中读取的国家数据。支持在列头对数据进行排序，输入筛选条件进行筛选。
 
 可以浏览详情，编辑，或删除栅格中的每个国家。还可以点击栅格上方的 “Create Country” 按钮通过表单创建新国家。
 
@@ -111,7 +113,7 @@ http://hostname/index.php?r=country/index
 * 模型：`models/Country.php` 和 `models/CountrySearch.php`
 * 视图：`views/country/*.php`
 
-> 补充：Gii 被设计成高度可定制和可扩展的代码生成工具。使用它可以大幅提高应用开发速度。请参考 [Gii](tool-gii.md) 小节了解更多内容。
+> 补充：Gii 被设计成高度可定制和可扩展的代码生成工具。使用它可以大幅提高应用开发速度。请参考 [Gii](tool-gii.md) 章节了解更多内容。
 
 
 总结 <a name="summary"></a>

docs/guide-zh-CN/start-hello.md

 说声 Hello
 ============
 
-本章节描述了如何在你的应用中创建一个新的 “Hello” 页面。为了做到这点，将会创建一个[操作](structure-controllers.md#creating-actions)和一个[视图](structure-views.md)：
+本章描述了如何在你的应用中创建一个新的 “Hello” 页面。为了实现这一目标，将会创建一个[操作](structure-controllers.md#creating-actions)和一个[视图](structure-views.md)：
 
 * 应用将会分派页面请求给操作
 * 操作将会依次渲染视图呈现 “Hello” 给最终用户
@@ -16,7 +16,7 @@
 创建操作 <a name="creating-action"></a>
 ------------------
 
-为了说 “Hello”，需要创建一个 `say` [操作](structure-controllers.md#creating-actions)，从请求中接收 `message` 参数并显示给最终用户。如果请求没有提供 `message` 参数，操作将显示默认参数 “Hello”。
+为了 “Hello”，需要创建一个 `say` [操作](structure-controllers.md#creating-actions)，从请求中接收 `message` 参数并显示给最终用户。如果请求没有提供 `message` 参数，操作将显示默认参数 “Hello”。
 
 > 补充：[操作](structure-controllers.md#creating-actions)是最终用户可以直接访问并执行的对象。操作被组织在[控制器](structure-controllers.md)中。一个操作的执行结果就是最终用户收到的响应内容。
 
@@ -33,7 +33,7 @@ class SiteController extends Controller
 {
     // ...其它代码...
 
-    public function actionSay($message = '你好')
+    public function actionSay($message = 'Hello')
     {
         return $this->render('say', ['message' => $message]);
     }
@@ -68,7 +68,7 @@ use yii\helpers\Html;
 当然了，你大概会在 `say` 视图里放入更多内容。内容可以由 HTML 标签，纯文本，甚至 PHP 语句组成。实际上 `say` 视图就是一个由 [[yii\web\Controller::render()|render()]] 执行的 PHP 脚本。视图脚本输出的内容将会作为响应结果返回给应用。应用将依次输出结果给最终用户。
 
 
-尝试下 <a name="trying-it-out"></a>
+试运行 <a name="trying-it-out"></a>
 -------------
 
 创建完操作和视图后，你就可以通过下面的 URL 访问新页面了：

docs/guide-zh-CN/start-installation.md

@@ -90,9 +90,9 @@ http://localhost/basic/web/index.php
 
 >补充：如果你现在只是要试用 Yii 而不是将其部署到生产环境中，本小节可以跳过。
 
-通过上述方法安装的应用程序在 Windows，Max OS X，Linux 中的 [Apache HTTP 服务器](http://httpd.apache.org/)或 [Nginx HTTP 服务器](http://nginx.org/) 且PHP版本为5.4或更高都可以直接运行。Yii 2.0 也兼容 Facebook 公司的 [HHVM](http://hhvm.com/)，由于 HHVM 和标准 PHP 在边界案例上有些地方略有不同，在使用 HHVM 时需稍作处理。
+通过上述方法安装的应用程序在 Windows，Max OS X，Linux 中的 [Apache HTTP 服务器](http://httpd.apache.org/)或 [Nginx HTTP 服务器](http://nginx.org/)且PHP版本为5.4或更高都可以直接运行。Yii 2.0 也兼容 Facebook 公司的 [HHVM](http://hhvm.com/)，由于 HHVM 和标准 PHP 在边界案例上有些地方略有不同，在使用 HHVM 时需稍作处理。
 
-在生产环境的服务器上，你可能会想配置服务器让应用程序可以通过 URL `http://www.example.com/index.php` 访问而不是 `http://www.example.com/basic/web/index.php`。这种配置需要将 Web 服务器的文档根目录指向 `basic/web` 目录。可能你还会想隐藏掉 URL 中的 `index.php`，具体细节在 [URL 解析和生成](runtime-url-handling.md) 一章中有介绍，你将学到如何配置 Apache 或 Nginx 服务器实现这些目标。
+在生产环境的服务器上，你可能会想配置服务器让应用程序可以通过 URL `http://www.example.com/index.php` 访问而不是 `http://www.example.com/basic/web/index.php`。这种配置需要将 Web 服务器的文档根目录指向 `basic/web` 目录。可能你还会想隐藏掉 URL 中的 `index.php`，具体细节在 [URL 解析和生成](runtime-url-handling.md)一章中有介绍，你将学到如何配置 Apache 或 Nginx 服务器实现这些目标。
 
 >补充：将 `basic/web` 设置为文档根目录，可以防止终端用户访问 `basic/web` 相邻目录中的私有应用代码和敏感数据文件。禁止对其他目录的访问是一个不错的安全改进。
 
@@ -141,7 +141,7 @@ server {
     error_log   /path/to/basic/log/error.log;
 
     location / {
-        # 如果找不到真实存在的文件，把请求重定向给 index.php
+        # 如果找不到真实存在的文件，把请求分发至 index.php
         try_files $uri $uri/ /index.php?$args;
     }
 

docs/guide-zh-CN/start-looking-ahead.md

 更上一层楼
 =============
 
-通篇阅读完整个“入门”板块，你就完成了一个完整 Yii 应用的创建。在此过程中你学到了如何实现一些常用功能，例如通过 HTML 表单从用户那获取数据，从数据库中获取数据并以分页形式显示。你还学到了如何通过 [Gii](tool-gii.md) 去自动生成代码。使用 Gii 生成代码把 Web 开发中多数繁杂的过程转化为仅仅填写几个表单就行。
+通篇阅读完整个“入门”部分，你就完成了一个完整 Yii 应用的创建。在此过程中你学到了如何实现一些常用功能，例如通过 HTML 表单从用户那获取数据，从数据库中获取数据并以分页形式显示。你还学到了如何通过 [Gii](tool-gii.md) 去自动生成代码。使用 Gii 生成代码把 Web 开发中多数繁杂的过程转化为仅仅填写几个表单就行。
 
-本章节将介绍一些有助于更好使用 Yii 的资源：
+本章将介绍一些有助于更好使用 Yii 的资源：
 
 * 文档
-    - 权威指南：
-      顾名思义，指南详细描述了 Yii 的工作原理并提供了如何使用它的常规引导。这是最重要的 Yii 辅助资料，强烈建议在开始写 Yii 代码之前阅读。
-    - 类参考手册：
-      描述了 Yii 中每个类的用法。在编码过程中这极为有用，能够帮你理清某个特定类，方法，和属性的用法。类参考手册最好在整个框架的语境下去理解。
-    - Wiki 文章：
-      Wiki 文章是 Yii 用户在其自身经验基础上分享出来的。大多数是使用教程或如何使用 Yii 解决特定问题。虽然这些文章质量可能并不如权威指南，但它们往往覆盖了更广泛的话题，并常常提供解决方案，所以它们也很有用。
+    - 权威指南：顾名思义，指南详细描述了 Yii 的工作原理并提供了如何使用它的常规引导。这是最重要的 Yii 辅助资料，强烈建议在开始写 Yii 代码之前阅读。
+    - 类参考手册：描述了 Yii 中每个类的用法。在编码过程中这极为有用，能够帮你理清某个特定类，方法，和属性的用法。类参考手册最好在整个框架的语境下去理解。
+    - Wiki 文章：Wiki 文章是 Yii 用户在其自身经验基础上分享出来的。大多数是使用教程或如何使用 Yii 解决特定问题。虽然这些文章质量可能并不如权威指南，但它们往往覆盖了更广泛的话题，并常常提供解决方案，所以它们也很有用。
     - 书籍
-* [扩展](http://www.yiiframework.com/extensions/):
-  Yii 拥有数以千计用户提供的扩展，这些扩展能非常方便的插入到应用中，使你的应用开发过程更加方便快捷。
+* [扩展](http://www.yiiframework.com/extensions/):Yii 拥有数以千计用户提供的扩展，这些扩展能非常方便的插入到应用中，使你的应用开发过程更加方便快捷。
 * 社区
     - [官方论坛](http://www.yiiframework.com/forum/)
     - [GitHub](https://github.com/yiisoft/yii2)

docs/guide-zh-CN/structure-application-components.md

+应用组件
+======================
+
+应用主体是[服务定位器](concept-service-locator.md)，它部署一组提供各种不同功能的 *应用组件* 来处理请求。
+例如，`urlManager`组件负责处理网页请求路由到对应的控制器。`db`组件提供数据库相关服务等等。
+
+在同一个应用中，每个应用组件都有一个独一无二的 ID 用来区分其他应用组件，你可以通过如下表达式访问应用组件。
+
+```php
+\Yii::$app->componentID
+```
+
+例如，可以使用 `\Yii::$app->db` 来获取到已注册到应用的 [[yii\db\Connection|DB connection]]，
+使用 `\Yii::$app->cache` 来获取到已注册到应用的 [[yii\caching\Cache|primary cache]]。
+
+第一次使用以上表达式时候会创建应用组件实例，后续再访问会返回此实例，无需再次创建。
+
+应用组件可以是任意对象，可以在 [应用主体配置](structure-applications.md#application-configurations)配置 [[yii\base\Application::components]] 属性 .
+例如：
+
+```php
+[
+    'components' => [
+        // 使用类名注册 "cache" 组件
+        'cache' => 'yii\caching\ApcCache',
+
+        // 使用配置数组注册 "db" 组件
+        'db' => [
+            'class' => 'yii\db\Connection',
+            'dsn' => 'mysql:host=localhost;dbname=demo',
+            'username' => 'root',
+            'password' => '',
+        ],
+
+        // 使用函数注册"search" 组件
+        'search' => function () {
+            return new app\components\SolrService;
+        },
+    ],
+]
+```
+
+> 补充：请谨慎注册太多应用组件，应用组件就像全局变量，使用太多可能加大测试和维护的难度。
+  一般情况下可以在需要时再创建本地组件。
+
+
+## 引导启动组件 <a name="bootstrapping-components"></a>
+
+上面提到一个应用组件只会在第一次访问时实例化，如果处理请求过程没有访问的话就不实例化。
+有时你想在每个请求处理过程都实例化某个组件即便它不会被访问，
+可以将该组件ID加入到应用主体的 [[yii\base\Application::bootstrap|bootstrap]] 属性中。
+
+例如, 如下的应用主体配置保证了 `log` 组件一直被加载。
+
+```php
+[
+    'bootstrap' => [
+        // 将 log 组件 ID 加入引导让它始终载入
+        'log',
+    ],
+    'components' => [
+        'log' => [
+            // "log" 组件的配置
+        ],
+    ],
+]
+```
+
+
+## 核心应用组件 <a name="core-application-components"></a>
+
+Yii 定义了一组固定ID和默认配置的 *核心* 组件，例如 [[yii\web\Application::request|request]] 组件
+用来收集用户请求并解析 [路由](runtime-routing.md)；
+[[yii\base\Application::db|db]] 代表一个可以执行数据库操作的数据库连接。
+通过这些组件，Yii应用主体能处理用户请求。
+
+下面是预定义的核心应用组件列表，可以和普通应用组件一样配置和自定义它们。
+当你配置一个核心组件，不指定它的类名的话就会使用Yii默认指定的类。
+
+* [[yii\web\AssetManager|assetManager]]: 管理资源包和资源发布，详情请参考 [管理资源](output-assets.md) 一节。
+* [[yii\db\Connection|db]]: 代表一个可以执行数据库操作的数据库连接，
+  注意配置该组件时必须指定组件类名和其他相关组件属性，如[[yii\db\Connection::dsn]]。
+  详情请参考 [数据访问对象](db-dao.md) 一节。
+* [[yii\base\Application::errorHandler|errorHandler]]: 处理 PHP 错误和异常，
+  详情请参考 [错误处理](tutorial-handling-errors.md) 一节。
+* [[yii\i18n\Formatter|formatter]]: 格式化输出显示给终端用户的数据，例如数字可能要带分隔符，
+  日期使用长格式。详情请参考 [格式化输出数据](output-formatting.md) 一节。
+* [[yii\i18n\I18N|i18n]]: 支持信息翻译和格式化。详情请参考 [国际化](tutorial-i18n.md) 一节。
+* [[yii\log\Dispatcher|log]]: 管理日志对象。详情请参考 [日志](tutorial-logging.md) 一节。
+* [[yii\swiftmailer\Mailer|mail]]: 支持生成邮件结构并发送，详情请参考 [邮件](tutorial-mailing.md) 一节。
+* [[yii\base\Application::response|response]]: 代表发送给用户的响应，
+  详情请参考 [响应](runtime-responses.md) 一节。
+* [[yii\base\Application::request|request]]: 代表从终端用户处接收到的请求，
+  详情请参考 [请求](runtime-requests.md) 一节。
+* [[yii\web\Session|session]]: 代表会话信息，仅在[[yii\web\Application|Web applications]] 网页应用中可用，
+  详情请参考 [Sessions (会话) and Cookies](runtime-sessions-cookies.md) 一节。
+* [[yii\web\UrlManager|urlManager]]: 支持URL地址解析和创建，
+  详情请参考 [URL 解析和生成](runtime-url-handling.md) 一节。
+* [[yii\web\User|user]]: 代表认证登录用户信息，仅在[[yii\web\Application|Web applications]] 网页应用中可用，
+  详情请参考 [认证](security-authentication.md) 一节。
+* [[yii\web\View|view]]: 支持渲染视图，详情请参考 [Views](structure-views.md) 一节。

docs/guide-zh-CN/structure-entry-scripts.md

+入口脚本
+=============
+
+入口脚本是应用启动流程中的第一环，一个应用（不管是网页应用还是控制台应用）只有一个入口脚本。终端用户的请求通过入口脚本实例化应用并将将请求转发到应用。
+
+Web 应用的入口脚本必须放在终端用户能够访问的目录下，通常命名为 `index.php`，也可以使用 Web 服务器能定位到的其他名称。
+
+控制台应用的入口脚本一般在应用根目录下命名为 `yii`（后缀为.php），该文件需要有执行权限，这样用户就能通过命令 `./yii <route> [arguments] [options]` 来运行控制台应用。
+
+入口脚本主要完成以下工作：
+
+* 定义全局常量；
+* 注册 [Composer 自动加载器](http://getcomposer.org/doc/01-basic-usage.md#autoloading)；
+* 包含 [[Yii]] 类文件；
+* 加载应用配置；
+* 创建一个[应用](structure-applications.md)实例并配置;
+* 调用 [[yii\base\Application::run()]] 来处理请求。
+
+
+## Web 应用 <a name="web-applications"></a>
+
+以下是[基础应用模版](start-installation.md)入口脚本的代码：
+
+```php
+<?php
+
+defined('YII_DEBUG') or define('YII_DEBUG', true);
+defined('YII_ENV') or define('YII_ENV', 'dev');
+
+// 注册 Composer 自动加载器
+require(__DIR__ . '/../vendor/autoload.php');
+
+// 包含 Yii 类文件
+require(__DIR__ . '/../vendor/yiisoft/yii2/Yii.php');
+
+// 加载应用配置
+$config = require(__DIR__ . '/../config/web.php');
+
+// 创建、配置、运行一个应用
+(new yii\web\Application($config))->run();
+```
+
+
+## 控制台应用 <a name="console-applications"></a>
+
+以下是一个控制台应用的入口脚本：
+
+```php
+#!/usr/bin/env php
+<?php
+/**
+ * Yii console bootstrap file.
+ *
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+defined('YII_DEBUG') or define('YII_DEBUG', true);
+
+// fcgi 默认没有定义 STDIN 和 STDOUT
+defined('STDIN') or define('STDIN', fopen('php://stdin', 'r'));
+defined('STDOUT') or define('STDOUT', fopen('php://stdout', 'w'));
+
+// 注册 Composer 自动加载器
+require(__DIR__ . '/vendor/autoload.php');
+
+// 包含 Yii 类文件
+require(__DIR__ . '/vendor/yiisoft/yii2/Yii.php');
+
+// 加载应用配置
+$config = require(__DIR__ . '/config/console.php');
+
+$application = new yii\console\Application($config);
+$exitCode = $application->run();
+exit($exitCode);
+```
+
+
+## 定义常量 <a name="defining-constants"></a>
+
+入口脚本是定义全局常量的最好地方，Yii 支持以下三个常量：
+
+* `YII_DEBUG`：标识应用是否运行在调试模式。当在调试模式下，应用会保留更多日志信息，如果抛出异常，会显示详细的错误调用堆栈。因此，调试模式主要适合在开发阶段使用，`YII_DEBUG` 默认值为 false。
+* `YII_ENV`：标识应用运行的环境，详情请查阅[配置](concept-configurations.md#environment-constants)章节。`YII_ENV` 默认值为 `'prod'`，表示应用运行在线上产品环境。
+* `YII_ENABLE_ERROR_HANDLER`：标识是否启用 Yii 提供的错误处理，默认为 true。
+
+当定义一个常量时，通常使用类似如下代码来定义：
+
+```php
+defined('YII_DEBUG') or define('YII_DEBUG', true);
+```
+
+上面的代码等同于:
+
+```php
+if (!defined('YII_DEBUG')) {
+    define('YII_DEBUG', true);
+}
+```
+
+显然第一段代码更加简洁易懂。
+
+常量定义应该在入口脚本的开头，这样包含其他 PHP 文件时，常量就能生效。
\ No newline at end of file

docs/guide-zh-CN/structure-overview.md

+总览
+========
+
+Yii 应用参照[模型-视图-控制器 （MVC）](http://wikipedia.org/wiki/Model-view-controller)
+ 设计模式来组织。 [模型](structure-models.md)代表数据、业务逻辑和规则；[视图](structure-views.md)展示模型的输出；[控制器](structure-controllers.md)接受出入并将其转换为[模型](structure-models.md)和[视图](structure-views.md)命令。
+
+除了 MVC, Yii 应用还有以下部分：
+
+* [入口脚本](structure-entry-scripts.md)：终端用户能直接访问的 PHP 脚本，负责启动一个请求处理周期。
+* [应用](structure-applications.md)：能全局范围内访问的对象，管理协调组件来完成请求.
+* [应用组件](structure-application-components.md)：在应用中注册的对象，提供不同的功能来完成请求。
+* [模块](structure-modules.md)：包含完整 MVC 结构的独立包，一个应用可以由多个模块组建。 
+* [过滤器](structure-filters.md)：控制器在处理请求之前或之后需要触发执行的代码。
+* [小部件](structure-widgets.md)：可嵌入到[视图](structure-views.md)中的对象，可包含控制器逻辑，可被不同视图重复调用。
+
+下面的示意图展示了 Yii 应用的静态结构：
+
+![Yii应用静态结构](images/application-structure.png)