打印执行的准确 SQL 语句 - PHP

在开发 PHP 应用时，我们常常需要与数据库进行交互，而调试 SQL 语句也是我们开发过程中必不可少的一步。本文将介绍如何在 PHP 中打印执行的准确 SQL 语句，使我们更好地调试应用。

方式一：使用 bindValue 或 bindParam 绑定参数

在执行 PDO 预处理语句时，我们可以使用 bindValue 或 bindParam 方法来绑定参数。这两种方法均有第二个参数可以指定参数类型，如果不指定会根据传入的值类型来自动定位。

$sql = 'SELECT * FROM `users` WHERE `name` = :name AND `age` = :age';
$stmt = $pdo->prepare($sql);
$stmt->bindValue(':name', '张三');
$stmt->bindValue(':age', 18, PDO::PARAM_INT);
$stmt->execute();

在上面的示例中，我们使用 bindValue 方法绑定了两个参数，通过 :name 和 :age 占位符的形式将参数传入。在执行 execute 方法后，系统将会将占位符替换为对应的参数值。

为了打印出执行的 SQL 语句，我们可以在执行 execute 方法前，将 SQL 语句和参数值先打印出来。代码如下所示：

$sql = 'SELECT * FROM `users` WHERE `name` = :name AND `age` = :age';
$stmt = $pdo->prepare($sql);
$stmt->bindValue(':name', '张三');
$stmt->bindValue(':age', 18, PDO::PARAM_INT);

echo $sql . '<br />';
$params = $stmt->debugDumpParams();
$stmt->execute();

上面的代码中，我们在首先输出了完整的 SQL 语句，然后使用 debugDumpParams 方法打印出参数和参数值信息。最后执行 execute 方法。在运行该程序后，我们可以在页面上得到类似下面的输出：

SELECT * FROM `users` WHERE `name` = :name AND `age` = :age
Params:  2
Key: Name: [9] :name
paramno=-1
name=[9] ":name"
is_param=1
param_type=2
Key: Name: [9] :age
paramno=-1
name=[8] ":age"
is_param=1
param_type=1

上面的输出信息中，Param 几个字后面的数字 2 表示了我们绑定了 2 个参数。接下来的 Key 行用于区分参数，我们可以看到它们分别为 :name 和 :age。在最后面，我们可以看到它们的具体值和类型信息。

方式二：使用 debugDumpParams 方法

在上面的示例中，我们使用了 debugDumpParams 方法打印出参数和参数值的信息。如果我们不想打印出 SQL 语句，直接打印参数和参数值该怎么做呢？我们可以使用相同的方式，只是不再需要打印 SQL 语句了。

$sql = 'SELECT * FROM `users` WHERE `name` = :name AND `age` = :age';
$stmt = $pdo->prepare($sql);
$stmt->bindValue(':name', '张三');
$stmt->bindValue(':age', 18, PDO::PARAM_INT);

$params = $stmt->debugDumpParams();
$stmt->execute();

上述代码中，我们只是省去了打印 SQL 语句的代码，直接传递 $params 变量给 debugDumpParams 方法。

方式三：使用 setAttribute 方法

在 PDO 中，我们可以使用 setAttribute 方法来设置属性。其中，PDO::ATTR_ERRMODE 属性用于设置 SQL 语句错误时的处理模式。默认情况下，它的值为 PDO::ERRMODE_SILENT，即不会抛出异常，我们也看不到报错信息。我们可以将其修改为 PDO::ERRMODE_EXCEPTION，这样在 SQL 语句出错时，可以及时告知我们。

$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

通过以上操作，我们就可以及时发现 SQL 语句错误并排查问题。

总结

在本文中，我们介绍了三种不同的方法来打印执行的准确 SQL 语句。

• 使用 bindValue 或 bindParam 绑定参数，并打印 SQL 语句和参数信息
• 使用 debugDumpParams 方法打印参数信息
• 使用 setAttribute 方法设置 ERRMODE_EXCEPTION 属性，发现 SQL 语句错误

通过这些方法，我们可以更好地调试应用，发现问题并及时解决。