如何将 Query Builder 中的 SQL 查询提取为字符串：完整指南

引言：当 Query Builder 沉默时，如何查看 SQL

您是否曾经通过 Query Builder 编写了一个复杂的查询，运行后却得到错误或错误的数据？您急切地想看看方法链实际生成了什么，但框架却固执地返回一个对象，而不是字符串。这场景是不是很熟悉？

这个问题是 Stack Overflow 上最热门的问题之一（有数万次浏览）。这并非偶然。能够从 Query Builder 中“提取”原始 SQL 是一项超能力，可以节省数小时的调试时间。特别是当您使用像 Doctrine 或 Laravel 中的 Eloquent 这样的 ORM 时，查询是通过方法链构建的，而实际的 SQL 隐藏在内部。

在本文中，我们将探讨如何在不同 PHP 框架中从 Query Builder 获取原始 SQL 字符串，展示代码示例，并解释为什么这对每个开发者都很重要。让我们开始吧！

1. 为什么您可能需要原始 SQL？

在深入代码之前，让我们先理解为什么需要查看“原始”SQL，既然 Query Builder 已经为我们处理了一切。

\n
• 调试错误。当查询不起作用时，您只能看到一个对象。而 SQL 才是真相。您将看到哪些表被连接，应用了哪些 WHERE 条件，以及语法错误在哪里。
\n
• 性能优化。Query Builder 可能会生成低效的查询。通过查看它，您会发现多余的 JOIN 或缺少索引。
\n
• 学习。如果您是新手，查看生成的 SQL 有助于理解 ORM 如何将您的 PHP 方法转换为实际的 SQL 命令。
\n
• 导出和日志记录。有时需要将查询记录到日志或发送到其他服务。没有字符串，这是不可能的。
\n

现在让我们进入最有趣的部分——代码。

2. Laravel Eloquent：toSql() 和 getBindings()

Laravel 是最流行的 PHP 框架，其 Query Builder（Eloquent 的一部分）提供了内置方法来获取 SQL。以下是它的工作原理。

简单示例：toSql()

use Illuminate\\Support\\Facades\\DB;\n\n$query = DB::table('users')\n    ->where('age', '>', 18)\n    ->where('status', 'active')\n    ->orderBy('name', 'asc');\n\n$sql = $query->toSql();\n\necho $sql;\n// 输出：select * from `users` where `age` > ? and `status` = ? order by `name` asc

太好了！但您注意到问号了吗？这些是预处理语句的占位符。要查看实际值，需要使用 getBindings()。

带值替换的完整 SQL

$bindings = $query->getBindings();\n\n$fullSql = vsprintf(str_replace('?', '%s', $sql), array_map(function ($value) {\n    return is_numeric($value) ? $value : "'" . $value . "'";\n}, $bindings));\n\necho $fullSql;\n// 输出：select * from `users` where `age` > 18 and `status` = 'active' order by `name` asc

这个技巧用实际值替换了占位符。但请注意：不要使用此方法执行查询——它不会转义数据，仅用于调试。

用于快速调试的 dd() 方法

Laravel 有一个方便的 dd() 方法（dump and die），可以输出 SQL 和绑定值：

DB::table('users')->where('age', '>', 18)->dd();\n// 将停止执行并显示：\n// sql: select * from `users` where `age` > ?\n// bindings: [18]

提示：仅在开发环境中使用 dd()。在生产环境中它会终止查询。

3. Doctrine ORM：getSQL() 和参数

Doctrine 是一个强大的 ORM，用于 Symfony 和其他项目中。它的 Query Builder 略有不同，但原理相同。

基本示例

use Doctrine\\ORM\\EntityManagerInterface;\n\n// 假设 $entityManager 已通过 DI 获取\n$queryBuilder = $entityManager->createQueryBuil