当前位置:

首页 > 编程开发 > Laravel如何在事务中使用原生SQL语句_Laravel原生SQL事务执行方法【数据库】

Laravel如何在事务中使用原生SQL语句_Laravel原生SQL事务执行方法【数据库】

Laravel中执行原生SQL事务有四种方法:DB::transaction()自动管理提交回滚,适合简单事务;手动控制事务生命周期,适合复杂逻辑;事务内混合读写操作确保原子性;DB::unprepared()执行多语句脚本,需禁用预处理并防范SQL注入。

在日常开发中,当我们需要在Lara vel里执行多条原生SQL语句时,如何保证这些操作要么全部成功、要么全部回滚,是一个很实际的挑战。涉及到插入、更新、删除这类写操作,如果少了事务的约束,一旦某条语句执行失败,就可能导致数据不一致,留下难以排查的隐患。下面就来拆解几种在Lara vel中实现原生SQL事务控制的方案。

Lara vel如何在事务中使用原生SQL语句_Lara vel原生SQL事务执行方法【数据库】

其实,Lara vel对事务的支持相当成熟,核心思路就是把这些原生SQL语句包裹在一个事务上下文中,利用数据库的原子性来兜底。下面这些方法,覆盖了从简单到复杂的常见场景。

一、使用 DB::transaction() 包裹 DB::statement()

第一种方法,本质上就是利用 Lara vel 内置的事务管理器,让它自动帮你处理提交和回滚。这对于执行那些不返回结果集的原生SQL来说,是最省心的方式。

具体怎么做?在控制器或者服务类里,先引入 DB 门面,然后调用 DB::transaction(),传入一个闭包,在闭包里面依次执行 DB::statement() 就行了。举个例子:

DB::transaction(function () {
DB::statement('INSERT INTO users (name, email) VALUES (?, ?)', ['Alice', 'alice@example.com']);
DB::statement('UPDATE profiles SET bio = ? WHERE user_id = ?', ['Developer', 1]);
});

这个事务块有一个很聪明的设计:闭包里的任何一条语句抛出异常,整个事务就会自动回滚。如果你需要手动触发回滚,直接在闭包内抛出一个 Throwable 子类异常即可,比如 throw new \Exception('Custom rollback condition')。

二、使用 DB::beginTransaction() 与手动控制

有时候,业务逻辑没那么简单,你可能需要在执行过程中动态判断:是提交还是回滚?比如,根据某条SELECT查询的结果来决定后续操作是否继续。这时候,就需要手动控制事务的生命周期了。

流程很清晰:先显式开启事务,执行多条原生SQL,然后根据业务逻辑来决定提交还是回滚。

DB::beginTransaction();
DB::statement('INSERT INTO logs (action) VALUES (?)', ['user_created']);
$count = DB::select('SELECT COUNT(*) as cnt FROM users WHERE active = ?', [1])[0]->cnt;

if ($count > 100) {
DB::commit();
} else {
DB::rollback();
}

这种手动控制的方式,给了开发者更大的灵活性,但也意味着你要更小心地确保每个分支都把事务给关了,否则很容易出现锁等待或者连接泄漏的问题。

三、在 DB::transaction() 中混合使用 DB::select() 与 DB::update()

在实际项目中,经常会遇到这样一种场景:先读数据,然后根据读到的结果决定怎么写。比如,在转账操作中,先查余额,再决定是否扣款。这种读写混合的操作,如果放在一个事务里,就能有效避免脏读或者部分写入的问题。

做法也很简单:在事务闭包内,先执行原生 SELECT 获取关键值,然后基于这个结果构造并执行 UPDATE 语句。

DB::transaction(function () {
$balance = DB::select('SELECT balance FROM accounts WHERE id = ?', [123])[0]->balance;

if ($balance >= 500) {
DB::statement('UPDATE accounts SET balance = balance - ? WHERE id = ?', [500, 123]);
DB::statement('INSERT INTO transactions (account_id, amount, type) VALUES (?, ?, ?)', [123, -500, 'withdrawal']);
} else {
throw new \RuntimeException('Insufficient balance');
}
});

注意这里的关键点:如果条件不满足,比如余额不足,闭包自然结束并不会自动回滚,因为事务在闭包执行完毕后才会提交。所以,正确的做法是显式抛出一个异常,强制事务回滚。否则,即使没有发生写操作,事务也会正常提交,这往往不是我们想要的结果。

四、使用 DB::unprepared() 执行含多语句的原生 SQL 脚本

最后一种方法,适用于那些需要一次性执行包含多个分号分隔语句的 SQL 脚本,比如存储过程调用、批量 DDL/DML 操作。DB::unprepared() 可以接收一个包含多条语句的字符串,但这需要特别注意一些前置条件。

首先,必须在数据库连接配置中禁用预处理模拟,否则 PDO 无法正确处理多语句。在 config/database.php 里,为对应的连接配置添加:

'options' => [PDO::ATTR_EMULATE_PREPARES => false]

然后,把这个多语句字符串传入 DB::unprepared(),并确保它被包裹在一个事务块内。

DB::transaction(function () {
DB::unprepared('SET @x = 1; INSERT INTO tmp_values (val) VALUES (@x); UPDATE counters SET total = total + @x;');
});

但这里有一个必须警惕的陷阱:DB::unprepared() 不支持参数绑定。这意味着,如果你把用户输入直接拼接到 SQL 字符串里,就会面临严重的 SQL 注入风险。所以,对于敏感数据,要么预先过滤,要么改用参数化语句拆分执行。一句话总结:禁止直接拼接用户输入到 unprepared 字符串中。

以上四种方法,基本覆盖了 Lara vel 中使用原生 SQL 进行事务控制的常见场景。从最省心的自动事务,到手动控制的灵活方案,再到读写混合的原子性保障,最后到多语句脚本的执行,每种方法都有其适用的场景和需要注意的细节。把握好这些原则,就能在原生SQL操作中,稳稳地守住数据一致性的底线。

本文内容来源于网友投稿,如有侵权请联系删除。
作者最新文章
编程开发 laravel
相关文章 更多
解决PHP递归报错:max_nesting_level限制与内存溢出处理
解决PHP递归报错:max_nesting_level限制与内存溢出处理

遇到PHP递归报错时,不要盲目调大max_nesting_level。本文教你区分Xdebug限制、内存耗尽和正则递归错误,提供代码级的终止条件优化与迭代替代方案,彻底解决栈溢出问题。

PHP递归中static变量与引用传递的常见陷阱及调试
PHP递归中static变量与引用传递的常见陷阱及调试

本文分析PHP递归中static变量导致的状态污染及引用传递引发的共享数据修改问题。提供具体的代码复现、缓存键设计建议及调试打印技巧,帮助开发者避免隐蔽的逻辑错误。

PHP递归性能优化技巧与迭代替代方案
PHP递归性能优化技巧与迭代替代方案

解析PHP递归函数在树形数据处理中的性能瓶颈,提供预加载数据消除I/O、使用显式栈替代深层递归的实战方案,帮助开发者在代码可读性与执行效率间做出合理取舍。

Java测试中怎么使用Mockito模拟依赖对象
Java测试中怎么使用Mockito模拟依赖对象

详细讲解在Java单元测试中如何使用Mockito模拟依赖对象,包括引入依赖、创建Mock、打桩返回值、行为验证以及Mock与Spy的核心差异和常见陷阱排查。

链表删除节点的时间复杂度是多少及其详细分析
链表删除节点的时间复杂度是多少及其详细分析

详细分析链表删除节点的时间复杂度,深入探讨单链表与双向链表在不同已知前提下的查找与删除开销,并结合完整代码与清晰图解进行对比总结。

codex如何配置模型参数及文件设置教程
codex如何配置模型参数及文件设置教程

想知道如何让AI写出的代码更贴合你的习惯?本文手把手教你在VS Code中调整Codex相关模型参数,通过修改配置文件优化温度值和令牌限制,解决代码建议不准确或响应慢的问题。

Claude Code AI编程工具实力揭秘与编程助手实测
Claude Code AI编程工具实力揭秘与编程助手实测

通过实测展示Claude Code在终端中如何理解自然语言指令、自动修改代码文件并处理复杂编程任务,帮助开发者评估其实际辅助能力。

winforms教程自学入门与基础开发步骤详解
winforms教程自学入门与基础开发步骤详解

本教程详细讲解如何使用Visual Studio创建WinForms项目,通过添加按钮和标签控件并编写点击事件代码,实现一个基础的计数器功能,适合C#初学者快速上手Windows窗体应用开发。

Cursor自动补全设置教程教你快速开启代码补全功能
Cursor自动补全设置教程教你快速开启代码补全功能

详解Cursor编辑器中自动补全功能的开启与优化设置,涵盖Tab触发机制、上下文窗口调整及模型切换,帮助开发者解决补全延迟、干扰大等问题,提升编码流畅度。

pandas的数据格式怎么转换和设置方法教程
pandas的数据格式怎么转换和设置方法教程

详解Pandas中数据格式转换的核心方法,包括astype强制转换、to_numeric容错处理及日期解析技巧,解决常见类型错误并提升数据处理效率。

查看更多
精品专题 更多
装机必备
装机必备

正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

Windows
Windows

正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

macOS软件
macOS软件

正软商城macOS软件专区,精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具,提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。

Mac软件 更多
photoshop
photoshop
Windows、macOS 、 iPad

Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件,支持 Windows、macOS 和 iPad 等平台,广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。

Blender
Blender
Windows、macOS 和 Linux

Blender 是一款免费开源、跨平台的专业 3D 创作软件,集建模、动画、渲染、视频编辑与视觉合成等功能于一体,广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎,并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统,安装包轻巧、运行流畅,依托活跃的全球开发者社区持续更新,是从初学者到专业创作者都值得选择的正版 3D 创作工具。

灵活计算器
灵活计算器
macOS/iOS/Android

灵活计算器是一款笔记式算数应用,支持实时计算、动态关联和云端同步功能。记录、整理和输出之间的过渡会更自然,适合长期写作、做笔记或持续沉淀个人内容。

WINDOWS 更多
3dmax(3ds max)
3dmax(3ds max)
Windows

Autodesk 3ds Max 是一款专业的三维建模、动画与渲染软件,广泛应用于建筑可视化、游戏开发、影视动画、广告设计和产品展示等领域。

photoshop
photoshop
Windows、macOS 、 iPad

Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件,支持 Windows、macOS 和 iPad 等平台,广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。

Blender
Blender
Windows、macOS 和 Linux

Blender 是一款免费开源、跨平台的专业 3D 创作软件,集建模、动画、渲染、视频编辑与视觉合成等功能于一体,广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎,并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统,安装包轻巧、运行流畅,依托活跃的全球开发者社区持续更新,是从初学者到专业创作者都值得选择的正版 3D 创作工具。