模塊設(shè)計(jì)

5.0版本對(duì)模塊的功能做了靈活設(shè)計(jì)，默認(rèn)采用多模塊的架構(gòu)，并且支持單一模塊設(shè)計(jì)，所有模塊的命名空間均以app作為根命名空間（可配置更改）。

目錄結(jié)構(gòu)

標(biāo)準(zhǔn)的應(yīng)用和模塊目錄結(jié)構(gòu)如下：

├─application           應(yīng)用目錄（可設(shè)置）
│  ├─common             公共模塊目錄（可選）
│  ├─common.php         公共函數(shù)文件
│  ├─route.php          路由配置文件
│  ├─database.php       數(shù)據(jù)庫(kù)配置文件
│  ├─config.php         應(yīng)用配置文件
│  ├─module1            模塊1目錄
│  │  ├─config.php      模塊配置文件
│  │  ├─common.php      模塊函數(shù)文件
│  │  ├─controller      控制器目錄
│  │  ├─model           模型目錄（可選）
│  │  ├─view            視圖目錄（可選）
│  │  └─ ...            更多類庫(kù)目錄
│  │ 
│  ├─module2            模塊2目錄
│  │  ├─config.php      模塊配置文件
│  │  ├─common.php      模塊函數(shù)文件
│  │  ├─controller      控制器目錄
│  │  ├─model           模型目錄（可選）
│  │  ├─view            視圖目錄（可選）
│  │  └─ ...            更多類庫(kù)目錄

遵循ThinkPHP5.0的命名規(guī)范，模塊目錄全部采用小寫和下劃線命名。

模塊名稱請(qǐng)避免使用PHP保留關(guān)鍵字（保留字列表參見(jiàn) http://php.net/manual/zh/reserved.keywords.php ），否則會(huì)造成系統(tǒng)錯(cuò)誤。

其中common模塊是一個(gè)特殊的模塊，默認(rèn)是禁止直接訪問(wèn)的，一般用于放置一些公共的類庫(kù)用于其他模塊的繼承。

模塊類庫(kù)

一個(gè)模塊下面的類庫(kù)文件的命名空間統(tǒng)一以app模塊名開(kāi)頭，例如：

// index模塊的Index控制器類
appindexcontrollerIndex
// index模塊的User模型類
appindexmodelUser

其中app可以通過(guò)定義的方式更改，例如我們?cè)趹?yīng)用配置文件中修改：

'app_namespace' => 'application',

那么，index模塊的類庫(kù)命名空間則變成：

// index模塊的Index控制器類
applicationindexcontrollerIndex
// index模塊的User模型類
applicationindexmodelUser

更多的關(guān)于類庫(kù)和命名空間的關(guān)系可以參考下一章節(jié)：命名空間。

模塊和控制器隱藏

由于默認(rèn)是采用多模塊的支持，所以多個(gè)模塊的情況下必須在URL地址中標(biāo)識(shí)當(dāng)前模塊，如果只有一個(gè)模塊的話，可以進(jìn)行模塊綁定，方法是應(yīng)用的入口文件中添加如下代碼：

// 綁定當(dāng)前訪問(wèn)到index模塊
define('BIND_MODULE','index');

綁定后，我們的URL訪問(wèn)地址則變成：

http://serverName/index.php/控制器/操作/[參數(shù)名/參數(shù)值...]

訪問(wèn)的模塊是index模塊。

如果你的應(yīng)用比較簡(jiǎn)單，模塊和控制器都只有一個(gè)，那么可以在應(yīng)用公共文件中綁定模塊和控制器，如下：

// 綁定當(dāng)前訪問(wèn)到index模塊的index控制器
define('BIND_MODULE','index/index');

設(shè)置后，我們的URL訪問(wèn)地址則變成：

http://serverName/index.php/操作/[參數(shù)名/參數(shù)值...]

訪問(wèn)的模塊是index模塊，控制器是Index控制器。

單一模塊

如果你的應(yīng)用比較簡(jiǎn)單，只有唯一一個(gè)模塊，那么可以進(jìn)一步簡(jiǎn)化成使用單一模塊結(jié)構(gòu)，方法如下：

首先在應(yīng)用配置文件中定義：

// 關(guān)閉多模塊設(shè)計(jì)
'app_multi_module'  =>  false,

然后，調(diào)整應(yīng)用目錄的結(jié)構(gòu)為如下：

├─application        應(yīng)用目錄（可設(shè)置）
│  ├─controller      控制器目錄
│  ├─model           模型目錄
│  ├─view            視圖目錄
│  ├─ ...            更多類庫(kù)目錄
│  ├─common.php      函數(shù)文件
│  ├─route.php       路由配置文件
│  ├─database.php    數(shù)據(jù)庫(kù)配置文件
│  └─config.php      配置文件

URL訪問(wèn)地址變成

http://serverName/index.php（或者其它應(yīng)用入口）/控制器/操作/[參數(shù)名/參數(shù)值...]

同時(shí)，單一模塊設(shè)計(jì)下的應(yīng)用類庫(kù)的命名空間也有所調(diào)整，例如：

原來(lái)的

appindexcontrollerIndex
appindexmodelUser

變成

appcontrollerIndex
appmodelUser

更多的URL簡(jiǎn)化和定制還可以通過(guò)URL路由功能實(shí)現(xiàn)。