本文實(shí)例講述了Zend Framework教程之前端控制器Zend_Controller_Front用法。分享給大家供大家參考，具體如下：
主要功能
ZendFramework的MVC實(shí)現(xiàn)的核心機(jī)制是通過(guò)Zend_Controller_Front前端控制器，用于初始化請(qǐng)求環(huán)境，處理請(qǐng)求，路由分發(fā)，完成響應(yīng)操作，Zend_Controller_Front采用的單例模式，所以一個(gè)應(yīng)用只有一個(gè)前端控制器。如果需要前端控制器提供一些特殊功能，可以繼承Zend_Controller_Front自定義前端控制器。
主要方法
getInstance()
用來(lái)獲取前端控制器實(shí)例。創(chuàng)建前端控制器對(duì)象的唯一方法。
$front = Zend_Controller_Front::getInstance();
setControllerDirectory() 和 addControllerDirectory()
setControllerDirectory()設(shè)置動(dòng)作控制器action controller類文件的存放位置。參數(shù)可以是路徑字符串或者關(guān)聯(lián)數(shù)組。
例如：
//路徑是相對(duì)于應(yīng)用的/application目錄下// 字符串$front->setControllerDirectory('../application/controllers');// 關(guān)聯(lián)數(shù)組$front->setControllerDirectory(array( 'default' => '../application/controllers', 'blog' => '../modules/blog/controllers', 'news' => '../modules/news/controllers',));// Add a 'foo' module directory:$front->addControllerDirectory('../modules/foo/controllers', 'foo'); Note: 如果使用addControllerDirectory()時(shí)不帶模塊名，將會(huì)為default模塊設(shè)定目錄——如果目錄已設(shè)定，就覆蓋掉。
可以通過(guò)getControllerDirectory()獲取控制器目錄的當(dāng)前設(shè)置；它將返回一個(gè)模塊/目錄對(duì)關(guān)聯(lián)數(shù)組。
addModuleDirectory() 和 getModuleDirectory()
前端控制器的一個(gè)功能是你可以 定義一個(gè)模塊目錄結(jié)構(gòu) 來(lái)創(chuàng)建獨(dú)立的組件，被叫做“模塊”。
每個(gè)模塊位于自己的目錄并和缺省模塊的目錄結(jié)構(gòu)一樣 － 例如，它至少 有個(gè) "controllers" 字目錄和 "views" 子目錄以及其它應(yīng)用子目錄。
addModuleDirectory() 讓你傳遞一個(gè)包含一個(gè)或多個(gè)模塊目錄的目錄名。 然后進(jìn)行掃描并把它們作為控制器目錄添加到前端控制器。
然后，如果你想確定特定模塊或當(dāng)前模塊路徑，調(diào)用 getModuleDirectory()， 可選地傳遞模塊名來(lái)獲得模塊目錄。
dispatch()
dispatch(Zend_Controller_Request_Abstract $request = null, Zend_Controller_Response_Abstract $response = null)完成前端控制器最繁重的工作。該方法帶有可選的參數(shù)請(qǐng)求對(duì)象和/或響應(yīng)對(duì)象，允許開(kāi)發(fā)人員為每一個(gè)傳入定制的對(duì)象。
如果沒(méi)有請(qǐng)求或者響應(yīng)對(duì)象傳入，dispatch()將檢查先前注冊(cè)的對(duì)象并使用，如果沒(méi)有發(fā)現(xiàn)則創(chuàng)建默認(rèn)的對(duì)象版本（它們兩個(gè)都默認(rèn)使用HTTP對(duì)象）。
類似的，dispatch()先檢查已注冊(cè)的路由器（router）和分發(fā)器（dispatcher）對(duì)象，如果沒(méi)有發(fā)現(xiàn)則實(shí)例化它們的默認(rèn)版本。
分發(fā)過(guò)程有三個(gè)不同的事件：路由（Routing）、分發(fā)（Dispatching）、響應(yīng)（Response）
路由只發(fā)生一次，當(dāng)調(diào)用dispatch()時(shí)利用請(qǐng)求對(duì)象中的值。分發(fā)發(fā)生在一個(gè)循環(huán)中;請(qǐng)求可能指示分發(fā)多個(gè)動(dòng)作，或者控制器或插件可能重置請(qǐng)求對(duì)象，強(qiáng)制分發(fā)附加的動(dòng)作。所有都完成后，前端控制器返回響應(yīng)對(duì)象。
run()
Zend_Controller_Front::run($path)是靜態(tài)方法，只帶一個(gè)參數(shù)，就是指向包含控制器的目錄的路徑。它首先通過(guò)getInstance()獲取前端控制器實(shí)例，然后通過(guò)setControllerDirectory()注冊(cè)傳入的路徑，最后分發(fā)。
基本上，如果不要求定制前端控制器環(huán)境，run()是一個(gè)很方便的建立前端控制器環(huán)境的方法。
Zend_Controller_Front::run('../application/controllers'); 環(huán)境訪問(wèn)器方法
除了上面所列的方法以外，還有很多訪問(wèn)器方法可以影響前端控制器環(huán)境 —— 因而也影響前端控制器代理（delegate）的類的環(huán)境。
resetInstance()方法清除當(dāng)前的所有設(shè)置。主要用來(lái)測(cè)試，不過(guò)，在希望將幾個(gè)前端控制器連鎖的地方也是很有用的（but it can also be used for instances where you wish to chain together multiple front controllers）。
(set|get)DefaultControllerName()方法可以為默認(rèn)的控制器指定另外一個(gè)名字（否則使用'index'），以及獲取當(dāng)前值。它們將代理分發(fā)器。
(set|get)DefaultAction()方法可以為默認(rèn)的動(dòng)作指定另外一個(gè)名字（否則使用'index'）,以及獲取當(dāng)前值。它們將代理分發(fā)器。
(set|get)Request()方法指定分發(fā)過(guò)程中使用的請(qǐng)求類或?qū)ο?，以及獲取當(dāng)前的請(qǐng)求對(duì)象。設(shè)置請(qǐng)求對(duì)象時(shí)，可以傳入一個(gè)請(qǐng)求類的名字，該方法將加載類文件并創(chuàng)建實(shí)例。
(set|get)Router()方法指定分發(fā)過(guò)程中使用的路由器類或?qū)ο螅约矮@取當(dāng)前對(duì)象。設(shè)置路由器時(shí)，可以傳入一個(gè)路由器類的名字，該方法將加載類文件并創(chuàng)建實(shí)例。
獲取路由器對(duì)象的時(shí)候，首先檢查是否已有一個(gè)，如果沒(méi)有，創(chuàng)建默認(rèn)的路由器實(shí)例（rewrite路由器）。
(set|get)BaseUrl()方法指定路由請(qǐng)求時(shí)剝離（strip）的基地址（base URL），以及獲取當(dāng)前值。這個(gè)值將在路由前提供給路由器。
(set|get)Dispatcher()方法指定分發(fā)過(guò)程中使用的分發(fā)器類或?qū)ο?，以及獲取當(dāng)前對(duì)象。設(shè)定分發(fā)器對(duì)象時(shí)，可以傳入一個(gè)分發(fā)器類的名字，該方法將加載類文件并創(chuàng)建實(shí)例。
獲取分發(fā)器對(duì)象時(shí)，首先檢查是否已有一個(gè)存在，如果沒(méi)有，將創(chuàng)建一個(gè)默認(rèn)的分發(fā)器實(shí)例。
(set|get)Response()方法指定分發(fā)過(guò)程中使用的響應(yīng)類或?qū)ο?，已?jīng)獲取當(dāng)前對(duì)象。設(shè)定響應(yīng)對(duì)象時(shí)，可以傳入一個(gè)響應(yīng)類的名字，該方法將加載類文件并創(chuàng)建實(shí)例。
registerPlugin(Zend_Controller_Plugin_Abstract $plugin, $stackIndex = null)方法允許注冊(cè)一個(gè)插件對(duì)象。通過(guò)設(shè)置可選參數(shù)$stackIndex，插件執(zhí)行的順序。
unregisterPlugin($plugin)方法移除插件對(duì)象。$plugin可以是一個(gè)插件對(duì)象或者代表移除插件類的字符串。
throwExceptions($flag)方法用來(lái)開(kāi)啟或者關(guān)閉分發(fā)過(guò)程中拋出異常的能力。默認(rèn)的，異常引起并放置在響應(yīng)對(duì)象中；開(kāi)啟throwExceptions()將覆蓋這一行為。
returnResponse($flag)方法通知前端控制器是否從dispatch()中返回請(qǐng)求對(duì)象（true），否則自動(dòng)發(fā)送響應(yīng)對(duì)象（false—）。默認(rèn)的，響應(yīng)對(duì)象被自動(dòng)發(fā)送（通過(guò)調(diào)用Zend_Controller_Response_Abstract::sendResponse()）；開(kāi)啟returnResponse()將覆蓋這一行為。
返回響應(yīng)對(duì)象的原因包括希望在發(fā)送響應(yīng)前檢查異常，記錄響應(yīng)的各種屬性（例如消息頭）等等。
前端控制器參數(shù)
介紹里曾提到前端控制器可以用作各種控制器組件的注冊(cè)表。它通過(guò)一個(gè)"param"家族的方法來(lái)做到這些。這些方法允許通過(guò)前端控制器注冊(cè)任意類型的數(shù)據(jù) —— 對(duì)象和變量，可以在分發(fā)鏈中的任何時(shí)候獲取。這些變量被傳遞到路由器，分發(fā)器，以及動(dòng)作控制器。這些方法包括：
setParam($name, $value)方法設(shè)定值為$value的單個(gè)參數(shù)$name。
setParams(array $params)方法通過(guò)關(guān)聯(lián)數(shù)組一次設(shè)定多個(gè)參數(shù)。
getParam($name)方法通過(guò)$name標(biāo)識(shí)符獲取單個(gè)參數(shù)。
getParams()方法一次獲取整個(gè)參數(shù)列表。
clearParams()方法可以清空一個(gè)參數(shù)（傳入單個(gè)字符串標(biāo)識(shí)符），清空多個(gè)參數(shù)（傳入字符串標(biāo)識(shí)符數(shù)組），清空整個(gè)參數(shù)棧（不傳入?yún)?shù)）。
有幾個(gè)預(yù)定義的參數(shù)可供設(shè)定，它們?cè)诜职l(fā)鏈中有特別的用途：
useDefaultControllerAlways用來(lái)提示 分發(fā)器遇到無(wú)法分發(fā)的請(qǐng)求時(shí)使用默認(rèn)模塊的默認(rèn)控制器。這默認(rèn)是關(guān)閉的。
閱讀可能遭遇的MVC異常獲得使用該設(shè)定的更詳盡信息。
disableOutputBuffering用來(lái)提示 is used to hint to 分發(fā)器不使用輸出緩沖來(lái)捕捉動(dòng)作控制器產(chǎn)生的輸出。默認(rèn)的，分發(fā)器捕捉任何輸出并追加到響應(yīng)對(duì)象的主體內(nèi)容。
noViewRenderer用來(lái)禁用ViewRenderer。設(shè)定該參數(shù)為true可以禁用該助手。
noErrorHandler 用來(lái)禁用錯(cuò)誤處理器插件。設(shè)定該參數(shù)為true可以禁用該插件。
自定義前端控制器
要繼承前端控制器，至少需要覆蓋getInstance()方法：
class My_Controller_Front extends Zend_Controller_Front{ public static function getInstance() { if (null === self::$_instance) { self::$_instance = new self(); } return self::$_instance; }} 覆蓋getInstance()保證后面調(diào)用Zend_Controller_Front::getInstance()會(huì)返回子類的實(shí)例，而不是Zend_Controller_Front實(shí)例，這對(duì)于一些可替換的路由器和視圖助手非常有用。
通常不需要繼承前端控制器，除非你需要增加新的功能（比如，一個(gè)插件自動(dòng)加載器，或者一個(gè)方法來(lái)指定動(dòng)作助手路徑）。你想要改動(dòng)的地方可能包括修改控制器目錄的存儲(chǔ)方式，使用的默認(rèn)路由器以及分發(fā)器。
ZendFramewrok提供的默認(rèn)前端控制器已經(jīng)足夠我們使用了，通過(guò)Bootstrap功能，完全沒(méi)有必要手動(dòng)編寫(xiě)代碼改變Zend_Controller_Front的默認(rèn)機(jī)制。所以通常情況下Zend_Controller_Front對(duì)于應(yīng)用來(lái)說(shuō)是不存在。如果需要使用Zend_Controller_Front提供的功能，通過(guò)Zend_Controller_Front::getInstance();獲取實(shí)例即可。
