## 模型字段 模型的數據字段和對應數據表的字段是對應的，默認會自動獲取（包括字段類型），但自動獲取會導致增加一次查詢，因此你可以在模型中明確定義字段信息避免多一次查詢的開銷。 ~~~ <?php namespace app\model; use think\Model; class User extends Model { // 設置字段信息 protected $schema = [ 'id' => 'int', 'name' => 'string', 'status' => 'int', 'score' => 'float', 'create_time' => 'datetime', 'update_time' => 'datetime', ]; } ~~~ > 字段類型的定義可以使用PHP類型或者數據庫的字段類型都可以，字段類型定義的作用主要用于查詢的參數自動綁定類型。 >[danger] 時間字段盡量采用實際的數據庫類型定義，便于時間查詢的字段自動識別。如果是`json`類型直接定義為`json`即可。 如果你沒有定義`schema`屬性的話，可以在部署完成后運行如下指令。 ~~~cmd php think optimize:schema ~~~ 運行后會自動生成數據表的字段信息緩存。使用命令行緩存的優勢是Db類的查詢仍然有效。 > 需要在數據庫配置中設置`fields_cache`為`true`才能生成緩存 ## 字段類型 `schema`屬性一旦定義，就必須定義完整的數據表字段類型。 如果你只希望對某個字段定義需要自動轉換的類型，可以使用`type`屬性，例如： ~~~ <?php namespace app\model; use think\Model; class User extends Model { // 設置字段自動轉換類型 protected $type = [ 'score' => 'float', ]; } ~~~ `type`屬性定義的不一定是實際的字段，也有可能是你的字段別名。 ## 廢棄字段 如果因為歷史遺留問題 ，你的數據表存在很多的廢棄字段，你可以在模型里面定義這些不再使用的字段。 ~~~ <?php namespace app\model; use think\Model; class User extends Model { // 設置廢棄字段 protected $disuse = [ 'status', 'type' ]; } ~~~ 在查詢和寫入的時候會忽略定義的`status`和`type`廢棄字段。 ## 獲取數據 在模型外部獲取數據的方法如下 ~~~ $user = User::find(1); echo $user->create_time; echo $user->name; ~~~ 由于模型類實現了`ArrayAccess`接口，所以可以當成數組使用。 ~~~ $user = User::find(1); echo $user['create_time']; echo $user['name']; ~~~ 如果你是在模型內部獲取數據的話，需要改成： ~~~ $user = $this->find(1); echo $user->getAttr('create_time'); echo $user->getAttr('name'); ~~~ 否則可能會出現意想不到的錯誤。 ## 模型賦值 可以使用下面的代碼給模型對象賦值 ``` $user = new User(); $user->name = 'thinkphp'; $user->score = 100; ``` 該方式賦值會自動執行模型的修改器，如果不希望執行修改器操作，可以使用 ``` $data['name'] = 'thinkphp'; $data['score'] = 100; $user = new User($data); ``` 或者使用 ``` $user = new User(); $data['name'] = 'thinkphp'; $data['score'] = 100; $user->data($data); ``` `data`方法支持使用修改器 ``` $user = new User(); $data['name'] = 'thinkphp'; $data['score'] = 100; $user->data($data, true); ``` 如果需要對數據進行過濾，可以使用 ``` $user = new User(); $data['name'] = 'thinkphp'; $data['score'] = 100; $user->data($data, true, ['name','score']); ``` 表示只設置`data`數組的`name`和`score`數據。 > 注意:`data`方法會清空調用前設置的數據 以追加數據的方式賦值: ``` $user = new User(); $user->group_id = 1; $data['name'] = 'thinkphp'; $data['score'] = 100; $user->appendData($data); // 如果調用 data ,則清空group_id字段數據 ``` > 可以通過傳入第二個參數 true 來使用修改器 ,比如:appendData($data,true) ## 嚴格區分字段大小寫 默認情況下，你的模型數據名稱和數據表字段應該保持嚴格一致，也就是說區分大小寫。 ~~~ $user = User::find(1); echo $user->create_time; // 正確 echo $user->createTime; // 錯誤 ~~~ >[danger] 嚴格區分字段大小寫的情況下，如果你的數據表字段是大寫，模型獲取的時候也必須使用大寫。 如果你希望在獲取模型數據的時候不區分大小寫（前提是數據表的字段命名必須規范，即小寫+下劃線），可以設置模型的`strict`屬性。 ~~~ <?php namespace app\model; use think\Model; class User extends Model { // 模型數據不區分大小寫 protected $strict = false, } ~~~ 你現在可以使用 ~~~ $user = User::find(1); // 下面兩種方式都有效 echo $user->createTime; echo $user->create_time; ~~~ ## 模型數據轉駝峰 `V6.0.4+`版本開始，可以設置`convertNameToCamel`屬性使得模型數據返回駝峰方式命名（前提也是數據表的字段命名必須規范，即小寫+下劃線）。 ~~~ <?php namespace app\model; use think\Model; class User extends Model { // 數據轉換為駝峰命名 protected $convertNameToCamel = true, } ~~~ 然后在模型輸出的時候可以直接使用駝峰命名的方式獲取。 ~~~ $user = User::find(1); $data = $user->toArray(); echo $data['createTime']; // 正確 echo $user['create_time']; // 錯誤 ~~~