# 新增 模型數據的新增和數據庫的新增數據有所區別，數據庫的新增只是單純的寫入給定的數據，而模型的數據寫入會包含修改器、自動完成以及模型事件等環節，數據庫的數據寫入參考數據庫章節。 ## 添加一條數據 第一種是實例化模型對象后賦值并保存： ``` $user = new User; $user->name = 'thinkphp'; $user->email = 'thinkphp@qq.com'; $user->save(); ``` > `save`方法返回影響的記錄數，并且只有當`before_insert`事件返回`false`的時候返回`false` 也可以直接傳入數據到`save`方法批量賦值： ``` $user = new User; $user->save([ 'name' => 'thinkphp', 'email' => 'thinkphp@qq.com' ]); ``` 或者直接在實例化的時候傳入數據 ``` $user = new User([ 'name' => 'thinkphp', 'email' => 'thinkphp@qq.com' ]); $user->save(); ``` > 實例化傳入的模型數據也不會經過修改器處理。 如果需要過濾非數據表字段的數據，可以使用： ``` $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); ``` > `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; ``` > 不要在同一個實例里面多次新增數據，如果確實需要多次新增，可以使用后面的靜態方法處理。 ## 添加多條數據 支持批量新增，可以使用： ``` $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); ``` ## 最佳實踐 > 新增數據的最佳實踐原則：使用`create`方法新增數據，使用`saveAll`批量新增數據。