技術交流

Zend Framework 應用程式開發：模組化結構

Dennis

• 本期導覽
• 技術交流

前一期文章我們討論了 Zend Framework 應用程式開發入門，介紹了 Framework 和 Library 的區別及 Zend Framework 的安裝。本篇我們將一起討論資料夾佈局 -- 模組化結構 ( Modular Structure ) 。

何謂模組化結構？

簡單說，就是按應用程式之功能分別歸類到不同的資料夾內。以資通的 eHR 系統來說，包含有 " 薪酬福利 "、" 績效考核 "、" 教育訓練 "、" 職能鑒定 " 等等模組，對應到 Zend Framework Based 的系統中時就會有對應的資料夾如：compensation/pa/training/competency。

初次接觸 Zend Framework 的朋友可能有點困擾，應用程式該怎麼來佈局才比較好？作者剛開始接觸 Zend Framework 時也有同樣的困擾。其實 Zend Framework 在資料夾佈局上提供了非常靈活的方式。主要有以下幾種：

• 放在同一個目錄下
• Default 模組例外
• 模組化佈局

同一目錄

所有的程式都在同一個資料夾，即 application 資料夾下面。資料夾結構請參考上一期文章的 myproject. 這種適合比較小的應用程式，比如說個人blog 等小的應用。在應用程式中用到的 Controller、Views、Models分別放到對應的資料下。如果專案比較大的話，這樣維護起來就不方便了。

Default 模組例外

Zend Framework 專案建立後， zf tools 會自動幫我們建立一個叫做 " default " 的模組。除這個模組不變之外，其它的模組都會放在 modules 之下。

在運行時，http://yourdomainORIP/ 在 configs/application.ini 和 Bootstrap.php 中無需要做特別設定，系統就會自動 run application下的 Controller 中的 IndexController.php， view 會自動執行 application 下 views/index/index.phtml，也就是我們在 Browser 的地址欄輸入 ( 以 localhost為例 ) http://localhost/default/index 或是 http://localhost/index/a/1/b/2 就會顯示 index.phtml 中的內容。

對URL做一個簡單的說明： default → 表示 module 的名稱，如果沒有輸入預設的 module 名稱，就是 "default"， index→ 表示 controller 的名稱，如果後面再有就表示參數，上面的url 中有兩個參數 a,b； 值分別是 1,2 。

模組化佈局

模組化佈局是 Zend Framework 官方推薦的方式，這也是作者推薦它的原因之一。令人 confuse 的是，用 Zend Studio 的開發工具建立的專案預設並沒有這麼佈局，而是需要我們自己手動調整，或許後面的版本會改變這個局面。如果是做小的應用， 我們可能不會選擇這麼重量級的 Framework，畢竟市面上輕量級的、優秀的 Framework 還是蠻多的。

言歸正傳，我們重點介紹一下模組化佈局。當我們在開發企業應用時，把不同功能分成不同的模組，如文章開頭所提到的資通 HCP 產品。每個模組之間都是獨立的，這樣有利於不同地方的團隊開發和日後的維護。

application 的 module 下現在有兩個模組 admin 和 default，以 admin 模組說明如下：
configs ： 對 admin 這個模組的 config 文件。
( 註：application/configs/application.ini 是針對整個 Project 所設定或說是全局的。 )
controllers：admin 模組的 Controller 文件所在。
forms： admin 模組的 Form程式所在。
locals： admin 模組的多國語文件所在。
models： admin 模組的 Model 部分程式所在。
views： admin 模組的 View 部分程式所在。
Bootstrap. php： admin模組的 Bootstrap。

如上結構設定好之後，還需要加些代碼才能讓上面的結構生效，比如我們要訪問 http://localhost/admin 或是 http://localhost/pa/ 之類，如果不加代碼，您將會看到如下錯誤：

Fatal error: Class 'Default_Model_User' not found in /home/dennis/www/eHR6/application/modules/default/controllers/IndexController.php on line 40

除去上面的錯誤，需要在 application/config/application.ini 和 application/Bootstrap.php 兩支程式做相應修改。

application.ini 配置文件中加以下代碼：

resources.modules[] = ""
resources.frontController.moduleDirectory = AppLICATION_PATH "/modules"
resources.frontController.moduleControllerDirectoryName = "controllers"

Bootstrap.php 中加以下代碼：

protected function _initControllers()
{
$front = Zend_Controller_Front::getInstance();
$front→addModuleDirectory(MODULE_PATH);
}

加上代碼之後，您在 modules 所添加的模組也不需要做任何設定或是 coding 就可以直接以 http://localhost/YOUR_MODULE_NAME/ 方式訪問了。