模型数据的新增和数据库的新增数据有所区别 数据库的新增只是单纯的写入给定的数据 而模型的数据写入会包含修改器、自动完成以及模型事件等环节

添加一条数据

实例化模型对象后赋值并保存

$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'=>'think','email' =>'think@qq.com']);

或直接在实例化时候传入

$user = new User(['name'=>'think','email' =>'think@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 = 'think';
$user->email  = 'think@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'=>'think','email'=>'think@qq.com']);
echo $user->name;
echo $user->email;
echo $user->id; // 获取自增ID

create返回的是当前模型的对象实例

create第二个参数可传入允许写入的字段列表（true则表示仅允许写入数据表定义的字段数据）

// 只允许写入name和email字段的数据
$user = User::create(['name'=>'think','email'=>'think@qq.com'], ['name','email']);
echo $user->name;
echo $user->email;
echo $user->id; // 获取自增ID

V5.1.14+ 支持replace操作

$user = User::create(['name'=>'think','email'=>'think@qq.com'], ['name','email'], true);

最佳实践

新增数据的最佳实践原则
使用create方法新增数据
使用saveAll批量新增数据