攏簍2攏漏祿霉麓隆虜脵脳梅 · tp5文檔

完成基本的模型定義后，我們就可以進行基礎的模型操作了，我們來領略下模型的對象化操作的魅力，主要內容包含： - - [新增數據](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/147285#u65B0u589Eu6570u636E) - [批量新增](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/147285#u6279u91CFu65B0u589E) - [查詢數據](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/147285#u67E5u8BE2u6570u636E) - [數據列表](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/147285#u6570u636Eu5217u8868) - [更新數據](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/147285#u66F4u65B0u6570u636E) - [刪除數據](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/147285#u5220u9664u6570u636E) ## 新增數據我們先來看下如何寫入模型數據，創建一個`User`控制器并增加`add`操作方法如下： ``` <pre class="calibre18"> ``` <?phpnamespace app\index\controller; use app\index\model\User as UserModel; class User{ // 新增用戶數據public function add(){ $user = new UserModel; $user->nickname = '流年'; $user->email = 'thinkphp@qq.com'; $user->birthday = strtotime('1977-03-05'); if ($user->save()) { return '用戶[ ' . $user->nickname . ':' . $user->id . ' ]新增成功'; } else { return $user->getError(); } } } ``` ``` > ### 提示： > > - - - - - - > > 在當前文件中給`app\index\model\User`模型定義了一個別名`UserModel`是為了避免和當前的`app\index\controller\User`產生沖突，如果你當前的控制器類不是`User`的話可以不需要定義`UserModel`別名。有一種方式可以讓你省去別名定義，系統支持統一對控制器類添加`Controller`后綴，修改配置參數： ``` <pre class="calibre18"> ``` // 是否啟用控制器類后綴'controller_suffix' => true, ``` ``` 然后，控制器類文件改為`UserController.php`，并且修改控制器類的定義如下： ``` <pre class="calibre18"> ``` <?phpnamespace app\index\controller; use app\index\model\User; class UserController{ // 新增用戶數據public function add(){ $user = new User; $user->nickname = '流年'; $user->email = 'thinkphp@qq.com'; $user->birthday = strtotime('1977-03-05'); if ($user->save()) { return '用戶[ ' . $user->nickname . ':' . $user->id . ' ]新增成功'; } else { return $user->getError(); } } } ``` ``` 接下來，我們訪問 ``` <pre class="calibre18"> ``` http://tp5.com/user/add ``` ``` 如果看到輸出 ``` <pre class="calibre18"> ``` 用戶[ 流年:1 ]新增成功 ``` ``` 表示用戶模型寫入成功了。默認情況下，實例化模型類后執行`save`操作都是執行的數據庫`insert`操作，如果你需要實例化執行`save`執行數據庫的`update`操作，請確保在save方法之前調用`isUpdate`方法： ``` <pre class="calibre18"> ``` $user->isUpdate()->save(); ``` ``` 如果你覺得上面的方式給`User`對象一個個賦值太麻煩，可以改為下面的方式： ``` <pre class="calibre18"> ``` // 新增用戶數據public function add(){ $user['nickname'] = '看云'; $user['email'] = 'kancloud@qq.com'; $user['birthday'] = strtotime('2015-04-02'); if ($result = UserModel::create($user)) { return '用戶[ ' . $result->nickname . ':' . $result->id . ' ]新增成功'; } else { return '新增出錯'; } } ``` ``` `create`方法可以傳入數組或者標準對象，你可以在外部統一賦值后傳入，當然也可以直接傳入表單數據（我們后面會有專門的描述）。我們刷新剛才的訪問地址后，頁面輸出結果為： ``` <pre class="calibre18"> ``` 用戶[ 看云:2 ]新增成功 ``` ``` ## 批量新增也可以直接進行數據的批量新增，給控制器添加如下`addList`操作方法： ``` <pre class="calibre18"> ``` // 批量新增用戶數據public function addList(){ $user = new UserModel; $list = [ ['nickname' => '張三', 'email' => 'zhanghsan@qq.com', 'birthday' => strtotime('1988-01-15')], ['nickname' => '李四', 'email' => 'lisi@qq.com', 'birthday' => strtotime('1990-09-19')], ]; if ($user->saveAll($list)) { return '用戶批量新增成功'; } else { return $user->getError(); } } ``` ``` 訪問URL地址 ``` <pre class="calibre18"> ``` http: //tp5.com/user/add_list ``` ``` 最后的輸出結果為： ``` <pre class="calibre18"> ``` 用戶批量新增成功 ``` ``` ## 查詢數據接下來添加`User`模型的查詢功能，給`User`控制器增加如下`read`操作方法： ``` <pre class="calibre18"> ``` // 讀取用戶數據public function read($id=''){ $user = UserModel::get($id); echo $user->nickname . ' '; echo $user->email . ' '; echo date('Y/m/d', $user->birthday) . ' '; } ``` ``` 模型的`get`方法用于獲取數據表的數據并返回當前的模型對象實例，通常只需要傳入主鍵作為參數，如果沒有傳入任何值的話，則表示獲取第一條數據。訪問如下URL地址 ``` <pre class="calibre18"> ``` http: //tp5.com/user/1 ``` ``` 輸出結果是： ``` <pre class="calibre18"> ``` 流年 thinkphp@qq.com 1977/03/05 ``` ``` 訪問如下URL地址 ``` <pre class="calibre18"> ``` http: //tp5.com/user/2 ``` ``` 輸出結果是： ``` <pre class="calibre18"> ``` 看云 kancloud@qq.com 2016/04/02 ``` ``` 模型的`get`方法和`Db`類的`find`方法返回結果的區別在于，`Db`類默認返回的只是數組（注意這里說的默認，其實仍然可以設置為對象），而模型的`get`方法查詢返回的一定是當前的模型對象實例。但是系統為模型實現了`ArrayAccess`接口，因此仍然可以通過數組的方式訪問對象實例，把控制器的`read`操作方法改成如下： ``` <pre class="calibre18"> ``` // 讀取用戶數據public function read($id = ''){ $user = UserModel::get($id); echo $user['nickname'] . ' '; echo $user['email'] . ' '; echo date('Y/m/d', $user['birthday']) . ' '; } ``` ``` 再次訪問URL地址 ``` <pre class="calibre18"> ``` http: //tp5.com/user/1 ``` ``` 不但沒有報錯，而且最終的輸出結果和之前是一樣的： ``` <pre class="calibre18"> ``` 流年 thinkphp@qq.com 1977/03/05 ``` ``` 如果我想通過用戶的`email`來查詢模型數據的話，應該如何操作呢？下面是一個查詢的例子： ``` <pre class="calibre18"> ``` // 根據email讀取用戶數據public function read(){ $user = UserModel::getByEmail('thinkphp@qq.com'); echo $user->nickname . ' '; echo $user->email . ' '; echo date('Y/m/d', $user->birthday) . ' '; } ``` ``` 輸出的結果是： ``` <pre class="calibre18"> ``` 流年 thinkphp@qq.com 1977/03/05 ``` ``` 如果不是根據主鍵查詢的話，可以傳入數組作為查詢條件，例如： ``` <pre class="calibre18"> ``` // 根據nickname讀取用戶數據public function read(){ $user = UserModel::get(['nickname'=>'流年']); echo $user->nickname . ' '; echo $user->email . ' '; echo date('Y/m/d', $user->birthday) . ' '; } ``` ``` 更復雜的查詢則可以使用查詢構建器來完成，例如： ``` <pre class="calibre18"> ``` // 根據nickname讀取用戶數據public function read(){ $user = UserModel::where('nickname', '流年')->find(); echo $user->nickname . ' '; echo $user->email . ' '; echo date('Y/m/d', $user->birthday) . ' '; } ``` ``` ## 數據列表如果要查詢多個數據，可以使用模型的`all`方法，我們在控制器中添加index操作方法用于獲取用戶列表： ``` <pre class="calibre18"> ``` // 獲取用戶數據列表public function index(){ $list = UserModel::all(); foreach ($list as $user) { echo $user->nickname . ' '; echo $user->email . ' '; echo date('Y/m/d', $user->birthday) . ' '; echo '---------------------------------- '; } } ``` ``` 然后訪問 ``` <pre class="calibre18"> ``` http: //tp5.com/user/index ``` ``` 就可以看到輸出結果為： ``` <pre class="calibre18"> ``` 流年 thinkphp@qq.com 1977/03/05 ------------------------------------- 看云 kancloud@qq.com 2015/04/02 ------------------------------------- 張三 zhanghsan@qq.com 1988/01/15 ------------------------------------- 李四 lisi@qq.com 1990/09/19 ------------------------------------- ``` ``` 如果不是使用主鍵查詢，可以直接傳入數組條件查詢，例如： ``` <pre class="calibre18"> ``` // 獲取用戶數據列表public function index(){ $list = UserModel::all(['status'=>1]); foreach ($list as $user) { echo $user->nickname . ' '; echo $user->email . ' '; echo date('Y/m/d', $user->birthday) . ' '; echo '---------------------------------- '; } } ``` ``` 我們也可以使用數據庫的查詢構建器完成更多的條件查詢，例如： ``` <pre class="calibre18"> ``` // 獲取用戶數據列表public function index(){ $list = UserModel::where('id','<',3)->select(); foreach ($list as $user) { echo $user->nickname . ' '; echo $user->email . ' '; echo date('Y/m/d', $user->birthday) . ' '; echo '---------------------------------- '; } } ``` ``` 刷新頁面訪問輸出的結果是： ``` <pre class="calibre18"> ``` 流年 thinkphp@qq.com 1977/03/05 ------------------------------------- 看云 kancloud@qq.com 2015/04/02 ------------------------------------- ``` ``` ## 更新數據我們可以對查詢出來的數據進行更新操作，下面添加一個`update`操作方法： ``` <pre class="calibre18"> ``` // 更新用戶數據public function update($id){ $user = UserModel::get($id); $user->nickname = '劉晨'; $user->email = 'liu21st@gmail.com'; if (false !== $user->save()) { return '更新用戶成功'; } else { return $user->getError(); } } ``` ``` 訪問下面的URL地址 ``` <pre class="calibre18"> ``` http: //tp5.com/user/update/1 ``` ``` 會輸出 ``` <pre class="calibre18"> ``` 更新用戶成功 ``` ``` 然后我們再次訪問 ``` <pre class="calibre18"> ``` http: //tp5.com/user/1 ``` ``` 會看到輸出結果變成： ``` <pre class="calibre18"> ``` 劉晨 liu21st@gmail.com 1977/03/05 ``` ``` 說明我們的更新操作已經生效了。默認情況下，查詢模型數據后返回的模型示例執行`save`操作都是執行的數據庫`update`操作，如果你需要實例化執行`save`執行數據庫的`insert`操作，請確保在save方法之前調用`isUpdate`方法： ``` <pre class="calibre18"> ``` $user->isUpdate(false)->save(); ``` ``` `ActiveRecord`模式的更新數據方式需要首先讀取對應的數據，如果需要更高效的方法可以把update方法改成： ``` <pre class="calibre18"> ``` // 更新用戶數據public function update($id){ $user['id'] = (int) $id; $user['nickname'] = '劉晨'; $user['email'] = 'liu21st@gmail.com'; $result = UserModel::update($user); if (false !== $result) { return '更新用戶成功'; } else { return $user->getError(); } } ``` ``` ## 刪除數據我們給User控制器添加delete方法用于刪除用戶。 ``` <pre class="calibre18"> ``` // 刪除用戶數據public function delete($id){ $user = UserModel::get($id); if ($user) { $user->delete(); return '刪除用戶成功'; } else { return '刪除的用戶不存在'; } } ``` ``` 然后訪問 ``` <pre class="calibre18"> ``` http: //tp5.com/user/delete/1 ``` ``` 輸出結果為： ``` <pre class="calibre18"> ``` 刪除用戶成功 ``` ``` 如果刷新頁面后輸出結果為： ``` <pre class="calibre18"> ``` 刪除的用戶不存在 ``` ``` 同樣我們也可以直接使用`destroy`方法刪除模型數據，例如把上面的`delete`方法改成如下： ``` <pre class="calibre18"> ``` // 刪除用戶數據public function delete($id){ $result = UserModel::destroy($id); if ($result) { return '刪除用戶成功'; } else { return '刪除的用戶不存在'; } } ``` ``` 目前為止，你已經掌握了最基本的模型操作，后面會引申一些高級的用法。