Laravel查询构造器入门教程

Laravel查询构造器是高效、安全编写数据库查询的首选工具，它以DB::table()为起点，通过链式调用where、select、orderBy等方法替代易出错的原生SQL拼接，天然防止SQL注入；文章深入剖析了常见误区——如混淆Eloquent与纯构造器、错误使用where数组语法、手动分页导致性能隐患、查无结果时未判空引发运行时错误，并给出精准实践建议：优先用paginate()实现智能分页、单值查询选value()、复杂条件善用闭包嵌套、始终关注各方法返回类型，助你写出更健壮、可维护、高性能的数据库操作代码。

直接用 DB::table() 就能查，别绕路写原生 SQL

框架里写查询，第一反应不该是拼接字符串。Laravel 的查询构造器（Query Builder）就是干这个的：把 SQL 拆成链式方法调用，安全、可读、还能防注入。DB::table('users') 是起点，后面跟 where()、select()、orderBy() 都是常见操作。它不依赖模型，适合简单表或临时查询。

常见错误是混用模型和构造器还强转——比如 User::query()->where(...)->get() 其实走的是 Eloquent，不是纯构造器；真要轻量，就从 DB::table() 开始。

• DB::table('posts')->where('status', 1)->orderBy('created_at', 'desc')->limit(5)->get() 返回集合对象，不是数组
• 字段名别加反引号，构造器会自动处理；但别传变量进字符串拼接，比如 "WHERE {$field} = ?" —— 这等于放弃防注入能力
• 如果只查单个字段值，用 value('title') 比 pluck('title')->first() 更直接

where() 的三种写法，别全用数组形式硬套

where() 看似简单，但参数组合影响逻辑走向。最常踩坑的是以为 where(['a' => 1, 'b' => 2]) 和 where('a', 1)->where('b', 2) 完全等价——其实前者生成 AND，后者也是 AND，但可读性和后续扩展性差很多。真正要注意的是多条件混合时的括号逻辑。

• 单条件：where('id', 123) 或 where('name', 'like', '%john%')
• 多字段 AND：where([['status', 1], ['type', 'article']]) —— 注意是二维数组，不是关联数组
• 带括号的 OR：where('status', 1)->orWhere(function ($q) { $q->where('archived', 0)->where('score', '>', 80); })

用错括号结构会导致 WHERE 条件优先级错乱，查出数据不对却找不到原因。

分页别手动算 offset，用 paginate() 或 simplePaginate()

手写 skip() + take() 做分页，不仅容易漏传当前页码，还会让 COUNT 查询丢失。Laravel 的 paginate(15) 会自动做两件事：查总数（用于渲染页码）、查当前页数据。而 simplePaginate() 只查数据、不 COUNT，适合大数据量且不需要总页数的场景（比如无限滚动）。

• DB::table('logs')->where('level', 'error')->paginate(20) 返回 LengthAwarePaginator 实例，模板里直接用 $data->links()
• 如果用了 selectRaw() 或聚合函数，paginate() 可能报错“Column not found”，此时换 simplePaginate() 更稳妥
• 不要在 paginate() 后再调 toArray() —— 它本身已支持 JSON 输出，API 接口直接 return 即可

查不到数据时，first() 返回 null，别直接取属性

first() 是最常用的单条查询方法，但它不抛异常，查无结果就返回 null。很多人接着写 $user->name，结果触发 “Trying to get property 'name' of non-object” 错误。

• 安全写法：$user = DB::table('users')->where('id', $id)->first(); if ($user) { echo $user->email; }
• 想抛异常用 findOrFail($id)，但它只在模型里有，构造器没这方法；如需类似行为，得自己判断 if (!$user) abort(404);
• value('email') 和 exists() 是更轻量的替代：一个取单字段值，一个只返回布尔，避免多余对象创建

构造器的链式调用看着顺滑，但每个方法的返回值类型得心里有数——get() 返回集合，first() 返回对象或 null，count() 返回整数，混用时类型错误往往晚到运行时才暴露。

好了，本文到此结束，带大家了解了《Laravel查询构造器入门教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！