Doctrine 查询调试技巧：获取真实 SQL，优化查询

调试 Doctrine 查询：显示真实的 SQL

在使用 PHP 对象关系映射 (ORM) 库 Doctrine 时，你可能会遇到需要检查真实 SQL 查询的情况。Doctrine 默认情况下只显示预准备语句，其中包含占位符 ?。本文将深入探讨如何获取真实的 SQL 查询。

问题：预准备语句的局限性

在构造 Doctrine 查询时，我们可能会添加条件和约束，例如：

$q = Doctrine_Query::create()->select('id')->from('MyTable');
$q->where('normalisedname = ? OR name = ?', array($string, $originalString));

使用 getSQLQuery() 方法时，Doctrine 不会显示完整的查询，而是显示预准备语句：

SELECT id FROM MyTable WHERE normalisedname = ? OR name = ?

解决方案：获取未准备的 SQL

为了获取完整的 SQL 查询，我们需要使用 getSqlQuery() 方法，它返回一个 Doctrine_Query_Sql 对象。此对象具有一个 __toString() 方法，该方法返回未准备的 SQL 查询：

$sql = $q->getSqlQuery();
echo $sql->__toString();

这将打印出完整的 SQL 查询，包括未准备的占位符：

SELECT id FROM MyTable WHERE normalisedname = 'string' OR name = 'originalString'

注意：返回结果集的方式

在某些情况下，你还需要使用 getHydrationMode() 方法来指定结果集的返回方式。默认情况下，Doctrine 使用 HYDRATE_ARRAY，返回关联数组。要获取对象数组，请使用 HYDRATE_OBJECT：

$q->setHydrationMode(Doctrine_Query::HYDRATE_OBJECT);

结论

获取真实的 SQL 查询对于调试和理解 Doctrine 查询非常重要。通过使用 getSqlQuery() 方法，我们可以访问未准备的 SQL 查询，从而查看 Doctrine 发送到数据库的实际语句。

常见问题解答

1. 为什么 Doctrine 默认只显示预准备语句？
   为了保护应用程序免受 SQL 注入攻击，预准备语句用于将占位符替换为实际值。

2. 除了 getSqlQuery() 之外，还有其他方法可以获取真实的 SQL 吗？
   没有。getSqlQuery() 是唯一可靠的方法。

3. getHydrationMode() 方法的目的是什么？
   指定返回结果集的方式，可以是关联数组或对象数组。

4. 如何查看发送到数据库的占位符值？
   需要使用 setParameters() 方法显式设置占位符值，然后使用 getSQL() 方法获取真实的 SQL。

5. 是否可以同时显示预准备语句和真实的 SQL？
   可以，使用 Doctrine\DBAL\Logging\DebugStack 类记录所有数据库操作。