《PHP編程：解讀PHP的Yii框架中請求與響應的處理流程》要點：
本文介紹了PHP編程：解讀PHP的Yii框架中請求與響應的處理流程，希望對您有用。如果有疑問，可以聯系我們。
相關主題：YII框架
PHP實例一、哀求(Requests)
哀求：
一個應用的哀求是用 yii\web\Request 對象來表示的,該對象提供了諸如 哀求參數(譯者注：通常是GET參數或者POST參數)、HTTP頭、cookies等信息. 默認情況下,對于一個給定的哀求,你可以通過 request application component 應用組件(yii\web\Request 類的實例) 獲得訪問相應的哀求對象.在本章節,我們將介紹怎樣在你的應用中使用這個組件.
PHP實例1.哀求參數
PHP實例要獲取哀求參數,你可以調用 request 組件的 yii\web\Request::get() 方法和 yii\web\Request::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'] : '';
PHP實例信息：建議你像上面那樣通過 request 組件來獲取哀求參數,而不是 直接訪問 $_GET 和 $_POST. 這使你更容易編寫測試用例,因為你可以偽造數據來創建一個模擬哀求組件.
當實現 RESTful APIs 接口的時候,你經常需要獲取通過PUT, PATCH或者其他的 request methods 哀求方法提交上來的參數.你可以通過調用 yii\web\Request::getBodyParam() 方法來獲取這些參數.例如,
PHP實例
$request = Yii::$app->request;
// 返回所有參數
$params = $request->bodyParams;
// 返回參數 "id"
$param = $request->getBodyParam('id');
PHP實例信息：不同于 GET 參數,POST,PUT,PATCH 等等這些提交上來的參數是在哀求體中被發送的. 當你通過上面介紹的方法訪問這些參數的時候,request 組件會解析這些參數. 你可以通過配置 yii\web\Request::parsers 屬性來自定義怎樣解析這些參數.
PHP實例2.哀求方法
PHP實例你可以通過 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 */ }
PHP實例3.哀求URLs
PHP實例request 組件提供了許多方式來檢測當前哀求的URL.
PHP實例假設被哀求的URL是 http://example.com/admin/index.php/product?id=100, 你可以像下面描述的那樣獲取URL的各個部分：
PHP實例4.HTTP頭
PHP實例你可以通過 yii\web\Request::headers 屬性返回的 yii\web\HeaderCollection 獲取HTTP頭信息. 例如,
PHP實例
// $headers 是一個 yii\web\HeaderCollection 對象
$headers = Yii::$app->request->headers;
// 返回 Accept header 值
$accept = $headers->get('Accept');
if ($headers->has('User-Agent')) { /* 這是一個 User-Agent 頭 */ }
PHP實例哀求組件也提供了支持快速訪問常用頭的方法,包括：
PHP實例假如你的應用支持多語言,并且你想在終端用戶最喜歡的語言中顯示頁面,那么你可以使用語言協商方法 yii\web\Request::getPreferredLanguage(). 這個方法通過 yii\web\Request::acceptableLanguages 在你的應用中所支持的語言列表里進行比較篩選,返回最適合的語言.
PHP實例提示：你也可以使用 yii\filters\ContentNegotiator 過濾器進行動態確定哪些內容類型和語言應該在響應中使用. 這個過濾器實現了上面介紹的內容協商的屬性和辦法.
PHP實例5.客戶端信息
PHP實例你可以通過 yii\web\Request::userHost 和 yii\web\Request::userIP 分別獲取host name和客戶機的IP地址, 例如,
PHP實例
$userHost = Yii::$app->request->userHost;
$userIP = Yii::$app->request->userIP;
PHP實例二、響應(Responses)
響應：
當應用完成處理一個哀求后, 會生成一個yii\web\Response響應對象并發送給終端用戶 響應對象包含的信息有HTTP狀態碼,HTTP頭和主體內容等, 網頁應用開發的最終目的本質上就是根據不同的哀求構建這些響應對象.
PHP實例在大多是情況下主要處理繼承自 yii\web\Response 的 response 應用組件, 盡管如此,Yii也允許你創建你本身的響應對象并發送給終端用戶,這方面后續會闡述.
PHP實例在本節,將會描述如何構建響應和發送給終端用戶.
PHP實例1.狀態碼
PHP實例構建響應時,最先應做的是標識哀求是否成功處理的狀態,可通過設置 yii\web\Response::statusCode 屬性,該屬性使用一個有效的HTTP 狀態碼.例如,為標識處理已被處理成功, 可設置狀態碼為200,如下所示：
PHP實例
Yii::$app->response->statusCode = 200;
PHP實例盡管如此,大多數情況下不需要明確設置狀態碼,因為 yii\web\Response::statusCode 狀態碼默認為200, 如果需要指定哀求失敗,可拋出對應的HTTP異常,如下所示：
PHP實例
throw new \yii\web\NotFoundHttpException;
PHP實例當錯誤處理器 捕獲到一個異常,會從異常中提取狀態碼并賦值到響應, 對于上述的 yii\web\NotFoundHttpException 對應HTTP 404狀態碼,以下為Yii預定義的HTTP異常：
PHP實例如果想拋出的異常不在如上列表中,可創建一個yii\web\HttpException異常,帶上狀態碼拋出,如下：
PHP實例
throw new \yii\web\HttpException(402);
PHP實例2.HTTP 頭部
PHP實例可在 response 組件中操控yii\web\Response::headers來發送HTTP頭部信息,例如：
PHP實例
$headers = Yii::$app->response->headers;
// 增加一個 Pragma 頭,已存在的Pragma 頭不會被覆蓋.
$headers->add('Pragma', 'no-cache');
// 設置一個Pragma 頭. 任何已存在的Pragma 頭都會被丟棄
$headers->set('Pragma', 'no-cache');
// 刪除Pragma 頭并返回刪除的Pragma 頭的值到數組
$values = $headers->remove('Pragma');
PHP實例補充: 頭名稱是大小寫敏感的,在yii\web\Response::send()辦法調用前新注冊的頭信息并不會發送給用戶.
PHP實例3.響應主體
PHP實例大多是響應應有一個主體存放你想要顯示給終端用戶的內容.
PHP實例如果已有格式化好的主體字符串,可賦值到響應的yii\web\Response::content屬性,例如：
PHP實例
Yii::$app->response->content = 'hello world!';
PHP實例如果在發送給終端用戶之前必要格式化,應設置 yii\web\Response::format 和 yii\web\Response::data 屬性,yii\web\Response::format 屬性指定yii\web\Response::data中數據格式化后的樣式,例如：
PHP實例
$response = Yii::$app->response;
$response->format = \yii\web\Response::FORMAT_JSON;
$response->data = ['message' => 'hello world'];
PHP實例Yii支持以下可直接使用的格式,每個實現了yii\web\ResponseFormatterInterface 類, 可自定義這些格式器或通過配置yii\web\Response::formatters 屬性來增加格式器.
PHP實例上述響應主體可明確地被設置,但是在大多數情況下是通過 操作 辦法的返回值隱式地設置,常用場景如下所示：
PHP實例
public function actionIndex()
{
return $this->render('index');
}
PHP實例上述的 index 操作返回 index 視圖渲染結果,返回值會被 response 組件格式化后發送給終端用戶.
PHP實例因為響應格式默認為yii\web\Response::FORMAT_HTML, 只需要在操作辦法中返回一個字符串, 如果想使用其他響應格式,應在返回數據前先設置格式,例如：
PHP實例
public function actionInfo()
{
\Yii::$app->response->format = \yii\web\Response::FORMAT_JSON;
return [
'message' => 'hello world',
'code' => 100,
];
}
PHP實例如上所述,觸雷使用默認的 response 應用組件,也可創建自己的響應對象并發送給終端用戶,可在操作辦法中返回該響應對象,如下所示：
PHP實例
public function actionInfo()
{
return \Yii::createObject([
'class' => 'yii\web\Response',
'format' => \yii\web\Response::FORMAT_JSON,
'data' => [
'message' => 'hello world',
'code' => 100,
],
]);
}
PHP實例注意: 如果創建你本身的響應對象,將不能在應用配置中設置 response 組件,盡管如此, 可使用 依賴注入 應用通用配置到你新的響應對象.
PHP實例4.瀏覽器跳轉
PHP實例瀏覽器跳轉依賴于發送一個Location HTTP 頭,因為該功能通常被使用,Yii提供對它提供了特別的支持.
PHP實例可調用yii\web\Response::redirect() 辦法將用戶瀏覽器跳轉到一個URL地址,該辦法設置合適的 帶指定URL的 Location 頭并返回它自己為響應對象,在操作的辦法中,可調用縮寫版yii\web\Controller::redirect(),例如：
PHP實例
public function actionOld()
{
return $this->redirect('http://example.com/new', 301);
}
PHP實例在如上代碼中,操作的辦法返回redirect() 辦法的結果,如前所述,操作的辦法返回的響應對象會被當總響應發送給終端用戶.
PHP實例除了操作辦法外,可直接調用yii\web\Response::redirect() 再調用 yii\web\Response::send() 辦法來確保沒有其他內容追加到響應中.
PHP實例
\Yii::$app->response->redirect('http://example.com/new', 301)->send();
PHP實例補充: yii\web\Response::redirect() 方法默認會設置響應狀態碼為302,該狀態碼會告訴瀏覽器哀求的資源 臨時 放在另一個URI地址上,可傳遞一個301狀態碼告知瀏覽器哀求的資源已經 永久 重定向到新的URId地址.
如果當前哀求為AJAX 哀求,發送一個 Location 頭不會自動使瀏覽器跳轉,為解決這個問題, yii\web\Response::redirect() 方法設置一個值為要跳轉的URL的X-Redirect 頭, 在客戶端可編寫JavaScript 代碼讀取該頭部值然后讓瀏覽器跳轉對應的URL.
PHP實例補充: Yii 配備了一個yii.js JavaScript 文件提供常用JavaScript功能,包含基于X-Redirect頭的瀏覽器跳轉, 因此,如果你使用該JavaScript 文件(通過yii\web\YiiAsset 資源包注冊),就不需要編寫AJAX跳轉的代碼.
PHP實例5.發送文件
PHP實例和瀏覽器跳轉類似,文件發送是另一個依賴指定HTTP頭的功能,Yii提供辦法集合來支持各種文件發送需求,它們對HTTP頭都有內置的支持.
PHP實例這些辦法都將響應對象作為返回值,如果要發送的文件非常大,應考慮使用 yii\web\Response::sendStreamAsFile() 因為它更節約內存,以下示例顯示在控制器操作中如何發送文件：
PHP實例
public function actionDownload()
{
return \Yii::$app->response->sendFile('path/to/file.txt');
}
PHP實例如果不是在操作辦法中調用文件發送辦法,在后面還應調用 yii\web\Response::send() 沒有其他內容追加到響應中.
PHP實例
\Yii::$app->response->sendFile('path/to/file.txt')->send();
PHP實例一些瀏覽器提供特殊的名為X-Sendfile的文件發送功能,原理為將哀求跳轉到服務器上的文件, Web應用可在服務器發送文件前結束,為使用該功能,可調用yii\web\Response::xSendFile(), 如下簡要列出一些常用Web服務器如何啟用X-Sendfile 功能：
PHP實例
Apache: X-Sendfile
Lighttpd v1.4: X-LIGHTTPD-send-file
Lighttpd v1.5: X-Sendfile
Nginx: X-Accel-Redirect
Cherokee: X-Sendfile and X-Accel-Redirect
PHP實例6.發送響應
PHP實例在yii\web\Response::send() 辦法調用前響應中的內容不會發送給用戶,該辦法默認在yii\base\Application::run() 結尾自動調用,盡管如此,可以明確調用該辦法強制立即發送響應.
PHP實例yii\web\Response::send() 辦法使用以下步驟來發送響應：
PHP實例一旦yii\web\Response::send() 辦法被執行后,其他地方調用該辦法會被忽略, 這意味著一旦響應發出后,就不能再追加其他內容.
PHP實例如你所見yii\web\Response::send() 觸發了幾個實用的變亂,通過響應這些變亂可調整或包裝響應.
《PHP編程：解讀PHP的Yii框架中請求與響應的處理流程》是否對您有啟發，歡迎查看更多與《PHP編程：解讀PHP的Yii框架中請求與響應的處理流程》相關教程，學精學透。維易PHP學院為您提供精彩教程。
