## 模型定義 定義一個`User`模型類很簡單： ~~~ <?php namespace app\index\model; use think\Model; class User extends Model { } ~~~ >[info] 請確保你已經在數據庫配置文件中配置了數據庫連接信息，如不清楚請參考數據庫一章 模型會自動對應數據表，模型類的命名規則是除去表前綴的數據表名稱，采用駝峰法命名，并且首字母大寫，例如： | 模型名 | 約定對應數據表（假設數據庫的前綴定義是 `think_`） | |-----|-----| | User | think_user | | UserType | think_user_type | 如果你的規則和上面的系統約定不符合，那么需要設置Model類的數據表名稱屬性，以確保能夠找到對應的數據表。 >[danger] 模型自動對應的數據表名稱都是遵循小寫+下劃線規范，如果你的表名有大寫的情況，必須通過設置模型的table屬性。 如果擔心模型的名稱和PHP關鍵字沖突，可以啟用類后綴功能，只需要在應用配置文件`app.php`中設置： ~~~ // 開啟應用類庫后綴 'class_suffix' => true, ~~~ >[danger] 開啟后，所有的應用類庫定義的時候都需要加上對應后綴，包括控制器類。 這樣`app\index\model\User`類定義就要改成 ~~~ <?php namespace app\index\model; use think\Model; class UserModel extends Model { } ~~~ 并且文件名也要改為`UserModel.php`。 >[info] 大多數情況下，不同模塊的模型是不需要獨立的，因此可以統一在`common`模塊下面定義模型。 ## 模型設置 默認主鍵為`id`，如果你沒有使用`id`作為主鍵名，需要在模型中設置屬性： ~~~ <?php namespace app\index\model; use think\Model; class User extends Model { protected $pk = 'uid'; } ~~~ >[danger] 5.1中模型不會自動獲取主鍵名稱，必須設置pk屬性。 如果你想指定數據表甚至數據庫連接的話，可以使用： ~~~ <?php namespace app\index\model; use think\Model; class User extends Model { // 設置當前模型對應的完整數據表名稱 protected $table = 'think_user'; // 設置當前模型的數據庫連接 protected $connection = 'db_config'; } ~~~ `connection`屬性的建議用配置參數名（需要在`database.php`中添加）而不是具體的連接信息，從而避免把數據庫連接固化在代碼里面。 常用的模型設置屬性包括（以下屬性都不是必須設置）： 屬性|描述 ---|--- name|模型名（默認為當前不含后綴的模型類名） table|數據表名（默認自動獲取） pk|主鍵名（默認為`id`） connection|數據庫連接（默認讀取數據庫配置） query|模型使用的查詢類名稱 field|模型對應數據表的字段列表（數組） ## 模型初始化 模型同樣支持初始化，與控制器的初始化不同的是，模型的初始化是定義`Model`的`init`方法，具體如下 ~~~ <?php namespace app\index\model; use think\Model; class User extends Model { // 模型初始化 protected static function init() { //TODO:初始化內容 } } ~~~ 模型初始化方法通常用于注冊模型的事件操作。 >[danger] `init`必須是靜態方法，并且只在第一次實例化的時候執行 ## 模型操作 > 在模型中除了可以調用數據庫類的方法之外（換句話說，數據庫的所有查詢方法模型中都可以支持），可以定義自己的方法，所以也可以把模型看成是數據庫的增強版。 模型的查詢方法無需和數據庫查詢一樣調用`table`或者`name`方法，因為模型會按照規則自動匹配對應的數據表，例如： ~~~ Db::name('user')->where('id','>',10)->select(); ~~~ 改成模型操作的話就變成 ~~~ User::where('id','>',10)->select(); ~~~ 雖然看起來是相同的查詢條件，但一個最明顯的區別是**查詢結果的類型**不同。第一種方式的查詢結果是一個（二維）數組，而第二種方式的查詢結果是包含了模型（集合）的數據集。不過，在大多數情況下，這二種返回類型的使用方式并無明顯區別。 模型操作和數據庫操作的另外一個顯著區別是模型支持包括獲取器、修改器、自動完成在內的一系列自動化操作和事件，簡化了數據的存取操作，但隨之而來的是性能有所下降（其實并沒下降，而是自動幫你處理了一些原本需要手動處理的操作），后面會逐步領略到模型的這些特色功能。