### 2018 年 12 月 31 日 發布 本文內容主要介紹下ThinkPHP`5.2`目前版本的數據庫和模型操作相對于`5.1`版本的一些變化區別。 總體來說，在數據庫和模型層面，`5.2`的改動并不大，只是因為強類型變量的約束會導致一些用法的差異，以及一些統一和廢棄的方法會導致查詢代碼的調整。 >[danger] `5.2`版本目前尚未正式發布，在正式發布之前可能仍然會存在變化。 ## 新特性 在`5.1`最新版本的基礎上，改進和新增了一些功能特性。 ### 強類型嚴格模式 新版核心全面啟用了嚴格模式，避免因為方法參數類型模糊而導致的規范不一或者潛在問題。 ### `Db`使用門面對象 新版的`Db`類不再是靜態類，需要使用`think\facade\Db`門面進行靜態代理。 ``` \think\facade\Db::name('user')->find(); ``` ### 重構的`fetchSql`方法 查詢類的`fetchSql`方法返回了一個新的`think\db\Fetch`類，獲取查詢SQL的操作和查詢操作完全隔離。另外一個副作用是可以使得查詢方法的返回值更加規范。`Fetch`類目前已經支持動態查詢方法。 ``` Db::name('user')->where('id', 1); // 返回\think\db\Query對象實例 Db::name('user')->where('id', 1)->fetchSql(); // 返回\think\db\Fetch對象實例 ``` ### 增加樂觀鎖功能 和軟刪除一樣，增加了一個`think\model\concern\OptimLock`Trait用于方便引入擴展模型的樂觀鎖功能。 ``` <?php namespace app\index\model; use think\model\conern\OptimLock; use think\Model; class User extends Model { use OptimLock; protected $optimLock = 'lock_version'; } ``` ### 增加`fetchArray`方法 模型的查詢可以通過顯式調用`fetchArray`方法使得查詢結果返回數組而不是模型對象和數據集，適用于一些圖表控件的數據輸出。 ``` // 返回模型對象 User::find(1); // 返回數組 User::fetchArray()->find(1); ``` ### 模型增加`Schema`定義 模型類增加`schema`屬性，用于**完整定義**模型對應數據表的字段信息，可以避免查詢的時候獲取數據表字段信息而無需生成`Schema`緩存。并且該屬性中定義字段類型支持使用`php`類型定義。需要注意和`field`/`type`屬性的區別，field屬性僅用于定義當前模型允許寫入的字段，而`type`屬性則僅用于定義數據字段的類型強制轉換。 ``` <?php namespace app\index\model; use think\Model; class User extends Model { protected $schema = [ 'id' => 'int', 'name' => 'string', 'score' => 'float', 'create_time' => 'datetime', 'update_time' => 'datetime', 'delete_time' => 'datetime', ]; } ``` ### 模型延遲保存機制 模型增加延遲保存方法`lazySave`，調用該方法后不會馬上保存數據，僅僅是保存在內存中，當前模型對象銷毀的時候或者下次顯式調用`save`方法的時候都會自動保存到數據庫。 ``` $user = User::find(1); $user->name = 'thinkphp'; $user->lazySave(); ... $user->score = 100; $user->save(); ``` ### `join`系列方法增加參數綁定支持 `join`方法（包括`leftJoin`/`rightJoin`/`fullJoin`方法）支持手動參數綁定。 ### 增加`tableRaw`方法 增加`tableRaw`方法使用表達式方法定義當前查詢的數據表。 ### 查詢緩存支持閉包情況 改進查詢緩存方法支持使用閉包查詢的情況。 ### 增加`withAttrs`方法 由于參數強制類型的關系，`withAttr`方法不支持傳入數組，必須使用`withAttrs`方法傳入數組批量設置字段獲取器。 ## 廢棄功能和方法 廢棄了一些目前已經很少用到或者不建議使用的功能，以及對容易混淆的一個功能多個用法進行了統一。 ### 數據分表功能 取消了數據庫分表功能，建議直接使用數據庫的分區功能替代，更靈活和性能更好，同時取消了`Query`類的`getPartitionTableName`和`partition`方法。 ### 取消了`get`/`all`方法 無論使用`Db`類還是模型類查詢，全部統一使用`find`/`select`方法，取消了之前模型類額外提供的`get`/`all`方法。 ### 取消`findOrEmpty`方法 取消了Query類的`findOrEmpty`方法，當模型使用`find`方法查詢的時候，數據不存在自動返回一個空模型對象，無需再使用`findOrEmpty`方法了。 ### 取消`relation`方法 取消了Query類的`relation`方法，模型的關聯獲取直接使用關聯屬性方式惰性獲取。 ### 取消了`readMaster`方法 取消了Query類和模型類的`readMater`方法，由于該方法使用了靜態屬性容易導致Swoole等常駐內存的環境下讀取錯亂。需要的時候可以用`master`方法手動切換主庫讀取。 ### 取消`fetchPdo`方法 取消了Query類的`fetchPdo`方法，需要的時候直接使用`getPdo`方法替代。 ### 取消查詢方法傳入`Query`對象 取消Query類的CURD查詢方法傳入當前對象，如果需要請使用閉包替代。 ### 取消全局查詢范圍`base`方法 取消模型類的全局查詢范圍`base`方法，改由使用`globalScope`屬性定義（數組）需要全局查詢的查詢范圍方法。或者在`db($scope)`方法中傳入全局查詢范圍。如果是靜態查詢，可以使用`useGlobalScope($scope)`。 ### 取消`db`和`model`助手函數 這兩個助手函數`5.1`版本已經不再建議使用了，新版直接廢棄掉這兩個助手函數，請指教使用`\think\facade\Db`類和實際的模型類調用。 ### 取消`setInc`/`setDec`方法 取消Query類的`setInc`/`setDec`方法，統一使用`inc`/`dec`方法替代，同時改進了`inc`/`dec`方法支持延時更新。 ## 取消`setField`方法 取消Query類的`setField`方法，請直接使用`data`方法或者`update`方法。 ### 取消`__TABLE_NAME__`支持 `table`方法取消`__TABLE_NAME__`支持，必須明確調用完整表名或者使用`name`方法。 ### 取消`whereOr`等方法傳入`Query`對象 除了`where`方法本身可以傳入`Query`對象外，其它的所有`where`查詢方法（例如`whereOr`/`whereExp`等）都不再支持傳入`Query`對象。 ### 取消`resultset_type`配置參數 數據集查詢結果不再受`resultset_type`配置參數影響，默認情況下，Db查詢統一返回數組，模型查詢統一返回模型對象和模型數據集對象。如果Db查詢的時候也需要返回數據集的話，可以顯式調用`fetchCollection`方法。 ### `with`方法和`withJoin`獨立 無需在模型關聯方法中定義是否使用JOIN查詢，只有在明確調用`withJoin`的時候才會使用JOIN查詢。