Laravel如何使用查询构建器（Query Builder）_Laravel查询构建器语法与实例

发布时间：2025-11-28 | 点击率：

Laravel查询构建器提供链式调用语法，支持防SQL注入的数据库操作。通过DB::table()指定表后可执行查询、插入、更新、删除等操作，如get()获取多条数据，first()获取单条，where()添加条件，支持聚合函数、排序、分页及批量写入，提升开发效率与安全性。

Laravel 的查询构建器（Query Builder）提供了一种流畅、直观的方式来构建数据库查询，无需编写原始 SQL 语句。它支持链式调用，能有效防止 SQL 注入，适用于大多数常见数据库操作。以下介绍其常用语法与实际使用示例。

基本查询操作

使用 DB::table() 方法指定数据表后，即可开始构建查询。

例如，从 users 表中获取所有记录：

use Illuminate\Support\Facades\DB;

$users = DB::table('users')->get();

获取单条记录：

$user = DB::table('users')->where('id', 1)->first();

获取某字段的值：

$name = DB::table('users')->where('id', 1)->value('name');

只取某个列：

$names = DB::table('users')->pluck('name');
// 带键值对
$users = DB::table('users')->pluck('name', 'id');

条件查询（where 子句）

通过 where 方法添加查询条件，支持多种写法。

// 等值匹配
DB::table('users')->where('status', 'active')->get();

// 使用操作符
DB::table('users')->where('age', '>=', 18)->get();

// 多个条件
DB::table('users')
    ->where('status', 'active')
    ->where('age', '>', 20)
    ->get();

// or 条件
DB::table('users')
    ->where('votes', '>', 100)
    ->orWhere('name', 'John')
    ->get();

// in 数组条件
DB::table('users')->whereIn('id', [1, 2, 3])->get();
DB::table('users')->whereNotIn('id', [1, 2, 3])->get();

// null 判断
DB::table('users')->whereNull('created_at')->get();
DB::table('users')->whereNotNull('updated_at')->get();

// 模糊查询
DB::table('users')->where('name', 'like', '%john%')->get();

聚合函数与排序分页

查询构建器支持常用的聚合函数和排序操作。

// 聚合函数
$cnt = DB::table('users')->count();
$max = DB::table('users')->max('age');
$avg = DB::table('users')->avg('score');
$sum = DB::table('users')->sum('points');

// 排序
DB::table('users')->orderBy('name', 'asc')->get();
DB::table('users')->latest('created_at')->get(); // 最新在前

// 分页（手动限制）
DB::table('users')->skip(0)->take(10)->get(); // 第一页，每页10条

插入、更新与删除数据

除了查询，Query Builder 也支持写入操作。

插入数据：

DB::table('users')->insert([
    'name' => 'Tom',
    'email' => 'tom@example.com',
    'created_at' => now(),
    'updated_at' => now(),
]);

插入并获取自增 ID：

$id = DB::table('users')->insertGetId([
    'name' => 'Jerry',
    'email' => 'jerry@example.com',
    'created_at' => now(),
    'updated_at' => now(),
]);

更新数据：

DB::table('users')
    ->where('id', 1)
    ->update(['name' => 'New Name', 'updated_at' => now()]);

自增/自减字段：

DB::table('users')->where('id', 1)->increment('votes');
DB::table('users')->where('id', 1)->decrement('points', 5);

删除数据：

DB::table('users')->where('id', 1)->delete();
DB::table('users')->where('votes', '<=', 0)->delete();
DB::table('users')->truncate(); // 清空表

基本上就这些。Laravel 查询构建器语法简洁，覆盖了大部分数据库操作需求，适合快速开发中使用。结合模型时更强大，但即使单独使用 DB 类也能高效完成任务。不复杂但容易忽略细节，比如时间字段需手动处理或使用模型自动维护。

上一篇：VSC如何启用PHP代码折叠_提升阅读效率的技巧【方法】
下一篇：通过缓存数据库结果提高PHP性能的原理介绍