thinkPHP 模塊設計

5.0版本對模塊的功能做了靈活設計，默認采用多模塊的架構，並且支持單一模塊設計，所有模塊的命名空間均以app作為根命名空間（可配置更改）。

目錄結構

標准的應用和模塊目錄結構如下：

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

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

模塊名稱請避免使用PHP保留關鍵字（保留字列表參見 http://php.net/manual/zh/reserved.keywords.php ），否則會造成系統錯誤。

其中common模塊是一個特殊的模塊，默認是禁止直接訪問的，一般用於放置一些公共的類庫用於其他模塊的繼承。

模塊類庫

一個模塊下面的類庫文件的命名空間統一以app\模塊名開頭，例如：

// index模塊的Index控制器類 app\index\controller\Index // index模塊的User模型類 app\index\model\User 

其中app可以通過定義的方式更改，例如我們在應用配置文件中修改：

'app_namespace' => 'application', 

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

// index模塊的Index控制器類 application\index\controller\Index // index模塊的User模型類 application\index\model\User 

更多的關於類庫和命名空間的關系可以參考下一章節：命名空間。

模塊和控制器隱藏

由於默認是采用多模塊的支持，所以多個模塊的情況下必須在URL地址中標識當前模塊，如果只有一個模塊的話，可以進行模塊綁定，方法是應用的入口文件中添加如下代碼：

// 綁定當前訪問到index模塊 define('BIND_MODULE','index'); 

綁定后，我們的URL訪問地址則變成：

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

訪問的模塊是index模塊。

如果你的應用比較簡單，模塊和控制器都只有一個，那么可以在應用公共文件中綁定模塊和控制器，如下：

// 綁定當前訪問到index模塊的index控制器 define('BIND_MODULE','index/index'); 

設置后，我們的URL訪問地址則變成：

http://serverName/index.php/操作/[參數名/參數值...]

訪問的模塊是index模塊，控制器是Index控制器。

單一模塊

如果你的應用比較簡單，只有唯一一個模塊，那么可以進一步簡化成使用單一模塊結構，方法如下：

首先在應用配置文件中定義：

// 關閉多模塊設計 'app_multi_module' => false, 

然后，調整應用目錄的結構為如下：

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

URL訪問地址變成

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

同時，單一模塊設計下的應用類庫的命名空間也有所調整，例如：

原來的

app\index\controller\Index
app\index\model\User

變成

app\controller\Index
app\model\User

更多的URL簡化和定制還可以通過URL路由功能實現。