1.查询单个数据
查询单个数据使用find
方法:
// table方法必须指定完整的数据表名
Db::table('think_user')->where('id', 1)->find();
最终生成的SQL语句可能是:
SELECT * FROM `think_user` WHERE `id` = 1 LIMIT 1
find
方法查询结果不存在,返回null
,否则返回结果数组
如果希望查询数据不存在的时候返回空数组,可以使用
// table方法必须指定完整的数据表名
Db::table('think_user')->where('id', 1)->findOrEmpty();
如果希望在没有找到数据后抛出异常可以使用
Db::table('think_user')->where('id', 1)->findOrFail();
如果没有查找到数据,则会抛出一个think\db\exception\DataNotFoundException
异常。
如果没有任何的查询条件 并且也没有调用
order
方法的话 ,find
查询不会返回任何结果。
2.查询数据集
查询多个数据(数据集)使用select
方法:
Db::table('think_user')->where('status', 1)->select();
最终生成的SQL语句可能是:
SELECT * FROM `think_user` WHERE `status` = 1
select
方法查询结果是一个数据集对象,如果需要转换为数组可以使用
Db::table('think_user')->where('status', 1)->select()->toArray();
如果希望在没有查找到数据后抛出异常可以使用
Db::table('think_user')->where('status',1)->selectOrFail();
如果没有查找到数据,同样也会抛出一个think\db\exception\DataNotFoundException
异常。
如果在select查询
如果设置了数据表前缀参数的话,可以使用
Db::name('user')->where('id', 1)->find();
Db::name('user')->where('status', 1)->select();
如果你的数据表没有设置表前缀的话,那么
name
和table
方法效果一致。
在find
和select
方法之前可以使用所有的链式操作(参考链式操作章节)方法。
3.值和列查询
查询某个字段的值可以用
// 返回某个字段的值
Db::table('think_user')->where('id', 1)->value('name');
value 方法查询结果不存在,返回 null
查询某一列的值可以用
// 返回数组
Db::table('think_user')->where('status',1)->column('name');
// 指定id字段的值作为索引
Db::table('think_user')->where('status',1)->column('name', 'id');
如果要返回完整数据,并且添加一个索引值的话,可以使用
// 指定id字段的值作为索引 返回所有数据
Db::table('think_user')->where('status',1)->column('*','id');
column
方法查询结果不存在,返回空数组
4.数据分批处理
如果你需要处理成千上百条数据库记录,可以考虑使用chunk
方法,该方法一次获取结果集的一小块,然后填充每一小块数据到要处理的闭包,该方法在编写处理大量数据库记录的时候非常有用。
比如,我们可以全部用户表数据进行分批处理,每次处理 100 个用户记录:
Db::table('think_user')->chunk(100, function($users) {
foreach ($users as $user) {
//
}
});
你可以通过从闭包函数中返回false
来中止对后续数据集的处理:
Db::table('think_user')->chunk(100, function($users) {
foreach ($users as $user) {
// 处理结果集...
if($user->status==0){
return false;
}
}
});
也支持在chunk
方法之前调用其它的查询方法,例如:
Db::table('think_user')
->where('score','>',80)
->chunk(100, function($users) {
foreach ($users as $user) {
//
}
});
chunk
方法的处理默认是根据主键查询,支持指定字段,例如:
Db::table('think_user')->chunk(100, function($users) {
// 处理结果集...
return false;
},'create_time');
并且支持指定处理数据的顺序。
Db::table('think_user')->chunk(100, function($users) {
// 处理结果集...
return false;
},'create_time', 'desc');
chunk
方法一般用于命令行操作批处理数据库的数据,不适合WEB访问处理大量数据,很容易导致超时。
5.游标查询
如果你需要处理大量的数据,可以使用新版提供的游标查询功能,该查询方式利用了PHP的生成器特性,可以大幅减少大量数据查询的内存开销问题。
$cursor = Db::table('user')->where('status', 1)->cursor();
foreach($cursor as $user){
echo $user['name'];
}
cursor
方法返回的是一个生成器对象,user
变量是数据表的一条数据(数组)。
6.添加一条数据
可以使用save
方法统一写入数据,自动判断是新增还是更新数据(以写入数据中是否存在主键数据为依据)。
$data = ['foo' => 'bar', 'bar' => 'foo'];
Db::name('user')->save($data);
或者使用 insert
方法向数据库提交数据
$data = ['foo' => 'bar', 'bar' => 'foo'];
Db::name('user')->insert($data);
insert
方法添加数据成功返回添加成功的条数,通常情况返回 1
如果你的数据表里面没有
foo
或者bar
字段,那么就会抛出异常。
如果不希望抛出异常,可以使用下面的方法:
$data = ['foo' => 'bar', 'bar' => 'foo'];
Db::name('user')->strict(false)->insert($data);
不存在字段的值将会直接抛弃。
如果是mysql数据库,支持replace
写入,例如:
$data = ['foo' => 'bar', 'bar' => 'foo'];
Db::name('user')->replace()->insert($data);
添加数据后如果需要返回新增数据的自增主键,可以使用insertGetId
方法新增数据并返回主键值:
$userId = Db::name('user')->insertGetId($data);
insertGetId
方法添加数据成功返回添加数据的自增主键
7.添加多条数据
添加多条数据直接向 Db 类的 insertAll
方法传入需要添加的数据(通常是二维数组)即可。
$data = [
['foo' => 'bar', 'bar' => 'foo'],
['foo' => 'bar1', 'bar' => 'foo1'],
['foo' => 'bar2', 'bar' => 'foo2']
];
Db::name('user')->insertAll($data);
insertAll
方法添加数据成功返回添加成功的条数
如果是mysql数据库,支持replace
写入,例如:
$data = [
['foo' => 'bar', 'bar' => 'foo'],
['foo' => 'bar1', 'bar' => 'foo1'],
['foo' => 'bar2', 'bar' => 'foo2']
];
Db::name('user')->replace()->insertAll($data);
确保要批量添加的数据字段是一致的
如果批量插入的数据比较多,可以指定分批插入,使用limit
方法指定每次插入的数量限制。
$data = [
['foo' => 'bar', 'bar' => 'foo'],
['foo' => 'bar1', 'bar' => 'foo1'],
['foo' => 'bar2', 'bar' => 'foo2']
...
];
// 分批写入 每次最多100条数据
Db::name('user')
->limit(100)
->insertAll($data);
8.更新数据
可以使用save方法更新数据
Db::name('user')
->save(['id' => 1, 'name' => 'thinkphp']);
复制
或者使用update
方法。
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
方法同时传入更新数据,则以update
方法为准。
如果数据中包含主键,可以直接使用:
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)
->exp('name','UPPER(name)')
->update();
实际生成的SQL语句:
UPDATE `think_user` SET `name` = UPPER(name) WHERE `id` = 1
支持使用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')
]);
9.自增/自减
可以使用inc/dec
方法自增或自减一个字段的值( 如不加第二个参数,默认步长为1)。
10.删除数据
// 根据主键删除
Db::table('think_user')->delete(1);
Db::table('think_user')->delete([1,2,3]);
// 条件删除
Db::table('think_user')->where('id',1)->delete();
Db::table('think_user')->where('id','<',10)->delete();
复制
最终生成的SQL语句可能是:
DELETE FROM `think_user` WHERE `id` = 1
DELETE FROM `think_user` WHERE `id` IN (1,2,3)
DELETE FROM `think_user` WHERE `id` = 1
DELETE FROM `think_user` WHERE `id` < 10
delete
方法返回影响数据的条数,没有删除返回 0
如果不带任何条件调用delete
方法会提示错误,如果你确实需要删除所有数据,可以使用
// 无条件删除所有数据
Db::name('user')->delete(true);
最终生成的SQL语句是(删除了表的所有数据):
DELETE FROM `think_user`
一般情况下,业务数据不建议真实删除数据,系统提供了软删除机制(模型中使用软删除更为方便)。
11.查询表达式
查询表达式支持大部分的SQL查询语法,也是ThinkPHP
查询语言的精髓,查询表达式的使用格式:
where('字段名','查询表达式','查询条件');
除了where
方法外,还可以支持whereOr
,用法是一样的。为了更加方便查询,大多数的查询表达式都提供了快捷查询方法。
表达式不分大小写,支持的查询表达式有下面几种:
表达式 | 含义 | 快捷查询方法 |
---|---|---|
= | 等于 | |
<> | 不等于 | |
> | 大于 | |
>= | 大于等于 | |
< | 小于 | |
<= | 小于等于 | |
[NOT] LIKE | 模糊查询 | whereLike/whereNotLike |
[NOT] BETWEEN | (不在)区间查询 | whereBetween/whereNotBetween |
[NOT] IN | (不在)IN 查询 | whereIn/whereNotIn |
[NOT] NULL | 查询字段是否(不)是NULL | whereNull/whereNotNull |
[NOT] EXISTS | EXISTS查询 | whereExists/whereNotExists |
[NOT] REGEXP | 正则(不)匹配查询(仅支持Mysql) | |
[NOT] BETWEEN TIME | 时间区间比较 | whereBetweenTime |
> TIME | 大于某个时间 | whereTime |
< TIME | 小于某个时间 | whereTime |
>= TIME | 大于等于某个时间 | whereTime |
<= TIME | 小于等于某个时间 | whereTime |
EXP | 表达式查询,支持SQL语法 | whereExp |
find in set | FIND_IN_SET查询 | whereFindInSet |