Merge pull request #3867 from riverlet/zh-CN-translate-0604

docs/guide-zh-CN/README.md

+Yii 2.0 权威指南
+===============================
+
+本指南依据 [Terms of Yii Documentation](http://www.yiiframework.com/doc/terms/) 发布。
+
+保留所有权利。
+
+2014 (c) Yii Software LLC.
+
+
+简介
+------------
+
+* [关于 Yii](intro-yii.md)
+* [从 1.1 版本升级](intro-upgrade-from-v1.md)
+
+
+入门
+---------------
+
+* [安装 Yii](start-installation.md)
+* [运行应用程序](start-workflow.md)
+* [说一声你好](start-hello.md)
+* [使用表单](start-forms.md)
+* [使用数据库](start-databases.md)
+* [用 Gii 生成代码](start-gii.md)
+* [一路向前](start-looking-head.md)
+
+
+程序结构
+---------------------
+
+* [概览](structure-overview.md)
+* [入口脚本](structure-entry-scripts.md)
+* [应用程序](structure-applications.md)
+* [应用程序组件](structure-application-components.md)
+* [控制器](structure-controllers.md)
+* [模型](structure-models.md)
+* [视图](structure-views.md)
+* **TBD** [过滤器](structure-filters.md)
+* **TBD** [挂件](structure-widgets.md)
+* **TBD** [模块](structure-modules.md)
+* [资源](structure-assets.md)
+* **TBD** [扩展](structure-extensions.md)
+
+
+处理请求
+-----------------
+
+* **TBD** [Bootstrapping](runtime-bootstrapping.md)
+* **TBD** [Routing](runtime-routing.md)
+* **TBD** [Requests](runtime-requests.md)
+* **TBD** [Responses](runtime-responses.md)
+* **TBD** [Sessions and Cookies](runtime-sessions-cookies.md)
+* [URL 解析及生成](runtime-url-handling.md)
+* [处理错误](runtime-handling-errors.md)
+* [日志](runtime-logging.md)
+
+
+关键概念
+------------
+
+* [组件](concept-components.md)
+* [属性](concept-properties.md)
+* [事件](concept-events.md)
+* [行为](concept-behaviors.md)
+* [配置](concept-configurations.md)
+* [别名](concept-aliases.md)
+* [类的自动加载](concept-autoloading.md)
+* [服务定位器](concept-service-locator.md)
+* [依赖注入容器](concept-di-container.md)
+
+
+使用数据库
+----------------------
+
+* [Data Access Objects](db-dao.md) - Connecting to a database, basic queries, transactions and schema manipulation
+* [Query Builder](db-query-builder.md) - Querying the database using a simple abstraction layer
+* [Active Record](db-active-record.md) - The active record ORM, retrieving and manipulating records and defining relations
+* [Migrations](db-migrations.md) - Version control your databases in a team development environment
+* **TBD** [Sphinx](db-sphinx.md)
+* **TBD** [Redis](db-redis.md)
+* **TBD** [MongoDB](db-mongodb.md)
+* **TBD** [ElasticSearch](db-elastic-search.md)
+
+
+获取来自用户的数据
+-----------------------
+
+* [创建表单](input-forms.md)
+* [验证输入](input-validation.md)
+* **TBD** [Uploading Files](input-file-upload.md)
+* **TBD** [Getting Data for Multiple Models](input-multiple-models.md)
+
+
+显示数据
+---------------
+
+* **TBD** [Data Formatting](output-formatting.md)
+* **TBD** [Pagination](output-pagination.md)
+* **TBD** [Sorting](output-sorting.md)
+* [Data Providers](output-data-providers.md)
+* [Data Widgets](output-data-widgets.md)
+* [主题](output-theming.md)
+
+
+安全
+--------
+
+* [验证](security-authentication.md)
+* [授权](security-authorization.md)
+* [使用密码](security-passwords.md)
+* **TBD** [Auth Clients](security-auth-clients.md)
+* **TBD** [Best Practices](security-best-practices.md)
+
+
+缓存
+-------
+
+* [概览](caching-overview.md)
+* [数据缓存](caching-data.md)
+* [片段缓存](caching-fragment.md)
+* [页面缓存](caching-page.md)
+* [HTTP 缓存](caching-http.md)
+
+
+RESTful Web 服务
+--------------------
+
+* [快速入门](rest-quick-start.md)
+* [Resources](rest-resources.md)
+* [Controllers](rest-controllers.md)
+* [Routing](rest-routing.md)
+* [Response Formatting](rest-response-formatting.md)
+* [Authentication](rest-authentication.md)
+* [Rate Limiting](rest-rate-limiting.md)
+* [Versioning](rest-versioning.md)
+* [Error Handling](rest-error-handling.md)
+
+
+开发工具
+-----------------
+
+* [Debug Toolbar and Debugger](tool-debugger.md)
+* [Generating Code using Gii](tool-gii.md)
+* **TBD** [Generating API Documentation](tool-api-doc.md)
+
+
+测试
+-------
+
+* [Overview](test-overview.md)
+* **TBD** [Unit Tests](test-unit.md)
+* **TBD** [Functional Tests](test-functional.md)
+* **TBD** [Acceptance Tests](test-acceptance.md)
+* [Fixtures](test-fixtures.md)
+
+
+扩展 Yii
+-------------
+
+* [创建扩展](extend-creating-extensions.md)
+* [定制核心代码](extend-customizing-core.md)
+* [使用第三方库](extend-using-libs.md)
+* **TBD** [Using Yii in 3rd-Party Systems](extend-embedding-in-others.md)
+* **TBD** [Using Yii 1.1 and 2.0 Together](extend-using-v1-v2.md)
+* [使用 Composer](extend-using-composer.md)
+
+
+专题
+--------------
+
+* [高级应用程序模板](tutorial-advanced-app.md)
+* [从头开始构建应用程序](tutorial-start-from-scratch.md)
+* [控制台命令](tutorial-console.md)
+* [核心验证器](tutorial-core-validators.md)
+* [国际化](tutorial-i18n.md)
+* [发送邮件](tutorial-mailing.md)
+* [性能调节](tutorial-performance-tuning.md)
+* **TBD** [共享的主机环境](tutorial-shared-hosting.md)
+* [模板引擎](tutorial-template-engines.md)
+
+
+挂件（Widgets)
+-------
+
+* GridView: link to demo page
+* ListView: link to demo page
+* DetailView: link to demo page
+* ActiveForm: link to demo page
+* Pjax: link to demo page
+* Menu: link to demo page
+* LinkPager: link to demo page
+* LinkSorter: link to demo page
+* [Bootstrap Widgets](bootstrap-widgets.md)
+* **TBD** [Jquery UI Widgets](jui-widgets.md)
+
+
+助手(Helpers)
+-------
+
+* [概览](helper-overview.md)
+* **TBD** [ArrayHelper](helper-array.md)
+* **TBD** [Html](helper-html.md)
+* **TBD** [Url](helper-url.md)
+* **TBD** [Security](helper-security.md)
+

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

+Yii 是什么
+===========
+
+Yii 是一个高性能的、基于组件的 PHP 框架，用于快速开发现代 Web 应用程序。名字 Yii （读作 `Yee` 或 `[ji:]`） 在汉语中的意
+思是“简单、发展变化”。也可以看作是  **Yes It Is**! 的缩写。
+
+
+Yii 最适合做什么？
+---------------------
+
+Yii 是一个通用的 Web 编程框架，意味着它可以用于开发任意类型的 PHP Web 应用程序。由于它基于组件的架构和精致的缓存支持，它
+特别适用于开发大型的应用程序，例门户，论坛，内容管理系统（CMS），电子商务项目，RESTful Web 服务等等。
+
+
+Yii 和其他框架相比呢？
+-------------------------------------------
+
+- 和其他 PHP 框架类似，Yii 实现了 MVC（Model-View-Controller）设计模式并基于该模式组织代码。
+- Yii 遵循一个哲学——代码要写的简单而又优雅。它永远不会为了要遵循某个设计模式而过度设计代码。
+- Yii 是一个一站式框架，提供了大量经过验证的、入手可用的特性，例如：对关系型和NoSQL数据库都提供了查询构建器
+（query builders）和 ActiveRecord；RESTful API 开发支持；多层缓存支持；还有更多。
+- Yii 非常易于扩展。你可以自定义或替换几乎任何一处核心代码。你也会受益于它一致性的扩展架构，开发可再分发的扩展。
+- 高性能始终是 Yii 的一个主要目标。
+
+Yii 不是一场独角戏，它有一个[强大的开发者团队][]提供支持，也有一个庞大的专家社区，持续不断地对Yii的开发作出贡献。
+Yii 开发者团队始终对 Web 开发最新潮流和其他框架及项目中的优秀实践和特性保持密切的关注，其他地方出现的最相关优秀实践及
+特性会被不定期的整合进核心框架中，并提供简单优雅的接口。
+
+[强大的开发者团队]: http://www.yiiframework.com/about/
+
+Yii 版本
+------------
+
+Yii 当前有两个主要版本：1.1 和 2.0。 1.1 版是一个旧版本，现在处于维护状态。2.0是一个彻底重写的 Yii，采用了最新的技术和协
+议，包括 Composer，PSR，命名空间，trait 等等。 2.0 版本代表了最新一代的框架，是未来几年中的主力开发版本。本指南主要基于
+2.0 版本编写。
+
+
+系统要求和前置条件
+------------------------------
+
+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。
+

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

+安装 Yii
+==============
+
+你可以通过两种方式安装 Yii：使用 [Composer](http://getcomposer.org/) 或下载一个存档文件。推荐使用前者，
+这样只需执行一条简单的命令就可以安装新的 [扩展](structure-extensions.md) 或更新 Yii 了。
+
+> Note: 和 Yii 1 版本不同，以标准方式安装 Yii 2 时会同时下载并安装框架本身和一个应用程序骨架。
+
+
+通过 Composer 安装<a name="installing-via-composer"></a>
+-----------------------
+
+如果还没有安装 Composer，你可以按 [getcomposer.org](https://getcomposer.org/download/) 中的方法安装。
+在 Linux 和 Mac OS X 中，可以运行如下命令安装：
+
+    curl -s http://getcomposer.org/installer | php
+    mv composer.phar /usr/local/bin/composer
+
+在 Windows 中，你需要下载并运行 [Composer-Setup.exe](https://getcomposer.org/Composer-Setup.exe)。
+
+如果遇到了任何问题或者想更深入地学习 Composer，请参考  [Composer 文档](https://getcomposer.org/doc/) 。
+
+Composer 安装后，切换到一个可通过 Web 访问的目录，执行如下命令即可安装 Yii ：
+
+    composer create-project --prefer-dist yiisoft/yii2-app-basic basic
+
+如上命令会将 Yii 安装在一个名为 `basic` 的目录中。
+
+> Tip: 如果你想安装 Yii 的最新开发版本，可以使用如下命令，它添加了一个
+> [stability 选项](https://getcomposer.org/doc/04-schema.md#minimum-stability):
+>
+>     composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic basic
+>
+> 注意，Yii 的开发版不应该用于生产环境中，因为它可能会破坏运行中的代码。.
+
+
+通过归档文件安装 <a name="installing-from-archive-file"></a>
+-------------------------------
+
+通过归档文件安装 Yii 包括两个步骤：
+
+1. 从 [yiiframework.com](http://www.yiiframework.com/download/yii2-basic) 下载归档文件。
+2. 将下载的文件解压缩到 Web 目录中。
+
+
+其他安装方式 <a name="other-installation-options"></a>
+--------------------------
+
+上文介绍了两种安装 Yii 的方法，安装的同时也会创建一个立即可用的 Web 应用程序。对于小的项目或学习，这是一个很好的起点。
+
+但是还可以有其他的安装方式：
+
+* 如果你只想安装核心框架，然后从头开始构建一个应用程序，可以参考
+ [从头开始构建应用程序](tutorial-start-from-scratch.md) 一节的介绍。
+* 如果你要开始一个更复杂的项目，更好的地适用于团队开发环境的，你可以考虑安装
+ [高级应用程序模板](tutorial-advanced-app.md).
+
+
+验证安装 <a name="verifying-installation"></a>
+--------------------------
+
+安装完成后，就可以使用浏览器通过如下 URL 访问刚安装完的 Yii 应用程序了：
+
+```
+http://localhost/basic/web/index.php
+```
+
+这个 URL 假设你将 Yii 安装到了一个位于 Web 服务器文档根目录下的 `basic` 目录中，且该 Web 服务器正运行在你自己的电脑上
+（`localhost`）。你可能需要将其调整为自己的安装环境。
+
+![Yii 安装成功](images/start-app-installed.png)
+
+你应该可以在浏览器中看到如上所示的 "Congratulations!" 页面。如果没有，请检查你安装的 PHP 环境是否符合 Yii 的需求，
+可以通过如下任意一种方式检查是否满足最小需求：
+
+* 通过浏览器访问 URL `http://localhost/basic/requirements.php`
+* 执行如下命令：
+
+  ```
+  cd basic
+  php requirements.php
+  ```
+
+你需要配置好 PHP 安装环境，使其符合 Yii 的最小需求。最重要的是需要有 PHP 5.4 以上版本。如果你的应用程序需要用到数据库，
+那还要安装 [PDO PHP 扩展](http://www.php.net/manual/en/pdo.installation.php) 和相应的数据库驱动
+（例如访问 MySQL 数据库所需的 `pdo_mysql` ）。
+
+
+配置 Web 服务器 <a name="configuring-web-servers"></a>
+-----------------------
+
+> Info: 如果你现在只是要试用 Yii 而不是要将其部署到生产环境中的服务器上，下面的这一节可以跳过。
+
+通过上述方法安装的应用程序在 Windows，Max OS X 或 Linux 中的  [Apache HTTP server](http://httpd.apache.org/)
+或者 [Nginx HTTP server](http://nginx.org/) 上都可以直接运行。
+
+在生产环境的服务器上，你可能会想配置服务器让应用程序可以通过 URL `http://www.example.com/index.php` 访问而不是通过
+`http://www.example.com/basic/web/index.php` 。这种配置需要将 Web 服务器的文档根目录指向 `basic/web` 目录。
+可能你还会想隐藏掉 URL 中的 `index.php` ， [URL Parsing and Generation](runtime-url-handling.md) 一章中有介绍。.
+在这一节中，你将学到如何配置 Apache 或 Nginx 服务器实现这些目标。
+
+> Info: 将 `basic/web` 设置为文档根目录，可以防止终端用户访问 `basic/web` 相邻目录中的私有应用程序代码和敏感数据文件。
+禁止对其他目录的访问是一个切实可行的安全改进。
+
+> Info: 如果你的应用程序将来要运行在共享的主机环境中，没有权限修改它的 Web 服务器配置，你依然可以调整应用程序的结构
+提升安全性。详情请参考 [共享的主机环境](tutorial-shared-hosting.md) 一章。
+
+
+### 推荐使用的 Apache 配置 <a name="recommended-apache-configuration"></a>
+
+在 Apache 的 `httpd.conf` 文件或在一个虚拟主机配置文件中使用如下配置。
+注意，你应该将 `path/to/basic/web` 替换为实际的 `basic/web` 目录。
+
+```
+# Set document root to be "basic/web"
+DocumentRoot "path/to/basic/web"
+
+<Directory "path/to/basic/web">
+    RewriteEngine on
+
+    # If a directory or a file exists, use the request directly
+    RewriteCond %{REQUEST_FILENAME} !-f
+    RewriteCond %{REQUEST_FILENAME} !-d
+    # Otherwise forward the request to index.php
+    RewriteRule . index.php
+
+    # ...other settings...
+</Directory>
+```
+
+
+### 推荐使用的 Nginx 配置 <a name="recommended-nginx-configuration"></a>
+
+为了使用 [Nginx](http://wiki.nginx.org/)，你应该已经将 PHP 安装为  [FPM SAPI](http://php.net/install.fpm) 了。
+使用如下 Nginx 配置，将 `path/to/basic/web` 替换为实际的 `basic/web` 目录， `mysite.local` 替换为实际的主机名以提供服务。
+
+```
+server {
+    charset utf-8;
+    client_max_body_size 128M;
+
+    listen 80; ## listen for ipv4
+    #listen [::]:80 default_server ipv6only=on; ## listen for ipv6
+
+    server_name mysite.local;
+    root        /path/to/basic/web;
+    index       index.php;
+
+    access_log  /path/to/basic/log/access.log main;
+    error_log   /path/to/basic/log/error.log;
+
+    location / {
+        # Redirect everything that isn't a real file to index.php
+        try_files $uri $uri/ /index.php?$args;
+    }
+
+    # uncomment to avoid processing of calls to non-existing static files by Yii
+    #location ~ \.(js|css|png|jpg|gif|swf|ico|pdf|mov|fla|zip|rar)$ {
+    #    try_files $uri =404;
+    #}
+    #error_page 404 /404.html;
+
+    location ~ \.php$ {
+        include fastcgi.conf;
+        fastcgi_pass   127.0.0.1:9000;
+        #fastcgi_pass unix:/var/run/php5-fpm.sock;
+    }
+
+    location ~ /\.(ht|svn|git) {
+        deny all;
+    }
+}
+```
+
+使用该配置时，你还应该在 `php.ini` 文件中设置 `cgi.fix_pathinfo=0` 以避免很多不必要的 `stat()` 系统调用。
+
+还要注意当运行一个 HTTPS 服务器时，需要添加 `fastcgi_param HTTPS on;` 一行，这样 Yii 才能正确地判断连接是否安全。