一、请求(Requests)
请求:
一个应用的请求是用 yii/web/Request 对象来表示的,该对象提供了诸如 请求参数(译者注:通常是GET参数或者POST参数)、HTTP头、cookies等信息。 默认情况下,对于一个给定的请求,你可以通过 request application component 应用组件(yii/web/Request 类的实例) 获得访问相应的请求对象。在本章节,我们将介绍怎样在你的应用中使用这个组件。
1.请求参数
要获取请求参数,你可以调用 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 属性来自定义怎样解析这些参数。
2.请求方法
你可以通过 Yii::$app->request->method 表达式来获取当前请求使用的HTTP方法。 这里还提供了一整套布尔属性用于检测当前请求是某种类型。 例如,
$request = Yii::$app->request;if ($request->isAjax) { /* 该请求是一个 AJAX 请求 */ }if ($request->isGet) { /* 请求方法是 GET */ }if ($request->isPost) { /* 请求方法是 POST */ }if ($request->isPut) { /* 请求方法是 PUT */ }
3.请求URLs
request 组件提供了许多方式来检测当前请求的URL。
假设被请求的URL是 http://example.com/admin/index.php/product?id=100, 你可以像下面描述的那样获取URL的各个部分:
yii/web/Request::url:返回 /admin/index.php/product?id=100, 此URL不包括host info部分。 yii/web/Request::absoluteUrl:返回 http://example.com/admin/index.php/product?id=100, 包含host infode的整个URL。 yii/web/Request::hostInfo:返回 http://example.com, 只有host info部分。 yii/web/Request::pathInfo:返回 /product, 这个是入口脚本之后,问号之前(查询字符串)的部分。 yii/web/Request::queryString:返回 id=100,问号之后的部分。 yii/web/Request::baseUrl:返回 /admin, host info之后, 入口脚本之前的部分。 yii/web/Request::scriptUrl:返回 /admin/index.php, 没有path info和查询字符串部分。 yii/web/Request::serverName:返回 example.com, URL中的host name。 yii/web/Request::serverPort:返回 80, 这是web服务中使用的端口。新闻热点
疑难解答