新增

新增数据有多种方式。

添加一条数据

第一种是实例化模型对象后赋值并保存：

$user           = new User;
$user->name     = "thinkphp";
$user->email    = "thinkphp@qq.com";
$user->save();

也可以使用data方法批量赋值：

$user = new User;
$user->data([
    "name"  =>  "thinkphp",
    "email" =>  "thinkphp@qq.com"
]);
$user->save();

或者直接在实例化的时候传入数据

$user = new User([
    "name"  =>  "thinkphp",
    "email" =>  "thinkphp@qq.com"
]);
$user->save();

如果需要过滤非数据表字段的数据，可以使用：

$user = new User($_POST);
// 过滤post数组中的非数据表字段数据
$user->allowField(true)->save();

如果你通过外部提交赋值给模型，并且希望指定某些字段写入，可以使用：

$user = new User($_POST);
// post数组中只有name和email字段会写入
$user->allowField(["name","email"])->save();

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;
$user->name     = "thinkphp";
$user->email    = "thinkphp@qq.com";
$user->save();
$user->name     = "onethink";
$user->email    = "onethink@qq.com";
// 第二次开始必须使用下面的方式新增
$user->isUpdate(false)->save();

添加多条数据

支持批量新增，可以使用：

$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方法返回的是当前模型的对象实例。

助手函数

系统提供了model助手函数用于快速实例化模型，并且使用单例实现，例如：

// 使用model助手函数实例化User模型
$user = model("User");
// 模型对象赋值
$user->data([
    "name"  =>  "thinkphp",
    "email" =>  "thinkphp@qq.com"
]);
$user->save();

或者进行批量新增：

$user = model("User");
// 批量新增
$list = [
    ["name"=>"thinkphp","email"=>"thinkphp@qq.com"],
    ["name"=>"onethink","email"=>"onethink@qq.com"]
];
$user->saveAll($list);