### 2018 年 10 月 23 日 發布 發現很多開發者在使用ThinkPHP`5.*`的時候不明白`Db`和模型的正確使用姿勢，尤其是在`5.1`版本里面，如果你沒有使用下面的正確姿勢，有很大可能性會踩坑。 ## Db的正確姿勢 下面是官方推薦的`Db`類用法（也就是每次都是靜態方法調用） ``` // 查詢單個數據 Db::name('user')->where('id', 1)->find(); // 查詢多個數據 Db::name('user')->where('id', '>', 1)->select(); // 寫入新的數據 Db::name('user')->insert(['name' => '張三']); // 更新數據 Db::name('user')->where('id', 1)->update(['name' => '李四']); // 刪除數據 Db::name('user')->delete(1); ``` 很多開發者為了簡化代碼，喜歡使用下面的代碼。 >[danger]### 但是，永遠不要在`5.1`中使用下面的代碼！ ``` // 錯誤的用法 $user = Db::name('user'); // 查詢單個數據 $user->where('id', 1)->find(); // 查詢多個數據 $user->where('id', '>', 1)->select(); // 寫入新的數據 $user->insert(['name' => '張三']); // 更新數據 $user->update(['name' => '李四']); // 刪除數據 $user->delete(1); ``` >[danger]### 即便是使用助手函數仍然不建議！ ``` // 仍然是錯誤的用法 // 查詢單個數據 db('user')->where('id', 1)->find(); // 查詢多個數據 db('user')->where('id', '>', 1)->select(); // 寫入新的數據 db('user')->insert(['name' => '張三']); // 更新數據 db('user')->update(['name' => '李四']); // 刪除數據 db('user')->delete(1); ``` 很多開發者可能會奇怪，為什么是錯誤的用法呢？我使用的結果明明都沒問題啊？這只是說明你還沒踩坑罷了。 真正的原因，是`5.1`版本每次查詢后是不會清空前次（`5.0`則會每次清空）的查詢條件的，所以下面的用法是有效的。 ``` $user = Db::name('user'); // 查詢分數大于80分的用戶總數 $count = $user->where('score', '>', 80)->count(); // 查詢分數大于80分的用戶數據 $user->select(); ``` 看到這里你應該明白了，當你使用的是同一個數據庫查詢對象實例的話，查詢條件是始終會保留的（也就是會導致后面的查詢條件錯亂），而如果你使用助手函數或者手動實例化后多次操作都是相同的對象實例，除非你像下面一樣手動清除。 ``` $user = Db::name('user'); // 查詢分數大于80分的用戶總數 $count = $user->where('score', '>', 80)->count(); // 清除查詢條件（但不包括排序或者字段等信息） $user->removeOption('where'); // 查詢所有用戶數據 并按分數倒序排列 $user->order('score', 'desc')->select(); // 清除所有查詢條件 $user->removeOption(); // 查詢分數等于100的用戶 $user->where('score', 100)->select(); ``` >[danger]### 最佳實踐：**每次使用全新的`Db`靜態查詢** ## 模型的正確姿勢 模型的設計其實和`Db`一樣，基本上不需要手動進行實例化。 ``` // 寫入新的數據 $user = User::create(['name' => '張三']); // 更新數據 $user->update(['name' => '李四']); // 查詢單個數據 $user = User::get(1); // 刪除當前模型數據 $user->delete(); ``` 上面的代碼中，我們沒有使用任何的實例化代碼，都是使用靜態方法操作。模型的實例化工作是由系統在查詢或者寫入數據的時候自動完成的。如果你自己手動實例化模型的話，會造成模型的重復實例化開銷。 不建議的用法： ``` $user = new User; // 寫入新的數據 $user->name = '張三'; $user->save(); ``` ``` $user = new User; $user->find(1); echo $user->name; ``` 建議用法： ``` // 寫入新的數據 User::create(['name' => '張三']); ``` ``` $user = User::get(1); echo $user->name; ``` 所以，請不要手動實例化模型，也不建議使用`model`助手函數。 >[danger]### 最佳實踐：**模型查詢和創建都使用靜態方法** 現在，你明白Db類和模型使用的正確姿勢了么？