# 更新数据
## 更新数据
```
Db::name('user')
->where('id', 1)
->update(['name' => 'thinkphp']);
```
实际生成的SQL语句可能是:
```
UPDATE `think_user` SET `name`='thinkphp' WHERE `id` = 1
```
> update 方法返回影响数据的条数,没修改任何数据返回 0
支持使用`data`方法传入要更新的数据
```
Db::name('user')
->where('id', 1)
->data(['name' => 'thinkphp'])
->update();
```
> 如果`update`方法和`data`方法同时传入更新数据,则会进行合并。
如果数据中包含主键,可以直接使用:
```
Db::name('user')
->update(['name' => 'thinkphp','id'=>1]);
```
实际生成的SQL语句和前面用法是一样的:
```
UPDATE `think_user` SET `name`='thinkphp' WHERE `id` = 1
```
如果要更新的数据需要使用`SQL`函数或者其它字段,可以使用下面的方式:
```
Db::name('user')
->where('id',1)
->inc('read_time')
->dec('score',3)
->exp('name','UPPER(name)')
->update();
```
实际生成的SQL语句:
```
UPDATE `think_user` SET `read_time` = `read_time` + 1 , `score` = `score` - 3 , `name` = UPPER(name) WHERE `id` = 1
```
`V5.1.7+`版本以后,支持使用`raw`方法进行数据更新,适合在数组更新的情况。
```
Db::name('user')
->where('id', 1)
->update([
'name'=>Db::raw('UPPER(name)'),
'score'=>Db::raw('score-3'),
'read_time'=>Db::raw('read_time+1')
]);
```
## 更新字段值
```
Db::name('user')
->where('id',1)
->setField('name', 'thinkphp');
```
最终生成的SQL语句可能如下:
```
UPDATE `think_user` SET `name` = 'thinkphp' WHERE `id` = 1
```
> setField 方法返回影响数据的条数,没修改任何数据字段返回 0
可以使用`setInc/setDec`方法自增或自减一个字段的值( 如不加第二个参数,默认步长为1)。
```
// score 字段加 1
Db::table('think_user')
->where('id', 1)
->setInc('score');
// score 字段加 5
Db::table('think_user')
->where('id', 1)
->setInc('score', 5);
// score 字段减 1
Db::table('think_user')
->where('id', 1)
->setDec('score');
// score 字段减 5
Db::table('think_user')
->where('id', 1)
->setDec('score', 5);
```
最终生成的SQL语句可能是:
```
UPDATE `think_user` SET `score` = `score` + 1 WHERE `id` = 1
UPDATE `think_user` SET `score` = `score` + 5 WHERE `id` = 1
UPDATE `think_user` SET `score` = `score` - 1 WHERE `id` = 1
UPDATE `think_user` SET `score` = `score` - 5 WHERE `id` = 1
```
`setInc/setDec`支持延时更新,如果需要延时更新则传入第三个参数,下例中延时10秒更新。
```
Db::name('user')->where('id', 1)->setInc('score', 1, 10);
```
> setInc/setDec 方法返回影响数据的条数,如果使用了延迟更新的话,可能会返回true