技术 · 思考 · 实践 · 成长

首页/ThinkPHP8/正文

ThinkPHP 8 数据库完全指南:配置连接、链式查询、查询表达式与事务

ThinkPHP89 次阅读

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 兜底,事务包住多表写。

只要认真对待生活,终有一天,你的每一份努力,都将绚烂成花。

评论交流

0 条评论 · 支持多级回复
验证码
暂无评论,来说说你的想法吧

相关文章

继续阅读