模型数据的新增和数据库的新增数据有所区别,数据库的新增只是单纯的写入给定的数据,而模型的数据写入会包含修改器、自动完成以及模型事件等环节,数据库的数据写入参考数据库章节。 ## 添加一条数据 第一种是实例化模型对象后赋值并保存: ~~~ $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(); ~~~ >[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`批量新增数据。 >