運行機制概述
每一次 Yii 應用開始處理 HTTP 請求時,它都會進行一個近似的流程。
下面的示意圖展示了應用是如何處理一個請求的。
啟動引導(Bootstrapping)
啟動引導是指:在應用開始解析並處理新接受請求之前,一個預先准備環境的過程。啟動引導會在兩個地方具體進行:入口腳本(Entry Script) 和 應用主體(application)。
在入口腳本裡,需注冊各個類庫的類文件自動加載器(Class Autoloader,簡稱自動加載器)。這主要包括通過其 autoload.php 文件加載的 Composer 自動加載器,以及通過 Yii 類加載的 Yii 自動加載器。之後,入口腳本會加載應用的 配置(configuration) 並創建一個 應用主體 的實例。
在應用主體的構造函數中,會執行以下引導工作:
因為引導工作必須在處理每一次請求之前都進行一遍,因此讓該過程盡可能輕量化就異常重要,請盡可能地優化這一步驟。
請盡量不要注冊太多引導組件。只有他需要在 HTTP 請求處理的全部生命周期中都作用時才需要使用它。舉一個用到它的范例:一個模塊需要注冊額外的 URL 解析規則,就應該把它列在應用的 bootstrap 屬性之中,這樣該 URL 解析規則才能在解析請求之前生效。(譯注:換言之,為了性能需要,除了 URL 解析等少量操作之外,絕大多數組件都應該按需加載,而不是都放在引導過程中。)
在生產環境中,可以開啟字節碼緩存,比如 APC,來進一步最小化加載和解析 PHP 文件所需的時間。
一些大型應用都包含有非常復雜的應用配置,它們會被分割到許多更小的配置文件中。此時,可以考慮將整個配置數組緩存起來,並在入口腳本創建應用實例之前直接從緩存中加載。
yii的入口文件
這裡使用了一個第三方的配置管理插件:marcovwout,來管理Yii的配置,細節我就不說了。剩下的就是就是一些基本的全局變量設置了。往Yii::createWebApplication裡面傳入配置的數組,然後調用run方法,一個web應用是不是就這麼跑起來了,是的,抽象到最高層就是這樣:我往一個容器裡面傳入對應的配置,然後這個應用可以基於該配置正常運行起來。
說YiiBase中的兩個比較重要的方法 (import,autoload)
這裡使用了一個第三方的配置管理插件:marcovwout,來管理Yii的配置,細節我就不說了。剩下的就是就是一些基本的全局變量設置了。往Yii::createWebApplication裡面傳入配置的數組,然後調用run方法,一個web應用是不是就這麼跑起來了,是的,抽象到最高層就是這樣:我往一個容器裡面傳入對應的配置,然後這個應用可以基於該配置正常運行起來。
路由
當入口腳本在調用 yii\web\Application::run() 方法時,它進行的第一個操作就是解析輸入的請求,然後實例化對應的控制器操作處理這個請求。該過程就被稱為引導路由(routing)。(譯注:中文裡既是動詞也是名詞)
解析路由
路由引導的第一步,是把傳入請求解析為一個路由。如我們在 控制器(Controllers) 章節中所描述的那樣,路由是一個用於定位控制器操作的地址。這個過程通過 request 應用組件的 yii\web\Request::resolve() 方法實現,該方法會調用 URL 管理器 進行實質上的請求解析工作。
默認情況下,傳入請求會包含一個名為 r 的 GET 參數,它的值即被視為路由。但是如果啟用 yii\web\UrlManager::enablePrettyUrl,那麼在確定請求的路由時,就會進行更多處理。具體的細節請參考 URL 的解析與生成 章節。
假使某路由最終實在無法被確定,那麼 request 組件會拋出 yii\web\NotFoundHttpException 異常(譯注:大名鼎鼎的 404)。
缺省路由
如果傳入請求並沒有提供一個具體的路由,(一般這種情況多為於對首頁的請求)此時就會啟用由 yii\web\Application::defaultRoute 屬性所指定的缺省路由。該屬性的默認值為 site/index,它指向 site 控制器的 index 操作。你可以像這樣在應用配置中調整該屬性的值:
return [ // ... 'defaultRoute' => 'main/index', ];
catchAll 路由(全攔截路由)
有時候,你會想要將你的 Web 應用臨時調整到維護模式,所有的請求下都會顯示相同的信息頁。當然,要實現這一點有很多種方法。這裡面最簡單快捷的方法就是在應用配置中設置下 yii\web\Application::catchAll 屬性:
return [ // ... 'catchAll' => ['site/offline'], ];
catchAll 屬性需要傳入一個數組做參數,該數組的第一個元素為路由,剩下的元素會(以名值對的形式)指定綁定於該操作的各個參數。
當設置了 catchAll 屬性時,它會替換掉所有從輸入的請求中解析出來的路由。如果是上文的這種設置,用於處理所有傳入請求的操作都會是相同的 site/offline。
創建操作
一旦請求路由被確定了,緊接著的步驟就是創建一個“操作(action)”對象,用以響應該路由。
路由可以用裡面的斜槓分割成多個組成片段,舉個栗子,site/index 可以分解為 site 和 index 兩部分。每個片段都是指向某一模塊(Module)、控制器(Controller)或操作(action)的 ID。
從路由的首個片段開始,應用會經過以下流程依次創建模塊(如果有),控制器,以及操作:
在上面的步驟裡,如果有任何錯誤發生,都會拋出 yii\web\NotFoundHttpException,指出路由引導的過程失敗了。