0

0

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

星降

星降

发布时间:2025-07-09 15:16:01

|

979人浏览过

|

来源于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查询构造器处理复杂查询和条件?

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

嵌套条件与逻辑分组:

当你的ANDOR条件需要进行逻辑分组时,查询构造器的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):

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

// 联结多个条件
$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 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子句中使用的列都建立了合适的索引。没有索引的查询,数据库可能需要进行全表扫描,这在数据量大时是灾难性的。

例如,如果你经常按emailstatus字段查询用户,就应该为这些字段添加索引:

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

在使用whereBetweenwhereIn等方法时,涉及的列也应考虑索引。

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组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

316

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

271

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

369

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

370

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

81

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

64

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

67

2025.08.05

数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

678

2023.10.12

Golang gRPC 服务开发与Protobuf实战
Golang gRPC 服务开发与Protobuf实战

本专题系统讲解 Golang 在 gRPC 服务开发中的完整实践,涵盖 Protobuf 定义与代码生成、gRPC 服务端与客户端实现、流式 RPC(Unary/Server/Client/Bidirectional)、错误处理、拦截器、中间件以及与 HTTP/REST 的对接方案。通过实际案例,帮助学习者掌握 使用 Go 构建高性能、强类型、可扩展的 RPC 服务体系,适用于微服务与内部系统通信场景。

6

2026.01.15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
MySQL 教程
MySQL 教程

共48课时 | 1.8万人学习

MySQL 初学入门(mosh老师)
MySQL 初学入门(mosh老师)

共3课时 | 0.3万人学习

简单聊聊mysql8与网络通信
简单聊聊mysql8与网络通信

共1课时 | 793人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号