請(qǐng)求（Requests）

請(qǐng)求

一個(gè)應(yīng)用的請(qǐng)求是用 yii\web\Request 對(duì)象來(lái)表示的，該對(duì)象提供了諸如 請(qǐng)求參數(shù)（譯者注：通常是GET參數(shù)或者POST參數(shù)）、HTTP頭、cookies等信息。 默認(rèn)情況下，對(duì)于一個(gè)給定的請(qǐng)求，你可以通過(guò)?request?application component?應(yīng)用組件（yii\web\Request 類(lèi)的實(shí)例） 獲得訪問(wèn)相應(yīng)的請(qǐng)求對(duì)象。在本章節(jié)，我們將介紹怎樣在你的應(yīng)用中使用這個(gè)組件。

請(qǐng)求參數(shù)

要獲取請(qǐng)求參數(shù)，你可以調(diào)用?request?組件的 yii\web\Request::get() 方法和 yii\web\Request::post() 方法。 他們分別返回?$_GET?和$_POST?的值。例如，

$request = Yii::$app->request;

$get = $request->get(); 
// 等價(jià)于: $get = $_GET;

$id = $request->get('id');   
// 等價(jià)于: $id = isset($_GET['id']) ? $_GET['id'] : null;

$id = $request->get('id', 1);   
// 等價(jià)于: $id = isset($_GET['id']) ? $_GET['id'] : 1;

$post = $request->post(); 
// 等價(jià)于: $post = $_POST;

$name = $request->post('name');   
// 等價(jià)于: $name = isset($_POST['name']) ? $_POST['name'] : null;

$name = $request->post('name', '');   
// 等價(jià)于: $name = isset($_POST['name']) ? $_POST['name'] : '';

信息：建議你像上面那樣通過(guò)?request?組件來(lái)獲取請(qǐng)求參數(shù)，而不是 直接訪問(wèn)?$_GET?和?$_POST。 這使你更容易編寫(xiě)測(cè)試用例，因?yàn)槟憧梢詡卧鞌?shù)據(jù)來(lái)創(chuàng)建一個(gè)模擬請(qǐng)求組件。

當(dāng)實(shí)現(xiàn)?RESTful APIs?接口的時(shí)候，你經(jīng)常需要獲取通過(guò)PUT， PATCH或者其他的?request methods?請(qǐng)求方法提交上來(lái)的參數(shù)。你可以通過(guò)調(diào)用 yii\web\Request::getBodyParam() 方法來(lái)獲取這些參數(shù)。例如，

$request = Yii::$app->request;

// 返回所有參數(shù)
$params = $request->bodyParams;

// 返回參數(shù) "id"
$param = $request->getBodyParam('id');

信息：不同于?GET?參數(shù)，POST，PUT，PATCH?等等這些提交上來(lái)的參數(shù)是在請(qǐng)求體中被發(fā)送的。 當(dāng)你通過(guò)上面介紹的方法訪問(wèn)這些參數(shù)的時(shí)候，request?組件會(huì)解析這些參數(shù)。 你可以通過(guò)配置 yii\web\Request::parsers 屬性來(lái)自定義怎樣解析這些參數(shù)。

請(qǐng)求方法

你可以通過(guò)?Yii::$app->request->method?表達(dá)式來(lái)獲取當(dāng)前請(qǐng)求使用的HTTP方法。 這里還提供了一整套布爾屬性用于檢測(cè)當(dāng)前請(qǐng)求是某種類(lèi)型。 例如，

$request = Yii::$app->request;

if ($request->isAjax) { /* 該請(qǐng)求是一個(gè) AJAX 請(qǐng)求 */ }
if ($request->isGet)  { /* 請(qǐng)求方法是 GET */ }
if ($request->isPost) { /* 請(qǐng)求方法是 POST */ }
if ($request->isPut)  { /* 請(qǐng)求方法是 PUT */ }

請(qǐng)求URLs

request?組件提供了許多方式來(lái)檢測(cè)當(dāng)前請(qǐng)求的URL。

假設(shè)被請(qǐng)求的URL是?http://example.com/admin/index.php/product?id=100， 你可以像下面描述的那樣獲取URL的各個(gè)部分：

• 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的整個(gè)URL。
• yii\web\Request::hostInfo：返回?http://example.com, 只有host info部分。
• yii\web\Request::pathInfo：返回?/product， 這個(gè)是入口腳本之后，問(wèn)號(hào)之前（查詢(xún)字符串）的部分。
• yii\web\Request::queryString：返回?id=100,問(wèn)號(hào)之后的部分。
• yii\web\Request::baseUrl：返回?/admin, host info之后， 入口腳本之前的部分。
• yii\web\Request::scriptUrl：返回?/admin/index.php, 沒(méi)有path info和查詢(xún)字符串部分。
• yii\web\Request::serverName：返回?example.com, URL中的host name。
• yii\web\Request::serverPort：返回 80, 這是web服務(wù)中使用的端口。

HTTP頭

你可以通過(guò) yii\web\Request::headers 屬性返回的 yii\web\HeaderCollection 獲取HTTP頭信息。 例如，

// $headers 是一個(gè) yii\web\HeaderCollection 對(duì)象
$headers = Yii::$app->request->headers;

// 返回 Accept header 值
$accept = $headers->get('Accept');

if ($headers->has('User-Agent')) { /* 這是一個(gè) User-Agent 頭 */ }

請(qǐng)求組件也提供了支持快速訪問(wèn)常用頭的方法，包括：

• yii\web\Request::userAgent：返回?User-Agent?頭。
• yii\web\Request::contentType：返回?Content-Type?頭的值，?Content-Type?是請(qǐng)求體中MIME類(lèi)型數(shù)據(jù)。
• yii\web\Request::acceptableContentTypes：返回用戶(hù)可接受的內(nèi)容MIME類(lèi)型。 返回的類(lèi)型是按照他們的質(zhì)量得分來(lái)排序的。得分最高的類(lèi)型將被最先返回。
• yii\web\Request::acceptableLanguages：返回用戶(hù)可接受的語(yǔ)言。 返回的語(yǔ)言是按照他們的偏好層次來(lái)排序的。第一個(gè)參數(shù)代表最優(yōu)先的語(yǔ)言。

假如你的應(yīng)用支持多語(yǔ)言，并且你想在終端用戶(hù)最喜歡的語(yǔ)言中顯示頁(yè)面，那么你可以使用語(yǔ)言協(xié)商方法 yii\web\Request::getPreferredLanguage()。 這個(gè)方法通過(guò) yii\web\Request::acceptableLanguages 在你的應(yīng)用中所支持的語(yǔ)言列表里進(jìn)行比較篩選，返回最適合的語(yǔ)言。

提示：你也可以使用 yii\filters\ContentNegotiator 過(guò)濾器進(jìn)行動(dòng)態(tài)確定哪些內(nèi)容類(lèi)型和語(yǔ)言應(yīng)該在響應(yīng)中使用。 這個(gè)過(guò)濾器實(shí)現(xiàn)了上面介紹的內(nèi)容協(xié)商的屬性和方法。

客戶(hù)端信息

你可以通過(guò) yii\web\Request::userHost 和 yii\web\Request::userIP 分別獲取host name和客戶(hù)機(jī)的IP地址， 例如，

$userHost = Yii::$app->request->userHost;
$userIP = Yii::$app->request->userIP;