模型數據的新增和數據庫的新增數據有所區別，數據庫的新增只是單純的寫入給定的數據，而模型的數據寫入會包含修改器、自動完成以及模型事件等環節，數據庫的數據寫入參考查詢構造器[新增數據](%E6%96%B0%E5%A2%9E%E6%95%B0%E6%8D%AE.md)章節。 ## 添加一條數據 第一種是實例化模型對象后賦值并保存： ~~~ $user = new User; $user->name = 'thinkphp'; $user->email = 'thinkphp@qq.com'; $user->save(); ~~~ > `save`方法成功會返回`true`，并且只有當`before_insert`事件返回`false`的時候返回`false`，一旦有錯誤就會拋出異常。所以無需判斷返回類型。 也可以直接傳入數據到`save`方法批量賦值： ~~~ $user = new User; $user->save([ 'name' => 'thinkphp', 'email' => 'thinkphp@qq.com' ]); ~~~ 默認只會寫入數據表已有的字段，如果你通過外部提交賦值給模型，并且希望指定某些字段寫入，可以使用： ~~~ $user = new User; // post數組中只有name和email字段會寫入 $user->allowField(['name','email'])->save($_POST); ~~~ 最佳的建議是模型數據賦值之前就進行數據過濾，例如： ~~~ $user = new User; // 過濾post數組中的非數據表字段數據 $data = Request::only(['name','email']); $user->save($data); ~~~ >[danger] `save`方法新增數據返回的是寫入的記錄數（通常是`1`），而不是自增主鍵值。 ## `Replace`寫入 `save`方法可以支持`replace`寫入。 ~~~ $user = new User; $user->name = 'thinkphp'; $user->email = 'thinkphp@qq.com'; $user->replace()->save(); ~~~ ## 獲取自增ID 如果要獲取新增數據的自增ID，可以使用下面的方式： ~~~ $user = new User; $user->name = 'thinkphp'; $user->email = 'thinkphp@qq.com'; $user->save(); // 獲取自增ID echo $user->id; ~~~ 這里其實是獲取模型的主鍵，如果你的主鍵不是`id`，而是`user_id`的話，其實獲取自增ID就變成這樣： ~~~ $user = new User; $user->name = 'thinkphp'; $user->email = 'thinkphp@qq.com'; $user->save(); // 獲取自增ID echo $user->user_id; ~~~ >[danger] 不要在同一個實例里面多次新增數據，如果確實需要多次新增，可以使用后面的靜態方法處理。 ## 批量增加數據 支持批量新增，可以使用： ~~~ $user = new User; $list = [ ['name'=>'thinkphp','email'=>'thinkphp@qq.com'], ['name'=>'onethink','email'=>'onethink@qq.com'] ]; $user->saveAll($list); ~~~ > saveAll方法新增數據返回的是包含新增模型（帶自增ID）的數據集對象。 `saveAll`方法新增數據默認會自動識別數據是需要新增還是更新操作，當數據中存在主鍵的時候會認為是更新操作。 ## 靜態方法 還可以直接靜態調用`create`方法創建并寫入： ~~~ $user = User::create([ 'name' => 'thinkphp', 'email' => 'thinkphp@qq.com' ]); echo $user->name; echo $user->email; echo $user->id; // 獲取自增ID ~~~ > 和`save`方法不同的是，`create`方法返回的是當前模型的對象實例。 `create`方法默認會過濾不是數據表的字段信息，可以在第二個參數可以傳入允許寫入的字段列表，例如： ~~~ // 只允許寫入name和email字段的數據 $user = User::create([ 'name' => 'thinkphp', 'email' => 'thinkphp@qq.com' ], ['name', 'email']); echo $user->name; echo $user->email; echo $user->id; // 獲取自增ID ~~~ 支持`replace`操作，使用下面的方法： ~~~ $user = User::create([ 'name' => 'thinkphp', 'email' => 'thinkphp@qq.com' ], ['name','email'], true); ~~~ ## 最佳實踐 >[info] 新增數據的最佳實踐原則：使用`create`方法新增數據，使用`saveAll`批量新增數據。 >