Laravel查询构造器入门教程

Laravel查询构造器是安全高效编写数据库查询的首选方案，它以DB::table()为起点，通过链式调用where、select、paginate等方法实现可读性强、自动防SQL注入的查询逻辑；本文直击实战痛点——厘清构造器与Eloquent的本质区别、规避原生拼接陷阱、掌握where多条件组合的正确写法、善用paginate()实现智能分页、选用value()/exists()提升性能，并强调查无结果时的健壮处理方式，帮你避开90%的常见误区，写出更简洁、更安全、更可靠的数据库代码。

直接用 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() 返回整数，混用时类型错误往往晚到运行时才暴露。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。