模型數據的新增和數據庫的新增數據有所區別，數據庫的新增只是單純的寫入給定的數據，而模型的數據寫入會包含修改器、自動完成以及模型事件等環節，數據庫的數據寫入參考數據庫章節。 ## 添加一條數據 第一種是實例化模型對象后賦值并保存： ~~~ $user = new User; $user->name = 'thinkphp'; $user->email = 'thinkphp@qq.com'; $user->save(); ~~~ > `save`方法返回影響的記錄數，并且只有當`before_insert`事件返回`false`的時候返回`false`，從`V5.1.6+`版本開始統一返回布爾值 也可以直接傳入數據到`save`方法批量賦值： ~~~ $user = new User; $user->save([ 'name' => 'thinkphp', 'email' => 'thinkphp@qq.com' ]); ~~~ 或者直接在實例化的時候傳入數據 ~~~ $user = new User([ 'name' => 'thinkphp', 'email' => 'thinkphp@qq.com' ]); $user->save(); ~~~ >[danger] 實例化傳入的模型數據也不會經過修改器處理。 如果需要過濾非數據表字段的數據，可以使用： ~~~ $user = new User; // 過濾post數組中的非數據表字段數據 $user->allowField(true)->save($_POST); ~~~ 如果你通過外部提交賦值給模型，并且希望指定某些字段寫入，可以使用： ~~~ $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`寫入 `V5.1.14+`版本開始，`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`方法新增數據默認會自動識別數據是需要新增還是更新操作，當數據中存在主鍵的時候會認為是更新操作，如果你需要帶主鍵數據批量新增，可以使用下面的方式： ~~~ $user = new User; $list = [ ['id'=>1, 'name'=>'thinkphp', 'email'=>'thinkphp@qq.com'], ['id'=>2, 'name'=>'onethink', 'email'=>'onethink@qq.com'], ]; $user->saveAll($list, false); ~~~ ## 靜態方法 還可以直接靜態調用`create`方法創建并寫入： ~~~ $user = User::create([ 'name' => 'thinkphp', 'email' => 'thinkphp@qq.com' ]); echo $user->name; echo $user->email; echo $user->id; // 獲取自增ID ~~~ > 和`save`方法不同的是，`create`方法返回的是當前模型的對象實例。 `create`方法的第二個參數可以傳入允許寫入的字段列表（傳入`true`則表示僅允許寫入數據表定義的字段數據），例如： ~~~ // 只允許寫入name和email字段的數據 $user = User::create([ 'name' => 'thinkphp', 'email' => 'thinkphp@qq.com' ], ['name', 'email']); echo $user->name; echo $user->email; echo $user->id; // 獲取自增ID ~~~ `V5.1.14+`版本開始，支持`replace`操作，使用下面的方法： ~~~ $user = User::create([ 'name' => 'thinkphp', 'email' => 'thinkphp@qq.com' ], ['name','email'], true); ~~~ ## 最佳實踐 >[info] 新增數據的最佳實踐原則：使用`create`方法新增數據，使用`saveAll`批量新增數據。 >