From 6c4f29c3b4fa794195203daff90c2a58bc74a77e Mon Sep 17 00:00:00 2001
From: zhoujiafei <564751169@qq.com>
Date: Tue, 11 Aug 2015 11:12:30 +0800
Subject: [PATCH 1/2] Add runtime-requests.md DOC
---
docs/guide-zh-CN/runtime-requests.md | 139 +++++++++++++++++++++++++++++++++++
1 file changed, 139 insertions(+)
create mode 100644 docs/guide-zh-CN/runtime-requests.md
diff --git a/docs/guide-zh-CN/runtime-requests.md b/docs/guide-zh-CN/runtime-requests.md
new file mode 100644
index 0000000..7061697
--- /dev/null
+++ b/docs/guide-zh-CN/runtime-requests.md
@@ -0,0 +1,139 @@
+请求
+========
+
+请求利用 [[yii\web\Request]] 对象使得一个应用能够被展现,这个对象提供了诸如请求参数的一些信息,HTTP头,cookies,等等。
+默认情况下,对于一个给定的请求,你可以通过 `request` [application component](structure-application-components.md) 应用组件([[yii\web\Request]] 实例)
+获得访问相应的请求对象。在这部分,我们将介绍怎样在你的应用中使用这个组件。
+
+
+
+## 请求参数
+
+为了获取请求参数,你可以调用 `request` 组件的 [[yii\web\Request::get()|get()]] 和 [[yii\web\Request::post()|post()]] 方法。
+他们分别返回 `$_GET` 和 `$_POST` 的值。例如,
+
+```php
+$request = Yii::$app->request;
+
+$get = $request->get();
+// 等价于: $get = $_GET;
+
+$id = $request->get('id');
+// 等价于: $id = isset($_GET['id']) ? $_GET['id'] : null;
+
+$id = $request->get('id', 1);
+// 等价于: $id = isset($_GET['id']) ? $_GET['id'] : 1;
+
+$post = $request->post();
+// 等价于: $post = $_POST;
+
+$name = $request->post('name');
+// 等价于: $name = isset($_POST['name']) ? $_POST['name'] : null;
+
+$name = $request->post('name', '');
+// 等价于: $name = isset($_POST['name']) ? $_POST['name'] : '';
+```
+
+> 信息:我们建议您像上面那样通过 `request` 组件来获取请求参数,而非直接访问 `$_GET` 和 `$_POST`。
+ 这对于编写测试用例来说更加地容易,因为你可以通过伪造一个请求数据来创建一个模拟请求组件。
+
+
+当实现了 [RESTful APIs](rest-quick-start.md) APIs的时候,你经常需要获取一些通过PUT, PATCH或者其他的 [request methods](#request-methods)
+请求方法提交上来的参数。你可以通过调用 [[yii\web\Request::getBodyParam()]] 方法来获取这些参数。例如,
+
+
+```php
+$request = Yii::$app->request;
+
+// 返回所有参数
+$params = $request->bodyParams;
+
+// 返回参数 "id"
+$param = $request->getBodyParam('id');
+```
+
+> 信息:不同于 `GET` 参数,`POST`,`PUT`,`PATCH` 等等这些提交上来的参数是在请求体中被发送的。
+ 当你通过上面介绍的方法访问这些参数的时候,`request` 组件会解析这些参数。
+ 你可以通过配置 [[yii\web\Request::parsers]] 属性来自定义怎样解析这些参数。
+
+
+## 请求方法
+
+你可以通过 `Yii::$app->request->method` 表达式来获取当前请求使用的HTTP方法。
+这里还提供了一整套布尔属性用于检测当前请求是某种类型。
+例如,
+
+```php
+$request = Yii::$app->request;
+
+if ($request->isAjax) { /* 该请求是一个 AJAX 请求 */ }
+if ($request->isGet) { /* 请求方法是 GET */ }
+if ($request->isPost) { /* 请求方法是 POST */ }
+if ($request->isPut) { /* 请求方法是 PUT */ }
+```
+
+## 请求URLs
+
+`request` 组件提供了许多方式来检测当前请求的URL。
+
+假设被请求的URL是 `http://example.com/admin/index.php/product?id=100`,
+你可以像下面描述的那样获取URL的各个部分:
+
+* [[yii\web\Request::url|url]]:返回 `/admin/index.php/product?id=100`, 此URL不包括host info部分。
+* [[yii\web\Request::absoluteUrl|absoluteUrl]]:返回 `http://example.com/admin/index.php/product?id=100`,
+ 整个URL包含host info部分。
+* [[yii\web\Request::hostInfo|hostInfo]]:返回 `http://example.com`, 只有host info部分。
+* [[yii\web\Request::pathInfo|pathInfo]]:返回 `/product`, 这个是入口脚本之后,问号之前(查询字符串)的部分。
+* [[yii\web\Request::queryString|queryString]]:返回 `id=100`,问号之后的部分。
+* [[yii\web\Request::baseUrl|baseUrl]]:返回 `/admin`, host info之后,入口脚本之前的部分。
+* [[yii\web\Request::scriptUrl|scriptUrl]]:返回 `/admin/index.php`, 没有path info和查询字符串部分。
+* [[yii\web\Request::serverName|serverName]]:返回 `example.com`, URL中的host name。
+* [[yii\web\Request::serverPort|serverPort]]:返回 80, 这是web服务中使用的端口。
+
+
+
+
+## HTTP头
+
+你可以通过 [[yii\web\Request::headers]] 属性返回的 [[yii\web\HeaderCollection|header collection]] 获取HTTP头信息。
+例如,
+
+```php
+// $headers 是一个 yii\web\HeaderCollection 对象
+$headers = Yii::$app->request->headers;
+
+// 返回 Accept header 值
+$accept = $headers->get('Accept');
+
+if ($headers->has('User-Agent')) { /* 这是一个 User-Agent 头 */ }
+```
+
+请求组件也提供了支持快速访问常用头的方法,包括:
+
+* [[yii\web\Request::userAgent|userAgent]]:返回 `User-Agent` 头。
+* [[yii\web\Request::contentType|contentType]]:返回 `Content-Type` 头的值,`Content-Type` 是请求体中MIME类型数据。
+* [[yii\web\Request::acceptableContentTypes|acceptableContentTypes]]:返回用户可接受的内容MIME类型。
+ 返回的类型是按照他们的质量得分来排序的。得分最高的类型将被最先返回。
+* [[yii\web\Request::acceptableLanguages|acceptableLanguages]]:返回用户可接受的语言。
+ 返回的语言是按照他们的偏好层次来排序的。第一个参数代表最优先的语言。
+
+
+假如你的应用支持多语言,并且你想在终端用户最喜欢的语言中展现页面,那么你可以使用语言协商方法 [[yii\web\Request::getPreferredLanguage()]]。
+这个方法通过 [[yii\web\Request::acceptableLanguages|acceptableLanguages]] 在你的应用中所支持的语言列表里进行比较筛选,返回最适合的语言。
+
+
+
+> 提示:你也可以使用 [[yii\filters\ContentNegotiator|ContentNegotiator]] 过滤器进行动态确定哪些内容类型和语言应该在响应中使用。
+ 这个过滤器实现了上面介绍的内容协商的属性和方法。
+
+
+
+## 客户端信息
+
+你可以通过 [[yii\web\Request::userHost|userHost]] 和 [[yii\web\Request::userIP|userIP]] 分别获取host name和客户机的IP地址,
+例如,
+
+```php
+$userHost = Yii::$app->request->userHost;
+$userIP = Yii::$app->request->userIP;
+```
From 65ba00232ed0774861f4a8ca9b2331f815148149 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=80=A7=E6=84=9F=E3=81=AE=E5=86=9C=E6=B0=91?=
<282055808@qq.com>
Date: Tue, 11 Aug 2015 23:49:15 +0800
Subject: [PATCH 2/2] check: runtime-requests.md
---
docs/guide-zh-CN/runtime-requests.md | 38 ++++++++++++++++++------------------
1 file changed, 19 insertions(+), 19 deletions(-)
diff --git a/docs/guide-zh-CN/runtime-requests.md b/docs/guide-zh-CN/runtime-requests.md
index 7061697..bc863b5 100644
--- a/docs/guide-zh-CN/runtime-requests.md
+++ b/docs/guide-zh-CN/runtime-requests.md
@@ -1,15 +1,15 @@
请求
========
-请求利用 [[yii\web\Request]] 对象使得一个应用能够被展现,这个对象提供了诸如请求参数的一些信息,HTTP头,cookies,等等。
-默认情况下,对于一个给定的请求,你可以通过 `request` [application component](structure-application-components.md) 应用组件([[yii\web\Request]] 实例)
-获得访问相应的请求对象。在这部分,我们将介绍怎样在你的应用中使用这个组件。
-
+一个应用的请求是用 [[yii\web\Request]] 对象来表示的,该对象提供了诸如
+请求参数(译者注:通常是GET参数或者POST参数)、HTTP头、cookies等信息。
+默认情况下,对于一个给定的请求,你可以通过 `request` [application component](structure-application-components.md) 应用组件([[yii\web\Request]] 类的实例)
+获得访问相应的请求对象。在本章节,我们将介绍怎样在你的应用中使用这个组件。
## 请求参数
-为了获取请求参数,你可以调用 `request` 组件的 [[yii\web\Request::get()|get()]] 和 [[yii\web\Request::post()|post()]] 方法。
+要获取请求参数,你可以调用 `request` 组件的 [[yii\web\Request::get()|get()]] 方法和 [[yii\web\Request::post()|post()]] 方法。
他们分别返回 `$_GET` 和 `$_POST` 的值。例如,
```php
@@ -34,11 +34,11 @@ $name = $request->post('name', '');
// 等价于: $name = isset($_POST['name']) ? $_POST['name'] : '';
```
-> 信息:我们建议您像上面那样通过 `request` 组件来获取请求参数,而非直接访问 `$_GET` 和 `$_POST`。
- 这对于编写测试用例来说更加地容易,因为你可以通过伪造一个请求数据来创建一个模拟请求组件。
-
+> 信息:建议你像上面那样通过 `request` 组件来获取请求参数,而不是
+直接访问 `$_GET` 和 `$_POST`。
+这使你更容易编写测试用例,因为你可以伪造数据来创建一个模拟请求组件。
-当实现了 [RESTful APIs](rest-quick-start.md) APIs的时候,你经常需要获取一些通过PUT, PATCH或者其他的 [request methods](#request-methods)
+当实现 [RESTful APIs](rest-quick-start.md) 接口的时候,你经常需要获取通过PUT, PATCH或者其他的 [request methods](#request-methods)
请求方法提交上来的参数。你可以通过调用 [[yii\web\Request::getBodyParam()]] 方法来获取这些参数。例如,
@@ -53,8 +53,8 @@ $param = $request->getBodyParam('id');
```
> 信息:不同于 `GET` 参数,`POST`,`PUT`,`PATCH` 等等这些提交上来的参数是在请求体中被发送的。
- 当你通过上面介绍的方法访问这些参数的时候,`request` 组件会解析这些参数。
- 你可以通过配置 [[yii\web\Request::parsers]] 属性来自定义怎样解析这些参数。
+当你通过上面介绍的方法访问这些参数的时候,`request` 组件会解析这些参数。
+你可以通过配置 [[yii\web\Request::parsers]] 属性来自定义怎样解析这些参数。
## 请求方法
@@ -81,18 +81,18 @@ if ($request->isPut) { /* 请求方法是 PUT */ }
* [[yii\web\Request::url|url]]:返回 `/admin/index.php/product?id=100`, 此URL不包括host info部分。
* [[yii\web\Request::absoluteUrl|absoluteUrl]]:返回 `http://example.com/admin/index.php/product?id=100`,
- 整个URL包含host info部分。
+包含host infode的整个URL。
* [[yii\web\Request::hostInfo|hostInfo]]:返回 `http://example.com`, 只有host info部分。
-* [[yii\web\Request::pathInfo|pathInfo]]:返回 `/product`, 这个是入口脚本之后,问号之前(查询字符串)的部分。
+* [[yii\web\Request::pathInfo|pathInfo]]:返回 `/product`,
+ 这个是入口脚本之后,问号之前(查询字符串)的部分。
* [[yii\web\Request::queryString|queryString]]:返回 `id=100`,问号之后的部分。
-* [[yii\web\Request::baseUrl|baseUrl]]:返回 `/admin`, host info之后,入口脚本之前的部分。
+* [[yii\web\Request::baseUrl|baseUrl]]:返回 `/admin`, host info之后,
+入口脚本之前的部分。
* [[yii\web\Request::scriptUrl|scriptUrl]]:返回 `/admin/index.php`, 没有path info和查询字符串部分。
* [[yii\web\Request::serverName|serverName]]:返回 `example.com`, URL中的host name。
* [[yii\web\Request::serverPort|serverPort]]:返回 80, 这是web服务中使用的端口。
-
-
## HTTP头
你可以通过 [[yii\web\Request::headers]] 属性返回的 [[yii\web\HeaderCollection|header collection]] 获取HTTP头信息。
@@ -111,14 +111,14 @@ if ($headers->has('User-Agent')) { /* 这是一个 User-Agent 头 */ }
请求组件也提供了支持快速访问常用头的方法,包括:
* [[yii\web\Request::userAgent|userAgent]]:返回 `User-Agent` 头。
-* [[yii\web\Request::contentType|contentType]]:返回 `Content-Type` 头的值,`Content-Type` 是请求体中MIME类型数据。
+* [[yii\web\Request::contentType|contentType]]:返回 `Content-Type` 头的值,
+ `Content-Type` 是请求体中MIME类型数据。
* [[yii\web\Request::acceptableContentTypes|acceptableContentTypes]]:返回用户可接受的内容MIME类型。
返回的类型是按照他们的质量得分来排序的。得分最高的类型将被最先返回。
* [[yii\web\Request::acceptableLanguages|acceptableLanguages]]:返回用户可接受的语言。
返回的语言是按照他们的偏好层次来排序的。第一个参数代表最优先的语言。
-
-假如你的应用支持多语言,并且你想在终端用户最喜欢的语言中展现页面,那么你可以使用语言协商方法 [[yii\web\Request::getPreferredLanguage()]]。
+假如你的应用支持多语言,并且你想在终端用户最喜欢的语言中显示页面,那么你可以使用语言协商方法 [[yii\web\Request::getPreferredLanguage()]]。
这个方法通过 [[yii\web\Request::acceptableLanguages|acceptableLanguages]] 在你的应用中所支持的语言列表里进行比较筛选,返回最适合的语言。