ThinkPHP 8 通过内置的数据库抽象层操作 MySQL 等数据库。官方手册《数据库》一章包含:配置与连接、查询构造器(其下又有链式查询、查询表达式、聚合查询、原生查询等子类)、事务支持。本文逐一整理,其中链式查询重点展开,结尾附综合小实例。参考:数据库、链式查询。
一、数据库配置与连接
连接信息在 config/database.php,核心配置项:
| 配置项 | 说明 |
|---|---|
type | 数据库类型(mysql、pgsql、sqlite…) |
hostname / hostport | 服务器地址与端口 |
database / username / password | 库名、账号、密码 |
prefix | 数据表前缀,name() 会自动补上 |
charset | 字符集(utf8mb4) |
break_reconnect | 断线重连 |
用 thinkfacadeDb 门面连接,name() 带前缀、table() 写完整表名:
use thinkfacadeDb;
Db::name('user'); // 实际表:tp_user
Db::table('tp_user'); // 完整表名
Db::connect($config); // 连接其它数据库
二、查询构造器总览
查询构造器用链式方法拼装 SQL,最后由触发方法执行:
Db::name('user')
->where('status', 1) // 链式:拼条件
->order('id desc') // 链式:拼排序
->limit(10) // 链式:拼限量
->select(); // 触发:执行查询
常用触发方法:find() 查一条、select() 查多条、insert()、update()、delete()。
三、链式查询详解
链式查询是查询构造器的核心,下面按用途分类详解。
1. 指定表与字段
Db::name('article')
->field('id, title, view') // 只查指定字段
->select();
Db::name('article')
->field(['id', 'title']) // 数组写法
->select();
2. 条件 where 的三种写法
// 写法1:等值简写
Db::name('user')->where('id', 10)->find();
// 写法2:字段/表达式/值 三段式
Db::name('user')->where('age', '>', 18)->select();
// 写法3:数组批量 + 闭包组合
Db::name('user')
->where(['status' => 1])
->where(function ($query) {
$query->whereLike('name', 'think%')
->whereOr('email', 'like', '%thinkphp.cn');
})
->select();
3. 排序、限量与分页
->order('id desc') // 单字段排序
->order(['create_time' => 'desc', 'id' => 'asc']) // 多字段排序
->limit(10) // 只取 10 条
->limit(5, 10) // 从第 5 条起取 10 条
->page(2, 10) // 第 2 页、每页 10 条
->paginate(10) // 分页对象(自带总条数)
4. 连表与别名
Db::name('article')->alias('a')
->join('menu m', 'a.menuid = m.id', 'LEFT')
->field('a.id, a.title, m.menuname')
->select();
// 多表联合结果
Db::name('a')->field('id')
->union('SELECT id FROM tp_b')
->select();
5. 分组与分组后过滤
Db::name('article')
->field('menuid, count(*) as total')
->group('menuid')
->having('total > 5') // 对聚合结果再过滤
->select();
6. 其它常用链式
->distinct(true) // 结果去重
->lock(true) // SELECT ... FOR UPDATE 行锁
->comment('排行TOP10') // 给 SQL 加注释(方便日志排查)
->cache(true, 300) // 查询缓存 300 秒
->whereTime('create_time', 'today') // 时间表达式快捷条件
7. 获取查询结果
| 方法 | 返回 |
|---|---|
find() | 一条记录(数组) |
select() | 记录集(数据集对象,可当数组用) |
value('title') | 第一条记录的某个字段值 |
column('title') | 某字段的一列数据(数组) |
count() / max() / min() / avg() / sum() | 聚合结果 |
paginate() | 分页对象(数据 + 总条数 + 分页参数) |
四、查询表达式
where 的第二个参数就是查询表达式,常用的有:
| 表达式 | 含义 | 快捷方法 |
|---|---|---|
= <> > < >= <= | 比较 | 直接写三段式 |
LIKE / NOT LIKE | 模糊匹配 | whereLike / whereNotLike |
IN / NOT IN | 范围集合 | whereIn('id', [1,2,3]) |
BETWEEN / NOT BETWEEN | 区间 | whereBetween('id', [1,10]) |
NULL / NOT NULL | 空值判断 | whereNull / whereNotNull |
EXP | 原生表达式(配合 Db::raw) | where('id', 'exp', Db::raw('> 10')) |
五、聚合查询
Db::name('article')->where('isshow', 1)->count(); // 总数
Db::name('article')->max('view'); // 最大值
Db::name('article')->min('view'); // 最小值
Db::name('article')->avg('view'); // 平均值
Db::name('article')->sum('view'); // 求和
六、原生查询
链式不够用时直接写 SQL,占位符防注入:
Db::query('SELECT * FROM tp_article WHERE id = ?', [10]); // 查询
Db::execute('UPDATE tp_article SET view = view + 1 WHERE id = ?', [10]); // 写操作
Db::raw('view + 1'); // 在链式里嵌原生字段表达式
七、事务支持
Db::transaction(function () {
Db::name('account')->where('id', 1)->dec('money', 100)->update();
Db::name('account')->where('id', 2)->inc('money', 100)->update();
});
// 需要手动控制时:
Db::startTrans();
try {
// ...业务操作...
Db::commit();
} catch (Exception $e) {
Db::rollback();
}
inc/dec 是字段自增自减的链式更新方法,转账这类多表写操作务必放在事务里。
八、综合小实例:文章排行与分页
把链式查询、聚合、连表、缓存、分页串起来:
use thinkfacadeDb;
// 1. 近 7 天阅读量 TOP10:连表取分类名 + 查询缓存
$top = Db::name('article')->alias('a')
->join('menu m', 'a.menuid = m.id', 'LEFT')
->where('a.create_time', '>=', time() - 7 * 86400)
->field('a.id, a.title, a.view, m.menuname')
->order('a.view desc')
->limit(10)
->cache(true, 300)
->select();
// 2. 后台文章列表:条件 + 排序 + 分页
$list = Db::name('article')
->where('isshow', 1)
->whereLike('title', '%thinkphp%')
->order('id desc')
->paginate(10);
// 3. 阅读量 +1:链式更新
Db::name('article')->where('id', 10)->inc('view', 1)->update();
三个小方法用齐了连表、条件、排序、限量、缓存、分页、聚合更新 —— 正好覆盖链式查询的全部要点。
九、总结
config/database.php 配连接,Db::name() 带前缀起步;链式方法拼 SQL、find/select 触发执行;where 三种写法配查询表达式和 where* 快捷方法;join 连表、group/having 分组过滤、order/limit/page 管结果形状、cache 提速、lock 保事务一致;原生 query/execute 兜底,事务包住多表写。