06.5.2.8 模型与查询构造器
所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.2 ThinkPHP
本节要解决的问题
- 模型如何定义表名、主键与字段,Db 查询构造器有哪些链式方法?
- 查询表达式、闭包条件、聚合与分页如何使用,作用域如何复用条件?
- 获取器/修改器、类型转换、软删除与模型事件如何工作?
版本前提:ThinkPHP 6.x / 8.0,数据库层基于 think-orm(8.0 默认 3.0,4.0 为可选升级);方法签名以当前版本 ORM 文档为准。
06.5.2.8-001 模型类如何定义,表名与主键如何约定?
一句话结论
模型继承 think\Model,类名按去掉表前缀的表名驼峰命名;不符约定时用 $name(表名后缀)、$table(完整表名)、$pk(主键)属性显式指定。
概念解释
模型自动对应数据表,主键默认 id。模型封装数据与业务方法,查询构造器在模型之上提供获取器、修改器、事件等自动化能力。
原理流程
- 新建模型类继承
think\Model。 - 按命名约定匹配表名,或声明
$name/$table/$pk。 - 模型方法可直接调用数据库查询方法。
- 查询结果返回模型实例或模型集合。
代码或图示
namespace app\model;
use think\Model;
class User extends Model
{
protected $name = 'user';
protected $pk = 'id';
}
常见误区
- 表名含大写却不设
$table:自动转换为小写下划线导致找不到表。 - 模型类名与表名规则不一致又不补属性:调度到错误数据表。
追问
- 模型初始化方法是什么?答:可定义
init方法做模型初始化,调用时机以模型手册为准。 - 数据表后缀/分表怎么做?答:
$suffix属性与suffix()/setSuffix()方法动态切换,细节见模型定义文档。
06.5.2.8-002 模型操作与 Db 查询构造器有什么区别?
一句话结论
Db 门面基于查询构造器,返回数组数据集;模型在 Db 之上封装对象,支持获取器、修改器、类型转换、模型事件与关联,结果为模型/集合。
概念解释
两者底层都走 think-orm 连接与查询构建。模型面向对象封装,Db 面向数组直查;多数场景返回结构可通用,但自动化处理只在模型层生效。
原理流程
Db::name()创建查询构造器。- 链式收集条件后执行语句。
- 模型类继承构造器能力,附加数据处理钩子。
- 模型查询返回模型实例/集合,Db 返回数组。
代码或图示
// Db:返回数组
$row = \think\facade\Db::name('user')->where('id', 1)->find();
// 模型:返回模型实例
$user = \app\model\User::find(1);
常见误区
- 以为模型查询性能必然更差:模型附加了数据处理,直查 Db 更轻量,按场景选择。
- 在 Db 结果上调用获取器方法:获取器只对模型实例生效。
追问
- 模型能调用 Db 的全部构造器方法吗?答:模型支持数据库类的查询构造器方法,在此基础上扩展模型能力。
- 4.0 实体模型分层是什么?答:4.0 把 Model 作为仓储层、Entity 承担数据定义与业务展示,实体无需参数设置。
06.5.2.8-003 Db::name() 与 Db::table() 如何选择?
一句话结论
name() 按表前缀 + 名称拼完整表名,table() 直接使用给定完整表名;带前缀的常规表用 name(),跨前缀或特殊表名用 table()。
概念解释
前缀在数据库配置中定义,name() 自动拼接便于换库调整前缀。table() 绕过前缀拼接,适合完整表名已知的场景。
原理流程
- 数据库配置读取表前缀。
name('user')拼接为前缀 + user。table('prefix_user')直接使用传入表名。- 查询构造器按表名生成 SQL。
代码或图示
Db::name('user')->where('status', 1)->select();
Db::table('sys_user')->where('id', 1)->find();
常见误区
table()又手动加前缀:表名重复拼接。- 换前缀后
table()硬编码表名未同步:指向旧表。
追问
- 多数据库连接怎么指定?答:
connect()方法切换连接配置,方法名以 think-orm 文档为准(待确认)。 - 模型用哪个属性对应
table()?答:$table完整表名,$name为不含前缀的表名。
06.5.2.8-004 where 条件与 whereOr 如何使用?
一句话结论
where(字段, 条件, 值) 添加 AND 条件,whereOr() 添加 OR 条件;支持数组批量条件与闭包分组,条件值自动参数绑定。
概念解释
链式 where 多次调用默认 AND 连接。OR 条件需注意优先级,复杂分组用闭包包裹避免与外层条件错乱。
原理流程
- 调用
where()追加条件片段。 - 条件值进入参数绑定,避免 SQL 注入。
whereOr()生成 OR 连接条件。- 执行时拼接为 WHERE 子句。
代码或图示
Db::name('user')
->where('status', 1)
->whereOr('level', '>', 5)
->where('deleted', 0)
->select();
// 数组批量条件
Db::name('user')->where(['status' => 1, 'deleted' => 0])->select();
常见误区
- OR 与 AND 混用不加括号:条件优先级错误,结果集偏差。
- 直接拼接用户输入进条件字符串:应使用参数绑定形式。
追问
- 条件运算符有哪些?答:
=、<>、>、>=、<、<=、like、between、in、not in等,以查询表达式文档为准。 where传闭包做什么?答:生成分组条件,闭包内条件整体括起。
06.5.2.8-005 常用查询表达式有哪些?
一句话结论
常用表达式:whereIn/whereNotIn、whereBetween/whereNotBetween、whereLike/whereNotLike、whereNull/whereNotNull、whereExp(原生表达式);各表达式对应 SQL 片段并绑定参数。
概念解释
表达式覆盖枚举、区间、模糊、空值等常见条件。原生表达式用于构造器未覆盖的 SQL 片段,需自行注意参数绑定。
原理流程
- 选择对应表达式方法传入字段与值集合。
- 构造器生成
IN/BETWEEN/LIKE/IS NULL片段。 - 集合值按数组绑定参数。
- 条件并入 WHERE 子句。
代码或图示
Db::name('user')
->whereIn('id', [1, 2, 3])
->whereBetween('age', [18, 60])
->whereLike('name', '%think%')
->whereNull('deleted_time')
->select();
常见误区
like模式直接拼用户输入:注意通配符注入与转义。- 区间边界传反:
between先小后大。
追问
- 原生表达式怎么写?答:
whereExp或表达式对象构造 SQL 片段,参数绑定方式以 ORM 文档为准(待确认)。 - 表达式支持闭包子查询吗?答:部分方法支持闭包生成子查询,具体支持清单以版本文档为准。
06.5.2.8-006 where 闭包如何分组条件?
一句话结论
向 where() 传入闭包时,闭包内条件被包裹为一组括号,用于表达 AND ( ... OR ... ) 这类带优先级的复合条件。
概念解释
闭包分组解决 OR 条件优先级问题:外层 AND 条件不受内部 OR 影响。闭包参数为新的查询实例。
原理流程
- 外层
where传入闭包。 - 闭包内调用
where/whereOr构造组内条件。 - 构造器把组内条件加括号并入外层。
- 生成带正确优先级的 SQL。
代码或图示
Db::name('user')->where('status', 1)
->where(function ($query) {
$query->where('level', '>', 5)
->whereOr('vip', 1);
})
->select();
// WHERE status = 1 AND (level > 5 OR vip = 1)
常见误区
- 闭包内条件直接接到外层:缺括号导致 OR 扩散到全表条件。
- 闭包参数类型未声明:IDE 提示缺失,运行期仍可用。
追问
- 嵌套闭包支持吗?答:条件分组可嵌套,按查询构造器层级生成括号。
- 闭包与数组条件混用注意什么?答:数组条件为 AND 扁平条件,分组逻辑放闭包。
06.5.2.8-007 field/order/limit/page/group/having 如何使用?
一句话结论
field 指定查询字段,order 排序,limit 限制条数,page 分页,group 分组,having 分组后过滤;均为链式方法,执行前收集到查询构造器。
概念解释
这些方法对应 SQL 的 SELECT/FROM 子句片段。page(页码, 每页条数) 封装 limit 偏移计算。
原理流程
field()限定返回列,避免*取多余字段。order()追加排序字段与方向。page()/limit()生成分页/条数限制。group()/having()配合聚合分组过滤。
代码或图示
Db::name('user')
->field('id, name, age')
->where('status', 1)
->order('id', 'desc')
->page(1, 20)
->group('level')
->having('count(id) > 5')
->select();
常见误区
having里用未聚合字段:SQL 语义错误,分组过滤应基于聚合结果。- 大表深分页用
page偏移过深:性能差,需考虑游标/键集分页。
追问
limit与page区别?答:limit(偏移, 条数)直接给偏移,page(页码, 条数)换算偏移。- 字段排除怎么写?答:
field支持排除字段写法,具体语法以 ORM 文档为准。
06.5.2.8-008 聚合函数 count/sum/max/min/avg 如何使用?
一句话结论
构造器提供 count()/sum()/max()/min()/avg() 聚合方法,返回标量统计值;可先 where 过滤再聚合,避免全表统计。
概念解释
聚合在数据库端完成,不把明细取到 PHP 再计算。分组聚合配合 group 使用。
原理流程
where限定统计范围。- 调用聚合方法传入字段。
- 生成
COUNT/SUM/MAX/MIN/AVGSQL。 - 返回统计标量。
代码或图示
$total = Db::name('user')->where('status', 1)->count();
$sum = Db::name('order')->where('paid', 1)->sum('amount');
$max = Db::name('user')->max('age');
常见误区
- 先
select()取全部明细再 PHP 统计:内存与网络浪费。 - 聚合字段传
*给sum/avg:应传数值列名。
追问
- 分组后每组聚合怎么取?答:
group配合select返回分组行,聚合字段出现在结果列。 - 聚合结果类型?答:按数据库驱动返回 int/float/string,必要时在 PHP 侧转换。
06.5.2.8-009 find/select/insert/insertGetId/update/delete 分别做什么?
一句话结论
find() 取单条,select() 取列表;insert() 批量插入,insertGetId() 插入并返回自增主键;update() 按条件更新,delete() 按条件删除。
概念解释
执行方法把收集的查询条件发送到数据库。模型层 save() 封装新增/更新判断,Db 层方法更直接。
原理流程
- 链式构造条件与数据。
- 调用执行方法生成对应 SQL。
- 参数绑定后执行语句。
- 返回结果:单条/列表/影响行数/主键。
代码或图示
$user = Db::name('user')->where('id', 1)->find();
$list = Db::name('user')->where('status', 1)->select();
$id = Db::name('user')->insertGetId(['name' => 'tp', 'status' => 1]);
Db::name('user')->where('id', $id)->update(['name' => 'think']);
Db::name('user')->where('id', $id)->delete();
常见误区
update/delete不带where:误更新/删除全表,构造器通常有安全检查。insert传单条数组当批量:结构不符导致写入失败。
追问
- 模型
save()如何判断新增/更新?答:模型有主键且存在则更新,否则新增;修改器与自动时间戳在保存时触发。 - 影响行数怎么取?答:
update/delete返回受影响行数,insertGetId返回主键。
06.5.2.8-010 模型 save() 新增与更新如何判断?
一句话结论
模型实例赋值数据后调用 save():主键存在且记录已存在执行更新,否则执行新增;保存触发修改器、类型转换与模型事件。
概念解释
save() 封装了新增/更新分支,业务代码不必分别调用插入/更新方法。数据通过属性赋值或 data() 批量传入。
原理流程
new Model()或查询取出实例。- 赋值字段数据。
- 调用
save(),模型判断新增/更新。 - 触发修改器、类型转换、事件后写库。
代码或图示
$user = new \app\model\User();
$user->name = 'think';
$user->status = 1;
$user->save(); // 新增
$user = \app\model\User::find(1);
$user->name = 'updated';
$user->save(); // 更新
常见误区
- 直接改模型属性忘记
save():数据不落库。 - 批量赋值未过滤字段:可能写入非预期列。
追问
- 批量新增用什么?答:模型/构造器提供
saveAll或批量插入方法,方法名以 ORM 文档为准。 - 保存时修改器何时触发?答:赋值/
data/save传入数据时按修改器规则处理后再写库。
06.5.2.8-011 批量更新与按条件删除如何写?
一句话结论
构造器 where(...)->update(数据数组) 按条件批量更新,where(...)->delete() 按条件删除;模型删除走实例方法,直接 Db 删除不触发软删除与模型事件。
概念解释
批量操作在数据库端完成,效率高于逐条实例保存。需要模型钩子(软删除、事件)时应走模型方法。
原理流程
- 构造条件限定作用范围。
update传入待更新字段数组。- 生成 UPDATE/DELETE 语句并执行。
- 返回受影响行数。
代码或图示
Db::name('user')->where('level', 0)->update(['status' => 0]);
Db::name('log')->where('create_time', '<', $expire)->delete();
// 模型方式(触发软删除/事件)
\app\model\User::destroy(1);
常见误区
- 软删除模型用 Db 条件删除:绕过软删除标记,记录被物理删除。
- 批量更新缺条件:全表被覆盖。
追问
destroy与实例delete区别?答:destroy按主键/条件批量删除,实例delete删除当前模型;软删除 trait 下两者走标记删除。- 批量更新能触发修改器吗?答:构造器批量更新不经过模型实例,修改器不生效;需逐条模型保存才触发。
06.5.2.8-012 作用域 scopeXxx 如何复用查询条件?
一句话结论
模型中定义 protected function scopeXxx($query, ...),调用时以 xxx() 方式链式使用,把重复条件封装为可复用查询范围。
概念解释
作用域避免多处复制 where 片段。通用条件(正常状态、时间范围)抽成 scope,控制器/模型调用一行复用。
原理流程
- 模型定义
scopeStatus($query, $status)方法。 - 调用
User::status(1)->select()。 - 构造器传入查询对象并执行 scope 内条件。
- 返回带条件的查询实例继续链式调用。
代码或图示
class User extends Model
{
protected function scopeStatus($query, int $status)
{
$query->where('status', $status);
}
protected function scopeVip($query)
{
$query->where('vip', 1);
}
}
$list = User::status(1)->vip()->order('id', 'desc')->select();
常见误区
- scope 方法内直接执行查询:应只追加条件,返回查询对象继续链式。
- scope 参数与调用参数顺序不符:条件取值错误。
追问
- 全局作用域与局部 scope 区别?答:局部 scope 显式调用;模型全局约束可通过基础查询条件/事件实现,机制以 ORM 文档为准。
- 作用域支持闭包参数吗?答:scope 方法形参接收调用传入的额外参数。
06.5.2.8-013 获取器 getXxxAttr 如何工作?
一句话结论
获取器方法命名 get字段名Attr($value, $data),在读取模型属性、序列化输出或显式 getAttr 时自动触发,把原始值转换为展示值。
概念解释
获取器用于状态转文字、时间格式化、枚举翻译等。第二参数为当前全部原始数据,可组合字段生成虚拟属性。
原理流程
- 定义
getStatusAttr($value, $data)。 - 读取
$model->status或toArray()时触发。 - 返回转换后的值。
- 原始值可通过
getData()取得。
代码或图示
class User extends Model
{
public function getStatusAttr($value)
{
return [-1 => '删除', 0 => '禁用', 1 => '正常', 2 => '待审核'][$value] ?? '未知';
}
public function getStatusTextAttr($value, $data)
{
return $this->getStatusAttr($data['status']);
}
}
常见误区
- 获取器内改原始数据:它只影响输出展示,不回写数据库。
- 虚拟字段获取器未在输出白名单:
toArray时可能不出现,受输出配置影响。
追问
- 动态获取器怎么写?答:
withAttr('字段', 闭包)在查询时动态附加转换,动态获取器优先级高于模型定义。 - 取原始值用什么?答:
getData('status')获取未经过获取器的原始值。
06.5.2.8-014 修改器 setXxxAttr 如何工作?
一句话结论
修改器命名 set字段名Attr($value, $data),在模型赋值、data()、save() 传入数据或显式 setAttr 时触发,把写入数据处理后再落库。
概念解释
修改器与获取器方向相反:写入前转换(如字符串小写、序列化组装、时间格式转换)。第二参数为当前全部数据。
原理流程
- 定义
setNameAttr($value, $data)。 - 模型赋值或保存传入数据时触发。
- 返回处理后的值写入数据数组。
save()按处理后数据写库。
代码或图示
class User extends Model
{
public function setNameAttr($value)
{
return strtolower(trim($value));
}
public function setSerializeAttr($value, $data)
{
return serialize($data);
}
}
常见误区
- 修改器里读取数据库做关联补全:写入钩子不宜做远程/查询副作用。
- 修改器返回 null 不清空字段:无返回值表示不修改当前字段。
追问
- 批量触发修改器怎么做?答:
data($data, true)或setAttrs/appendData第二参数传 true,按修改器规则批量处理。 - 修改器能改其他字段吗?答:可在修改器内
$this->set('other', ...)补充其他字段数据。
06.5.2.8-015 getData() 与获取器输出有何区别?
一句话结论
getData() 返回模型原始数据数组(未经获取器转换),直接读取 $model->field 或 toArray() 经过获取器处理;调试与需要原值时用 getData()。
概念解释
模型内部保存原始属性,对外读取走获取器。两者分离避免转换结果污染原始数据。
原理流程
- 查询结果存入模型原始数据。
- 属性读取/序列化调用获取器转换。
getData()直接返回原始数组。getAttr('field')显式触发获取器取值。
代码或图示
$user = User::find(1);
echo $user->status; // 获取器转换后的值
dump($user->getData()); // 原始数据数组
dump($user->getData('status')); // 原始状态值
常见误区
- 用
getData()拿到转换后值再比较:实际是原始值。 - 序列化时混淆原始与输出字段:
toArray走获取器与隐藏/追加配置。
追问
- 如何只取部分原始字段?答:
getData('字段名')返回指定原始值。 - 获取器依赖原始其他字段怎么办?答:通过第二参数
$data读取组内原始数据。
06.5.2.8-016 类型转换 $type 属性如何使用?
一句话结论
模型 $type 声明字段类型转换(如 int、float、bool、array/json、datetime),读取与写入时按声明转换;数组/JSON 字段自动序列化与反序列化。
概念解释
类型转换统一处理字段格式,避免在获取器里重复写转换规则。JSON 字段读取返回数组,写入自动编码。
原理流程
$type数组声明字段到类型映射。- 模型读取数据时按类型反序列化/转换。
- 写入时按类型序列化。
- 输出时类型保持声明格式。
代码或图示
class User extends Model
{
protected $type = [
'age' => 'integer',
'vip' => 'boolean',
'tags' => 'array',
'extra' => 'json',
];
}
常见误区
- JSON 字段声明为 array 后直接存字符串:类型转换按声明处理,写入应为数组。
- 数据库字段类型与
$type不符:读取转换可能丢精度或报错。
追问
- 时间字段自动格式化怎么做?答:日期字段类型与自动写入时间配置配合,格式以模型日期属性为准。
- 4.0 实体模型类型处理有何变化?答:实体层承担数据处理与类型定义,细节以 4.0 实体文档为准。
06.5.2.8-017 软删除 SoftDelete 如何启用?
一句话结论
模型引入 think\model\concern\SoftDelete trait,$deleteTime 指定标记字段(默认时间戳、默认 null);删除操作写入标记而非物理删除,普通查询自动排除已删除记录。
概念解释
软删除保留数据便于恢复与审计。标记字段通常为可空时间戳,$defaultSoftDelete 可定义默认值。
原理流程
- 模型
use SoftDelete。 - 声明
$deleteTime字段名与默认值。 - 调用删除方法写入标记时间。
- 默认查询条件追加标记字段为空/默认值。
代码或图示
namespace app\model;
use think\Model;
use think\model\concern\SoftDelete;
class User extends Model
{
use SoftDelete;
protected $deleteTime = 'delete_time';
protected $defaultSoftDelete = 0;
}
常见误区
- 用 Db 构造器条件删除:绕过 trait,记录被物理删除。
- 标记字段在数据库非空且无默认值:软删除写入失败。
追问
- 软删除字段类型建议?答:时间字段统一类型,可用时间戳或默认值 0,类型转换在
$type中声明。 - 关联查询会排除软删除记录吗?答:关联模型按各自软删除配置处理,具体行为以 ORM 关联文档为准。
06.5.2.8-018 withTrashed/onlyTrashed/restore/force 如何使用?
一句话结论
withTrashed() 包含软删除数据,onlyTrashed() 只查已删除记录,restore() 恢复标记删除记录,force()->delete() 真实物理删除。
概念解释
这些方法在软删除基础上调整查询与删除语义。恢复操作把标记字段还原为默认值。
原理流程
- 常规查询排除软删除记录。
withTrashed解除排除条件。onlyTrashed条件改为仅匹配已删除。restore清空标记,force跳过标记直接物理删除。
代码或图示
User::withTrashed()->find(1);
$trashed = User::onlyTrashed()->select();
$user = User::onlyTrashed()->find(1);
$user->restore();
User::find(1)->force()->delete(); // 真实删除
常见误区
force()后仍期待可恢复:物理删除后无法通过restore找回。- 把
onlyTrashed当普通回收站列表:它只返回已删除记录。
追问
destroy(1, true)第二个参数含义?答:true表示真实删除,与force语义对应,参数形式以软删除文档为准。- 恢复时触发模型事件吗?答:恢复/删除按模型生命周期事件触发,事件名以 ORM 文档为准。
06.5.2.8-019 模型事件有哪些挂载点?
一句话结论
模型事件挂在数据生命周期节点(如新增、更新、删除、保存前后),通过模型回调或观察者订阅,用于联动清理、日志、通知等副作用。
概念解释
模型事件解耦主保存逻辑与副作用。同步监听器异常会影响主流程,重逻辑应转异步任务。具体事件方法名以 think-orm 版本为准(待确认)。
原理流程
- 在模型定义事件回调或注册观察者。
- 保存/删除动作到达对应生命周期节点。
- 触发事件并执行监听器逻辑。
- 监听器返回/异常影响后续保存流程。
代码或图示
class User extends Model
{
protected static function onAfterDelete($user)
{
// 删除后清理关联缓存(事件名以 ORM 源码为准)
\think\facade\Cache::delete('user:' . $user->id);
}
}
常见误区
- 事件监听器内做同步远程调用:拖慢保存主流程,应投递队列。
- 在删除事件里反向查询同一模型:注意事件递归与数据状态。
追问
- 观察者与模型回调区别?答:观察者类集中订阅多模型事件,模型回调定义在模型内;注册方式以 ORM 文档为准。
- 模型事件与框架事件系统关系?答:模型事件是 ORM 层生命周期钩子,框架
Event组件用于业务事件分发,二者层级不同。
06.5.2.8-020 数据库惰性连接与断点重连如何理解?
一句话结论
模型/Db 仅在真正执行语句时才建立数据库连接(惰性连接);长时间空闲连接被服务端断开后,驱动在下次执行前检测并重连(断点重连),细节由 think-orm 与 PDO 驱动实现。
概念解释
惰性连接减少不涉及 DB 请求的连接开销。常驻内存场景下连接长期空闲,重连机制保证下次查询可用。
原理流程
- 创建查询对象只保存表名与条件,不连接数据库。
- 执行方法时获取连接并发送 SQL。
- 空闲超时后服务端关闭连接。
- 下次执行前检测连接有效性,失效则重新连接。
代码或图示
$query = Db::name('user')->where('status', 1);
// 此处尚未建立连接
$list = $query->order('id', 'desc')->select();
// 执行 select 时才连接数据库
常见误区
- 实例化模型就占用连接:连接发生在语句执行时。
- 常驻内存下假设连接永久有效:空闲断开需依赖重连机制。
追问
- 连接配置在哪里?答:
config/database.php配置默认连接与多连接参数,键名以版本配置为准。 - 事务何时占用连接?答:开启事务时从连接池/驱动获取连接并绑定,事务期间连接不释放。