Laravel框架Raw怎么用_Laravel框架原生查询性能指南【教程】

文章不知道大家是否熟悉？今天我将给大家介绍《Laravel框架Raw怎么用_Laravel框架原生查询性能指南【教程】》，这篇文章主要会讲到等等知识点，如果你在看完本篇文章后，有更好的建议或者发现哪里有问题，希望大家都能积极评论指出，谢谢！希望我们能一起加油进步！

Laravel中执行原生SQL需按场景选择：一、DB::select()用于安全SELECT查询；二、DB::raw()嵌入构建器表达式；三、DB::insert/update/delete执行写操作；四、indexHint()优化索引使用。

如果您在Laravel项目中遇到Eloquent无法高效表达复杂逻辑、多层嵌套子查询或数据库特有函数调用的场景，则可能需要绕过ORM直接使用原生SQL。以下是Laravel中执行Raw查询与优化其性能的具体操作路径：

一、使用DB::select()执行安全的SELECT原生查询

该方法适用于读取数据的原生SQL语句，自动返回stdClass对象数组，并支持参数绑定以杜绝SQL注入风险。它底层调用PDO预处理机制，是执行复杂报表类查询的首选方式。

1、在控制器或服务类中引入DB门面：use Illuminate\Support\Facades\DB;

2、编写带问号占位符的查询语句并传入参数数组：DB::select('SELECT u.name, COUNT(p.id) as post_count FROM users u LEFT JOIN posts p ON u.id = p.user_id WHERE u.status = ? GROUP BY u.id HAVING post_count > ?', [1, 0]);

3、若参数较多且需提升可读性，改用命名绑定：DB::select('SELECT * FROM users WHERE role = :role AND created_at >= :since', ['role' => 'admin', 'since' => '2025-01-01']);

二、通过DB::raw()在构建器中嵌入原生片段

当仅部分表达式需原生能力（如MySQL函数、JSON操作、窗口函数等），而整体仍希望保有查询构建器链式调用时，DB::raw()可将字符串插入到WHERE、SELECT、ORDER BY等任意位置，不进行转义。

1、在select()中使用DB::raw()计算字段：User::select('id', 'name', DB::raw('DATE_FORMAT(created_at, "%Y-%m") as month'))->get();

2、在where()中嵌入数据库函数：User::where(DB::raw('YEAR(birth_date)'), 1990)->get();

3、配合orderBy使用原生排序逻辑：Post::orderBy(DB::raw('CHAR_LENGTH(content) DESC'))->take(10)->get();

三、执行非查询类原生语句（INSERT/UPDATE/DELETE）

对于写操作，Laravel提供专用方法确保语句执行后返回明确结果（如影响行数），同时维持参数绑定的安全机制，避免手动拼接SQL带来的漏洞。

1、使用DB::insert()执行插入并获取布尔结果：DB::insert('INSERT INTO logs (level, message, context) VALUES (?, ?, ?)', ['error', 'Connection timeout', json_encode(['host' => 'api.example.com'])]);

2、使用DB::update()更新记录并捕获影响行数：$affected = DB::update('UPDATE users SET last_login = NOW() WHERE id IN (?)', [[101, 102, 105]]);

3、使用DB::delete()删除数据并确认删除数量：$deleted = DB::delete('DELETE FROM sessions WHERE last_activity

四、执行无返回结果的通用语句（DDL/DCL/存储过程）

当需创建表、添加索引、调用存储过程或执行事务控制命令时，DB::statement()是唯一支持的方法，它直接向PDO发送指令，不解析结果集，也不要求返回值。

1、创建复合索引以加速联合查询：DB::statement('CREATE INDEX idx_users_status_created ON users(status, created_at)');

2、调用MySQL存储过程：DB::statement('CALL generate_monthly_report(2026, 4)');

3、启用查询缓存提示（MySQL特定）：DB::statement('SET SESSION query_cache_type = 1');

五、结合IndexHint强制使用指定索引

当MySQL优化器未选择最优索引导致慢查询时，可通过Laravel内置IndexHint类在查询构建器中显式声明索引，避免全表扫描，尤其适用于大数据量且存在多个候选索引的场景。

1、在查询中链式调用indexHint()方法：User::where('status', 1)->where('region', 'CN')->indexHint('force', 'idx_status_region')->get();

2、使用useIndex指定索引名：Order::where('paid', true)->indexHint('use', 'idx_paid_at')->orderBy('paid_at')->take(50)->get();

3、在join操作中为关联表指定索引提示：User::join(DB::raw('posts USE INDEX (idx_user_id_status)'), 'users.id', '=', 'posts.user_id')->where('posts.status', 'published')->get();

今天关于《Laravel框架Raw怎么用_Laravel框架原生查询性能指南【教程】》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于Laravel的内容请关注golang学习网公众号！