企业🤖AI Agent构建引擎,智能编排和调试,一键部署,支持私有化部署方案 广告
## 添加一条数据 可以使用`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条数据。