ThinkPHP五种常用查询方法详解

本文深入解析了ThinkPHP框架中5种核心数据查询方式——基础链式查询、原生SQL查询、视图查询、关联查询（含预加载）以及查询作用域，全面覆盖从简单条件筛选到复杂关系处理、高性能优化及代码复用等实际开发场景；特别强调链式查询+关联查询+作用域的黄金组合即可满足90%以上的业务需求，同时提醒关键使用细节如参数绑定防注入、预加载避免N+1、作用域提升可维护性等，是ThinkPHP开发者高效、安全、优雅操作数据库的实用指南。

ThinkPHP 的查询方式主要围绕模型（Model）和查询构建器（Query Builder）展开，常见且实用的有 5 种核心查询类型，对应不同场景下的数据获取需求。

1. 基础链式查询（最常用）

通过模型调用链式方法组合条件，最终用 select() 或 find() 执行：

• UserModel::where('status', 1)->order('id desc')->limit(10)->select() —— 查多条
• UserModel::where('id', 10)->find() —— 查单条（主键查询可简写为 find(10)）

特点是灵活、可读性强，适合大多数业务逻辑。

2. 原生 SQL 查询

当链式方法难以表达复杂逻辑（如子查询、特定函数、联合查询）时，直接执行原生语句：

• Db::query("SELECT * FROM user WHERE status = ? AND create_time > ?", [1, '2024-01-01']) —— 查询语句，返回数组
• Db::execute("UPDATE user SET status = ? WHERE id = ?", [0, 5]) —— 执行增删改

注意使用参数绑定防止 SQL 注入，避免拼接变量。

3. 视图查询（View Query）

针对数据库视图或临时表结构，可新建模型指向视图名（如 OrderSummary 对应视图 view_order_summary），然后像普通模型一样链式查询：

• OrderSummary::where('year', 2024)->select()

前提是数据库已创建好视图，ThinkPHP 不负责建视图，只做查询封装。

4. 关联查询（含预加载与动态关联）

用于处理一对多、多对一等关系，减少 N+1 查询问题：

• ArticleModel::with('author,category')->select() —— 预加载关联模型
• ArticleModel::has('comments', 'count>3')->select() —— 按关联存在/数量筛选
• 在模型中定义 belongsTo/hasMany 方法后，支持 $article->author 延迟加载

合理使用 with() 能显著提升列表页性能。

5. 查询作用域（Scope）封装复用条件

把常用查询条件抽象成作用域方法，提高代码复用性：

• 在模型中定义：public function scopeActive($query) { return $query->where('status', 1); }
• 调用：UserModel::active()->select()

适合多处用到相同过滤逻辑的场景，比如“启用状态”、“未删除”、“本月数据”等。

基本上就这些。实际开发中，链式查询 + 关联查询 + 作用域 组合覆盖了 90% 以上的查询需求；原生 SQL 和视图查询按需补充。不复杂但容易忽略的是：链式方法顺序不影响结果，但 where 必须在 select 前，且每次调用都会新建查询实例（非单例）。

本篇关于《ThinkPHP五种常用查询方法详解》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！