新增数据
最后更新于：2022-04-02 07:29:11
## 添加一条数据
可以使用`save`方法统一写入数据，自动判断是新增还是更新数据（以写入数据中是否存在主键数据为依据）。
~~~
$data = ['foo' => 'bar', 'bar' => 'foo'];
Db::name('user')->save($data);
~~~
如果你的数据中包含主键数据，可以传入第二个参数强制新增数据。
~~~
$data = ['id' => 1, 'foo' => 'bar', 'bar' => 'foo'];
Db::name('user')->save($data, true);
~~~
或者使用 `insert` 方法向数据库明确新增一条数据
~~~
$data = ['foo' => 'bar', 'bar' => 'foo'];
Db::name('user')->insert($data);
~~~
>[info] `insert` 或者`save`方法添加数据成功返回添加成功的条数，通常情况返回 1
默认情况下查询构造器使用严格模式，也就是说如果你的数据表里面没有`foo`或者`bar`字段，那么就会抛出异常。如果不希望抛出异常，可以通过下面的方法关闭严格模式：
~~~
$data = ['foo' => 'bar', 'bar' => 'foo'];
Db::name('user')->strict(false)->insert($data);
~~~
不存在字段的值将会直接抛弃。如果你希望全局关闭严格模式，那么可以修改数据库的配置参数
```
// 关闭严格模式
'fields_strict' => false
```
如果是MySQL数据库，支持`replace`方式写入，例如：
~~~
$data = ['foo' => 'bar', 'bar' => 'foo'];
Db::name('user')->replace()->insert($data);
~~~
如果你的数据表采用了自增主键，并且添加数据后如果需要返回新增数据的自增主键，可以使用`insertGetId`方法新增数据并返回主键值：
~~~
$userId = Db::name('user')->insertGetId($data);
~~~
>[info] `insertGetId` 方法添加数据成功返回添加数据的自增主键
## 添加多条数据
添加多条数据直接使用 `insertAll` 方法传入需要添加的数据（通常是二维数组）即可。
~~~
$data = [
['foo' => 'bar', 'bar' => 'foo'],
['foo' => 'bar1', 'bar' => 'foo1'],
['foo' => 'bar2', 'bar' => 'foo2']
];
Db::name('user')->insertAll($data);
~~~
>[info] `insertAll `方法添加数据成功返回添加成功的条数
如果是mysql数据库，支持`replace`写入，例如：
~~~
$data = [
['foo' => 'bar', 'bar' => 'foo'],
['foo' => 'bar1', 'bar' => 'foo1'],
['foo' => 'bar2', 'bar' => 'foo2']
];
Db::name('user')->replace()->insertAll($data);
~~~
>[danger] 确保要批量添加的数据字段是一致的
如果批量插入的数据比较多，可以指定分批插入，使用`limit`方法指定每次插入的数量限制。
~~~
$data = [
['foo' => 'bar', 'bar' => 'foo'],
['foo' => 'bar1', 'bar' => 'foo1'],
['foo' => 'bar2', 'bar' => 'foo2']
...
];
// 分批写入 每次最多1000条数据
Db::name('user')
->limit(1000)
->insertAll($data);
~~~
如果写入的数据量比较大，会自动分成多个语句执行写入，每次最多写入1000条数据。
';