## 添加一条数据
可以使用`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条数据。
- 简介
- 数据库配置
- 分布式数据库
- 查询构造器
- 查询数据
- 新增数据
- 更新数据
- 删除数据
- 链式操作
- Where
- Table
- Alias
- Field
- Strict
- Limit
- Page
- Order
- Group
- Having
- Join
- Union
- Distinct
- Lock
- Cache
- Comment
- FetchSql
- Force
- Partition
- Replace
- FailException
- Extra
- Duplicate
- Sequence
- Procedure
- View
- 聚合查询
- 分页查询
- 时间查询
- 高级查询
- 子查询
- 原生查询
- 事务操作
- 存储过程
- 查询事件
- JSON字段
- 模型
- 定义
- 新增
- 更新
- 删除
- 查询
- 查询范围
- 只读字段
- JSON字段
- 自动时间写入
- 获取器
- 修改器
- 搜索器
- 类型转换
- 模型输出
- 模型事件
- 虚拟模型
- 关联
- 一对一关联
- 一对多关联
- 远程一对多
- 远程一对一
- 多对多关联
- 多态一对多
- 多态一对一
- 关联预载入
- 关联统计
- 关联输出
- SQL监听
- 缓存机制
- 字段缓存
- 查询缓存
- 扩展
- 自定义查询类
- 自定义数据库驱动