如何在Laravel中使用查询构造器-Laravel-PHP中文网

laravel查询构造器是与数据库交互的核心工具，它提供流畅接口构建sql查询，防止sql注入。1.基础操作包括获取记录、插入、更新、删除数据；2.支持复杂查询如条件过滤、排序、分组聚合、联表查询；3.与eloquent orm不同，查询构造器更轻量高效，适合简单查询；4.处理复杂条件可用闭包分组逻辑；5.性能优化包括选择指定列、使用索引、避免循环查询、限制结果集、批量操作等。掌握这些技巧可提升开发效率和应用性能。

如何在Laravel中使用查询构造器

在Laravel中，使用查询构造器（Query Builder）是与数据库交互的核心方式之一。它提供了一个流畅、方便的接口，让你能够以编程的方式构建和执行各种数据库查询，而无需直接手写SQL语句。这极大地提升了开发效率和代码的可读性，同时也能有效防止SQL注入等安全问题。

解决方案

Laravel的查询构造器提供了一套非常全面的方法来执行数据库操作，包括数据查询、插入、更新和删除。它的强大之处在于其链式调用（chainable）的特性，你可以将多个查询方法串联起来，构建出复杂的查询逻辑。

基础查询操作：

要开始使用查询构造器，通常会通过DB门面（Facade）的table方法指定要操作的表。

use Illuminate\Support\Facades\DB;

// 获取表中所有记录
$users = DB::table('users')->get();

// 获取单条记录
$user = DB::table('users')->where('id', 1)->first();

// 获取特定列
$names = DB::table('users')->pluck('name'); // 获取所有用户的name列值，返回一个集合
$name = DB::table('users')->where('id', 1)->value('name'); // 获取单个用户的name列值

// 插入数据
DB::table('users')->insert([
    'name' => 'John Doe',
    'email' => 'john@example.com',
    'password' => bcrypt('password'),
]);

// 插入多条数据
DB::table('users')->insert([
    ['name' => 'Jane Doe', 'email' => 'jane@example.com'],
    ['name' => 'Mike Smith', 'email' => 'mike@example.com'],
]);

// 更新数据
DB::table('users')
    ->where('id', 1)
    ->update(['name' => 'Updated Name']);

// 删除数据
DB::table('users')->where('id', 1)->delete();

// 清空表（不带where条件）
// DB::table('users')->truncate(); // 注意：truncate会重置自增ID

登录后复制

更复杂的查询：

查询构造器支持各种条件、排序、分组和聚合函数。

// 条件查询
$activeUsers = DB::table('users')
    ->where('status', 'active')
    ->where('votes', '>', 100)
    ->get();

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

// 范围查询
$usersBetween = DB::table('users')
    ->whereBetween('votes', [1, 100])
    ->get();

// 排序
$sortedUsers = DB::table('users')
    ->orderBy('name', 'desc')
    ->get();

// 分组和聚合
$userCount = DB::table('users')->count();
$avgVotes = DB::table('users')->avg('votes');
$maxVotes = DB::table('users')->max('votes');

$usersByStatus = DB::table('users')
    ->select('status', DB::raw('count(*) as total'))
    ->groupBy('status')
    ->having('total', '>', 5) // 过滤分组结果
    ->get();

// 联表查询 (Join)
$usersWithPosts = DB::table('users')
    ->join('posts', 'users.id', '=', 'posts.user_id')
    ->select('users.name', 'posts.title')
    ->get();

// 左联结
$usersLeftJoinPosts = DB::table('users')
    ->leftJoin('posts', 'users.id', '=', 'posts.user_id')
    ->select('users.name', 'posts.title')
    ->get();

登录后复制

通过这些方法，你可以灵活地构建出几乎任何你需要的SQL查询。

Laravel查询构造器与Eloquent ORM有什么区别？

这个问题经常被提及，理解它们之间的差异对于选择合适的工具至关重要。简单来说，查询构造器和Eloquent ORM都是Laravel与数据库交互的方式，但它们在抽象层次和功能侧重点上有所不同。

查询构造器更接近SQL本身，它操作的是数据库表，返回的结果通常是stdClass对象（或数组）。当你使用DB::table('users')时，你实际上是在直接与users这张表打交道。它的优势在于轻量、高效，对于一些简单的、不需要模型层额外逻辑的查询（比如纯粹的统计、批量更新或删除），查询构造器往往是更直接的选择。它不涉及模型实例的创建、事件触发或关系加载，因此在某些场景下性能会更好。我个人在处理一些报表生成或者数据迁移脚本时，就更倾向于直接使用查询构造器，因为它能让我更专注于SQL逻辑本身，减少不必要的ORM开销。

而Eloquent ORM（Object-Relational Mapper）则是Laravel提供的更高级的数据库抽象层。它基于模型（Model）的概念，每个模型通常对应数据库中的一张表。当你使用User::find(1)时，你操作的是一个User模型实例，而不是直接操作users表。Eloquent的强大之处在于它提供了丰富的面向对象特性，比如定义模型间的关系（一对一、一对多等）、自动处理时间戳、属性访问器（Accessors）和修改器（Mutators）、事件监听等。它让数据库操作变得更“面向对象”，代码更具可读性和可维护性，尤其是在构建复杂业务逻辑时，Eloquent的便利性是查询构造器无法比拟的。但相对地，它会有一些额外的开销，比如模型实例化、关系加载等，这在处理大量数据时可能会体现出来。

所以，选择哪个取决于你的具体需求：如果只是简单的数据查询或操作，不需要模型的额外功能，查询构造器会更直接高效；如果你的操作涉及到复杂的业务逻辑、模型关系、数据转换等，那么Eloquent ORM无疑是更优雅、更强大的选择。很多时候，它们也并非互斥，你可以在Eloquent查询中嵌入查询构造器的部分，比如使用User::whereIn('id', DB::table('other_table')->select('user_id'))这样的组合。

如何使用Laravel查询构造器处理复杂查询和条件？

处理复杂查询和条件是查询构造器的一大强项。它提供了一系列灵活的方法来构建嵌套条件、高级联结以及子查询等。

嵌套条件与逻辑分组：

当你的AND和OR条件需要进行逻辑分组时，查询构造器的where方法接受一个闭包（closure）作为第二个参数。这非常类似于SQL中的括号()。

use Illuminate\Support\Facades\DB;

// 查找 (votes > 100 AND status = 'active') OR (name = 'John Doe') 的用户
$users = DB::table('users')
    ->where(function ($query) {
        $query->where('votes', '>', 100)
              ->where('status', 'active');
    })
    ->orWhere('name', 'John Doe')
    ->get();
// 对应的SQL大致是：SELECT * FROM users WHERE (votes > 100 AND status = 'active') OR name = 'John Doe'

登录后复制

这种方式让你可以清晰地表达复杂的布尔逻辑。你甚至可以在闭包内部继续嵌套闭包，实现多层逻辑分组。

高级联结（Join）：

除了前面提到的join和leftJoin，查询构造器还支持更复杂的联结条件，比如多条件联结或子句联结。

// 联结多个条件
$users = DB::table('users')
    ->join('contacts', function ($join) {
        $join->on('users.id', '=', 'contacts.user_id')
             ->where('contacts.status', 'active'); // 联结时额外条件
    })
    ->get();

// 子查询联结 (虽然通常不直接用于join方法，但在某些场景下可以模拟)
// 更常见的是在whereExists或selectSub中使用子查询

登录后复制

子查询：

子查询在数据库操作中非常常见，查询构造器也提供了相应的支持。

whereExists / whereNotExists： 检查子查询是否存在记录。

// 查找至少有一篇活跃文章的用户
$usersWithActivePosts = DB::table('users')
    ->whereExists(function ($query) {
        $query->select(DB::raw(1)) // 只需要返回一个值表示存在
              ->from('posts')
              ->whereRaw('posts.user_id = users.id') // 关联外部查询
              ->where('posts.status', 'published');
    })
    ->get();

登录后复制

selectSub / fromSub： 将子查询的结果作为列或作为表。

// 选择用户及其最新的文章标题（假设posts表有created_at）
$usersWithLatestPost = DB::table('users')
    ->select('users.name', 'latest_posts.title as latest_post_title')
    ->joinSub(function ($query) {
        $query->from('posts')
              ->select('user_id', 'title')
              ->orderBy('created_at', 'desc')
              ->groupBy('user_id'); // 注意：这里groupBy可能需要结合max(created_at)等来确保取到“最新”
                                    // 更严谨的最新文章子查询可能需要窗口函数或更复杂的自联结
    }, 'latest_posts', function ($join) {
        $join->on('users.id', '=', 'latest_posts.user_id');
    })
    ->get();

登录后复制

对于获取“最新”或“第一条”记录的子查询，通常需要更精细的SQL逻辑，比如使用ROW_NUMBER()窗口函数（如果数据库支持）或通过关联子查询来找到最新ID。

原始表达式（Raw Expressions）：

Python v2.4 中文手册 chm

Python v2.4版chm格式的中文手册，内容丰富全面，不但是一本手册，你完全可以把她作为一本Python的入门教程，教你如何使用Python解释器、流程控制、数据结构、模板、输入和输出、错误和异常、类和标准库详解等方面的知识技巧。同时后附的手册可以方便你的查询。

查看详情

当你需要执行一些查询构造器没有直接提供的方法，或者需要使用数据库特定的函数时，可以使用DB::raw()。

// 使用数据库函数
$users = DB::table('users')
    ->select(DB::raw('count(*) as user_count, status'))
    ->whereRaw('age > ? and votes > ?', [25, 100]) // 原始where子句
    ->groupBy('status')
    ->get();

// 也可以用于排序
$users = DB::table('users')
    ->orderBy(DB::raw('RAND()')) // 随机排序
    ->limit(10)
    ->get();

登录后复制

DB::raw()提供了极大的灵活性，但使用时要格外小心，因为它会绕过查询构造器的某些安全机制，你需要自己确保传入的SQL是安全的，以防SQL注入。

使用Laravel查询构造器时常见的性能考量和优化技巧？

性能优化在任何应用中都是一个持续的话题，即使是使用查询构造器，也需要注意一些细节来避免潜在的性能瓶颈。

1. 精确选择列（Select Specific Columns）：

这是最基本也最重要的优化之一。很多开发者习惯性地使用->get()而不指定select，这相当于SELECT *。如果你的表有很多列，但你只关心其中的几列，那么传输所有列的数据会造成不必要的网络开销和内存占用。

// 优化前：
// $users = DB::table('users')->get(); // 获取所有列

// 优化后：只获取id、name和email
$users = DB::table('users')->select('id', 'name', 'email')->get();

登录后复制

这个习惯在小表上可能不明显，但当表数据量达到百万级，或者在循环中频繁查询时，累积的开销会非常显著。

2. 索引的合理利用：

数据库索引是提升查询性能的基石。确保你在where子句、join条件、orderBy子句中使用的列都建立了合适的索引。没有索引的查询，数据库可能需要进行全表扫描，这在数据量大时是灾难性的。

例如，如果你经常按email或status字段查询用户，就应该为这些字段添加索引：

ALTER TABLE users ADD INDEX idx_email (email);
ALTER TABLE users ADD INDEX idx_status (status);

登录后复制

在使用whereBetween、whereIn等方法时，涉及的列也应考虑索引。

3. 避免在循环中执行查询（N+1问题）：

虽然N+1问题更多地与Eloquent ORM的惰性加载（Lazy Loading）相关，但其核心思想也适用于查询构造器。如果你在循环中为每一条记录执行一个额外的查询来获取关联数据，那么你可能正在制造N+1问题。

// 假设你想获取每个用户的最新订单
// 糟糕的方式（可能导致N+1）：
$users = DB::table('users')->get();
foreach ($users as $user) {
    // 每次循环都执行一个新查询
    $latestOrder = DB::table('orders')
        ->where('user_id', $user->id)
        ->orderBy('created_at', 'desc')
        ->first();
    // ...处理$latestOrder
}

// 优化方式：使用联结或子查询一次性获取
$usersWithLatestOrder = DB::table('users')
    ->leftJoinSub(function ($query) {
        $query->from('orders')
              ->select('user_id', 'order_details', DB::raw('MAX(created_at) as latest_created_at'))
              ->groupBy('user_id');
    }, 'latest_orders_summary', 'users.id', '=', 'latest_orders_summary.user_id')
    ->select('users.*', 'latest_orders_summary.order_details')
    ->get();
// 更复杂的场景可能需要更精妙的SQL，比如使用窗口函数或多次联结

登录后复制

核心思想是尽量减少数据库往返次数。

4. 限制结果集大小（Limit/Offset）：

对于需要分页或只显示部分数据的场景，务必使用limit()和offset()方法。

// 获取前10条用户数据
$users = DB::table('users')->limit(10)->get();

// 获取第二页的10条数据（跳过前10条）
$users = DB::table('users')->offset(10)->limit(10)->get();

登录后复制

需要注意的是，当offset值非常大时，数据库仍然可能需要扫描大量行才能跳到指定位置，这在某些数据库（如MySQL）上会成为性能瓶颈。对于大数据量的分页，可以考虑基于游标（cursor-based）的分页或使用where条件来优化。

5. 调试和分析SQL：

Laravel查询构造器提供了toSql()方法来查看即将执行的SQL语句，这对于调试和优化非常有用。

$query = DB::table('users')
    ->where('status', 'active')
    ->orderBy('created_at', 'desc');

echo $query->toSql(); // 输出生成的SQL语句
// 还可以用dd($query->getBindings()); 来查看绑定的参数

// 如果想直接查看执行结果，可以使用dd($query->get());

登录后复制

拿到SQL语句后，你可以在数据库客户端（如MySQL Workbench, DBeaver, PhpMyAdmin等）中运行EXPLAIN命令来分析查询的执行计划，找出潜在的性能瓶颈，比如是否使用了索引、是否进行了全表扫描等。这是我排查性能问题的常用手段，比盲目猜测要有效得多。

6. 批量操作：

对于大量数据的插入、更新或删除，尽量使用批量操作而不是循环单条操作。查询构造器提供了insert(), update(), delete()等方法，它们在内部会优化为单条SQL语句（或少量语句）来处理多条数据。

// 批量插入
DB::table('users')->insert([
    ['name' => 'Alice', 'email' => 'alice@example.com'],
    ['name' => 'Bob', 'email' => 'bob@example.com'],
]);

// 批量更新（例如，将所有未激活用户设置为活跃）
DB::table('users')
    ->where('status', 'pending')
    ->update(['status' => 'active']);

登录后复制

这些优化技巧并非孤立存在，它们常常需要结合使用，并且要根据具体的业务场景和数据量来权衡。性能优化是一个持续迭代的过程，没有一劳永逸的解决方案。

以上就是如何在Laravel中使用查询构造器的详细内容，更多请关注php中文网其它相关文章！