模塊設計
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控制器類
appindexcontrollerIndex
// index模塊的User模型類
appindexmodelUser
其中app
可以通過定義的方式更改,例如我們在應用配置文件中修改:
'app_namespace' => 'application',
那么,index模塊的類庫命名空間則變成:
// index模塊的Index控制器類
applicationindexcontrollerIndex
// index模塊的User模型類
applicationindexmodelUser
更多的關于類庫和命名空間的關系可以參考下一章節:命名空間。
模塊和控制器隱藏
由于默認是采用多模塊的支持,所以多個模塊的情況下必須在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(或者其它應用入口)/控制器/操作/[參數名/參數值...]
同時,單一模塊設計下的應用類庫的命名空間也有所調整,例如:
原來的
appindexcontrollerIndex
appindexmodelUser
變成
appcontrollerIndex
appmodelUser
更多的URL簡化和定制還可以通過URL路由功能實現。