laravel怎么用DB facade执行原生SQL查询_laravel DB facade原生SQL执行方法_网络技术

发布时间 - 2025-12-19 00:00:00 点击率：次

使用 DB Facade 可在 Laravel 中执行原生 SQL，支持 select、insert、update、delete、statement 和 unprepared 方法，适用于复杂查询或结构变更，需注意参数绑定与安全风险。

如果您需要在 Laravel 中执行复杂的数据库查询，而查询无法通过查询构造器或 Eloquent 实现，则可以使用 DB Facade 来直接运行原生 SQL 语句。以下是几种使用 DB Facade 执行原生 SQL 查询的方法：

本文运行环境：MacBook Pro，macOS Sonoma

一、使用 DB::select 执行查询语句

DB::select 方法用于执行 SELECT 类型的原生 SQL 查询，返回结果集。该方法适用于需要获取数据但不修改数据库的场景。

1、在控制器或路由闭包中引入 DB Facade，确保已通过 use 语句导入 Illuminate\Support\Facades\DB。

2、调用 DB::select('SELECT * FROM users WHERE active = ?', [1])，其中 ? 为参数占位符，第二个参数为绑定的值数组。

3、若使用命名绑定，可写成 DB::select('SELECT * FROM users WHERE id = :id', ['id' => 1])，提高可读性。

DB::insert 方法用于执行不返回结果集的数据操作语句，如 INSERT。执行后返回布尔值表示是否成功。

1、编写包含字段和值的 INSERT 语句，例如 DB::insert('INSERT INTO users (name, email, password) VALUES (?, ?, ?)', ['Alice', 'alice@example.com', 'password'])。

2、确保传入的参数数量与占位符匹配，避免 SQL 错误。

DB::update 方法用于执行 UPDATE 语句，返回受影响的行数，适合用于修改已有记录。

1、构造更新语句，如 DB::update('UPDATE users SET name = ? WHERE id = ?', ['Bob', 5])。

2、检查返回值是否大于 0，以判断是否有记录被实际更新。

DB::delete 方法用于执行 DELETE 语句，同样返回受影响的行数，用于从数据库中移除记录。

1、编写删除语句，例如 DB::delete('DELETE FROM users WHERE status = ?', ['inactive'])。

2、注意添加 WHERE 条件，防止误删全部数据。

DB::statement 方法用于执行不需要返回结果的 SQL 语句，如 CREATE、DROP、ALTER 等 DDL 操作。

1、执行数据库结构变更命令，如 DB::statement('CREATE TABLE IF NOT EXISTS profiles (id INT AUTO_INCREMENT PRIMARY KEY, user_id INT, bio TEXT)')。

2、确保在安全环境下执行此类操作，避免生产环境误操作。

DB::unprepared 方法用于执行不能被预处理的 SQL 语句，或一次性执行多个语句，常用于迁移或初始化脚本。

1、调用 DB::unprepared('SET FOREIGN_KEY_CHECKS=0; TRUNCATE TABLE users; SET FOREIGN_KEY_CHECKS=1;') 来执行多个命令。

2、注意此方法绕过预处理机制，存在 SQL 注入风险，仅应在受信任的上下文中使用。