YII2 請求(request)


                        

請求

一個應用的請求是用 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 參數,POSTPUTPATCH 等等這些提交上來的參數是在請求體中被發送的。 當你通過上面介紹的方法訪問這些參數的時候,request 組件會解析這些參數。 你可以通過配置 yii\web\Request::parsers 屬性來自定義怎樣解析這些參數。

請求方法

你可以通過 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 */ } 

請求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服務中使用的端口。

HTTP頭

你可以通過 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 頭 */ } 

請求組件也提供了支持快速訪問常用頭的方法,包括:

  • yii\web\Request::userAgent:返回 User-Agent 頭。
  • yii\web\Request::contentType:返回 Content-Type 頭的值, Content-Type 是請求體中MIME類型數據。
  • yii\web\Request::acceptableContentTypes:返回用戶可接受的內容MIME類型。 返回的類型是按照他們的質量得分來排序的。得分最高的類型將被最先返回。
  • yii\web\Request::acceptableLanguages:返回用戶可接受的語言。 返回的語言是按照他們的偏好層次來排序的。第一個參數代表最優先的語言。

假如你的應用支持多語言,並且你想在終端用戶最喜歡的語言中顯示頁面, 那么你可以使用語言協商方法 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;


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM