©
本文档使用 PHP中文网手册 发布
一个应用的请求是用 yii\web\Request 对象来表示的,该对象提供了诸如 请求参数(译者注:通常是GET参数或者POST参数)、HTTP头、cookies等信息。 默认情况下,对于一个给定的请求,你可以通过 request
application component 应用组件(yii\web\Request 类的实例) 获得访问相应的请求对象。在本章节,我们将介绍怎样在你的应用中使用这个组件。
要获取请求参数,你可以调用 request
组件的 yii\web\Request::get() 方法和 yii\web\Request::post() 方法。 他们分别返回 $_GET
和$_POST
的值。例如,
$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 接口的时候,你经常需要获取通过PUT, PATCH或者其他的 request methods 请求方法提交上来的参数。你可以通过调用 yii\web\Request::getBodyParam() 方法来获取这些参数。例如,
$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方法。 这里还提供了一整套布尔属性用于检测当前请求是某种类型。 例如,
$request = Yii::$app->request;
if ($request->isAjax) { }
if ($request->isGet) { }
if ($request->isPost) { }
if ($request->isPut) { }
request
组件提供了许多方式来检测当前请求的URL。
假设被请求的URL是 http://example.com/admin/index.php/product?id=100
, 你可以像下面描述的那样获取URL的各个部分:
/admin/index.php/product?id=100
, 此URL不包括host info部分。http://example.com/admin/index.php/product?id=100
, 包含host infode的整个URL。http://example.com
, 只有host info部分。/product
, 这个是入口脚本之后,问号之前(查询字符串)的部分。id=100
,问号之后的部分。/admin
, host info之后, 入口脚本之前的部分。/admin/index.php
, 没有path info和查询字符串部分。example.com
, URL中的host name。你可以通过 yii\web\Request::headers 属性返回的 yii\web\HeaderCollection 获取HTTP头信息。 例如,
// $headers 是一个 yii\web\HeaderCollection 对象$headers = Yii::$app->request->headers;
// 返回 Accept header 值$accept = $headers->get('Accept');
if ($headers->has('User-Agent')) { }
请求组件也提供了支持快速访问常用头的方法,包括:
User-Agent
头。Content-Type
头的值, Content-Type
是请求体中MIME类型数据。假如你的应用支持多语言,并且你想在终端用户最喜欢的语言中显示页面,那么你可以使用语言协商方法 yii\web\Request::getPreferredLanguage()。 这个方法通过 yii\web\Request::acceptableLanguages 在你的应用中所支持的语言列表里进行比较筛选,返回最适合的语言。
提示:你也可以使用 yii\filters\ContentNegotiator 过滤器进行动态确定哪些内容类型和语言应该在响应中使用。 这个过滤器实现了上面介绍的内容协商的属性和方法。
你可以通过 yii\web\Request::userHost 和 yii\web\Request::userIP 分别获取host name和客户机的IP地址, 例如,
$userHost = Yii::$app->request->userHost;
$userIP = Yii::$app->request->userIP;