Laravel 查询构造器用 DB::table() 起手，链式调用 where、select 等方法，安全防注入；慎用原生拼接，避免混用 Eloquent 与构造器，分页优先用 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 条件优先级错乱，查出数据不对却找不到原因。
立即学习“PHP免费学习笔记（深入）”；
分页别手动算 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() 返回整数，混用时类型错误往往晚到运行时才暴露。
