详解 WordPress `wpdb` 类的 `last_query` 属性：在调试时如何获取最近一次执行的 SQL。 - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

咳咳，各位同学，早上好/下午好/晚上好！我是你们今天的WordPress SQL调试讲师，代号“SQL猎手”。今天咱们不聊风花雪月，就来聊聊WordPress开发中一个非常实用的小技巧：如何利用wpdb类的last_query属性，像福尔摩斯一样追踪你代码中执行的SQL语句。

在WordPress开发中，我们经常需要与数据库打交道。无论是查询文章、更新选项，还是自定义复杂的数据操作，都离不开SQL语句。但是，SQL代码写多了，难免会出错。有时，你明明觉得代码逻辑没问题，但数据就是不对。这时，就需要用到我们的秘密武器——wpdb->last_query。

一、wpdb类：WordPress的数据库守护神

首先，咱们要明确wpdb是什么。简单来说，wpdb是WordPress提供的一个全局对象，专门用来和数据库交互。它封装了各种数据库操作，比如查询、插入、更新、删除等等。你只要会用wpdb，就可以轻松地在WordPress中操作数据库，而不用直接写那些底层的数据库连接代码。

WordPress会自动实例化wpdb对象，并把它放在全局作用域中，你可以通过 $wpdb 变量来访问它。

二、last_query属性：SQL追踪神器

last_query 属性是 wpdb 类的一个成员变量，它保存了最近一次执行的SQL查询语句。这个属性非常有用，尤其是在调试的时候。你可以通过它来查看你写的SQL语句是否正确，或者查看WordPress底层执行了哪些SQL语句。

三、如何使用last_query：实战演练

说了这么多理论，不如来点实际的。下面，我们通过几个例子来演示如何使用last_query属性。

场景一：查询文章

假设我们要查询ID为1的文章标题。代码如下：

global $wpdb;

$post_id = 1;
$query = $wpdb->prepare(
    "SELECT post_title FROM {$wpdb->posts} WHERE ID = %d",
    $post_id
);
$result = $wpdb->get_var( $query );

if ( $result ) {
    echo "文章标题： " . $result;
} else {
    echo "没有找到文章！";
}

echo "<br>";
echo "最近一次执行的SQL语句： " . $wpdb->last_query;

这段代码首先定义了要查询的文章ID。然后，使用$wpdb->prepare()函数准备SQL语句，防止SQL注入。接着，使用$wpdb->get_var()函数执行查询，获取文章标题。最后，使用$wpdb->last_query属性打印出最近一次执行的SQL语句。

运行这段代码，你会在页面上看到文章标题，以及最近一次执行的SQL语句，类似这样：

文章标题： Hello world!
最近一次执行的SQL语句： SELECT post_title FROM wp_posts WHERE ID = 1

场景二：更新文章

假设我们要更新ID为1的文章标题。代码如下：

global $wpdb;

$post_id = 1;
$new_title = 'Updated Title';

$query = $wpdb->prepare(
    "UPDATE {$wpdb->posts} SET post_title = %s WHERE ID = %d",
    $new_title,
    $post_id
);

$result = $wpdb->query( $query );

if ( $result !== false ) {
    echo "文章更新成功！";
} else {
    echo "文章更新失败！";
}

echo "<br>";
echo "最近一次执行的SQL语句： " . $wpdb->last_query;

这段代码与查询文章类似，只是使用了$wpdb->query()函数执行更新操作。同样，我们使用$wpdb->last_query属性打印出最近一次执行的SQL语句。

运行这段代码，你会在页面上看到文章更新成功或失败的提示，以及最近一次执行的SQL语句，类似这样：

文章更新成功！
最近一次执行的SQL语句： UPDATE wp_posts SET post_title = 'Updated Title' WHERE ID = 1

场景三：自定义查询

如果你需要执行一些比较复杂的SQL查询，可以使用$wpdb->get_results()函数。例如，查询所有文章的ID和标题：

global $wpdb;

$query = "SELECT ID, post_title FROM {$wpdb->posts}";
$results = $wpdb->get_results( $query );

if ( $results ) {
    echo "<ul>";
    foreach ( $results as $result ) {
        echo "<li>ID: " . $result->ID . ", 标题: " . $result->post_title . "</li>";
    }
    echo "</ul>";
} else {
    echo "没有找到文章！";
}

echo "<br>";
echo "最近一次执行的SQL语句： " . $wpdb->last_query;

运行这段代码，你会在页面上看到所有文章的ID和标题，以及最近一次执行的SQL语句，类似这样：

* ID: 1, 标题: Updated Title
* ID: 2, 标题: Sample Page
...
最近一次执行的SQL语句： SELECT ID, post_title FROM wp_posts

四、last_query的注意事项：坑与防坑

虽然last_query很好用，但也有一些需要注意的地方。

只保存最近一次的查询： last_query 属性只会保存最近一次执行的SQL语句。如果你在一个函数中执行了多次查询，那么last_query只会保存最后一次查询的语句。
只保存成功的查询： 如果你的SQL语句有语法错误，或者数据库连接失败，last_query可能不会保存任何内容，或者保存的是一些错误信息。
prepare()函数的重要性： 永远不要直接拼接SQL语句，而要使用 $wpdb->prepare() 函数来预处理SQL语句，防止SQL注入攻击。

五、进阶技巧：追踪所有查询

如果在一个请求中执行了多次查询，而你想追踪所有的查询语句，怎么办呢？可以使用以下方法：

自定义函数： 创建一个自定义函数，在每次执行查询后，将SQL语句保存到一个数组中。

$all_queries = array();

function my_wpdb_query( $query ) {
    global $wpdb, $all_queries;
    $all_queries[] = $query;
    return $wpdb->query( $query );
}

// 使用示例
global $wpdb;
$query1 = "SELECT * FROM {$wpdb->posts} WHERE ID = 1";
my_wpdb_query( $query1 );

$query2 = "SELECT * FROM {$wpdb->options} WHERE option_name = 'siteurl'";
my_wpdb_query( $query2 );

echo "<pre>";
print_r( $all_queries );
echo "</pre>";

插件： 已经有一些WordPress插件可以记录所有的SQL查询。你可以搜索并安装这些插件，方便地查看所有的SQL语句。
使用SAVEQUERIES常量 (不推荐生产环境): 在wp-config.php文件中定义SAVEQUERIES常量为true。这将使wpdb对象保存所有查询，并可以通过$wpdb->queries数组访问它们。但是，这种方法会显著降低性能，因此不建议在生产环境中使用。
```
// 在 wp-config.php 中
define( 'SAVEQUERIES', true );

// 在你的代码中
global $wpdb;
// 执行一些查询...

if ( defined( 'SAVEQUERIES' ) && SAVEQUERIES ) {
    echo "<pre>";
    print_r( $wpdb->queries );
    echo "</pre>";
}
```

六、总结：SQL调试的瑞士军刀

wpdb->last_query 属性就像一把瑞士军刀，虽然简单，但非常实用。它可以帮助你快速定位SQL错误，提高开发效率。记住，良好的SQL调试习惯是成为优秀WordPress开发者的必备技能。

七、Q&A环节

好了，今天的讲座就到这里。现在进入Q&A环节，大家有什么问题可以提出来，SQL猎手会尽力解答。

(停顿，等待提问)

如果没有问题，那我们今天的课程就到此结束。希望大家以后在WordPress开发中，都能熟练运用wpdb->last_query，成为SQL调试的高手！下次再见！

表格总结:

属性/方法	描述	用途
`$wpdb`	WordPress 全局数据库对象，提供数据库交互功能。	执行数据库查询、插入、更新、删除等操作。
`$wpdb->last_query`	保存最近一次执行的 SQL 查询语句。	调试 SQL 语句，查看 WordPress 底层执行的 SQL 语句，检查 SQL 语句是否正确。
`$wpdb->prepare()`	预处理 SQL 语句，防止 SQL 注入攻击。	安全地构建 SQL 语句，避免直接拼接字符串导致的安全漏洞。
`$wpdb->query()`	执行一个 SQL 查询（通常用于 INSERT、UPDATE、DELETE 等操作）。	执行非 SELECT 类型的 SQL 语句，返回影响的行数或 FALSE (出错时)。
`$wpdb->get_var()`	执行一个 SQL 查询，返回单个变量。	获取单个值，例如文章标题、选项值等。
`$wpdb->get_results()`	执行一个 SQL 查询，返回结果集（通常用于 SELECT 操作）。	获取多个结果，例如所有文章、所有选项等。
`SAVEQUERIES`	一个常量，如果定义为 true，则 `$wpdb->queries` 数组将保存所有执行的 SQL 查询（不推荐在生产环境中使用，因为它会降低性能）。	调试和分析所有执行的 SQL 查询，但仅用于开发环境。

代码示例总结:

代码示例	描述
`php<br>global $wpdb;<br><br>$post_id = 1;<br>$query = $wpdb->prepare(<br> "SELECT post_title FROM {$wpdb->posts} WHERE ID = %d",<br> $post_id<br>);<br>$result = $wpdb->get_var( $query );<br><br>if ( $result ) {<br> echo "文章标题： " . $result;<br>} else {<br> echo "没有找到文章！";<br>}<br><br>echo "<br>";<br>echo "最近一次执行的SQL语句： " . $wpdb->last_query;<br>` \| 查询文章标题，并输出最近一次执行的SQL语句。使用 `$wpdb->prepare()` 防止SQL注入。使用 `$wpdb->get_var()` 获取单个变量结果。使用 `$wpdb->last_query` 获取最后执行的SQL查询。
`php<br>global $wpdb;<br><br>$post_id = 1;<br>$new_title = 'Updated Title';<br><br>$query = $wpdb->prepare(<br> "UPDATE {$wpdb->posts} SET post_title = %s WHERE ID = %d",<br> $new_title,<br> $post_id<br>);<br><br>$result = $wpdb->query( $query );<br><br>if ( $result !== false ) {<br> echo "文章更新成功！";<br>} else {<br> echo "文章更新失败！";<br>}<br><br>echo "<br>";<br>echo "最近一次执行的SQL语句： " . $wpdb->last_query;<br>` \| 更新文章标题，并输出最近一次执行的SQL语句。使用 `$wpdb->prepare()` 防止SQL注入。使用 `$wpdb->query()` 执行更新查询。使用 `$wpdb->last_query` 获取最后执行的SQL查询。
`php<br>global $wpdb;<br><br>$query = "SELECT ID, post_title FROM {$wpdb->posts}";<br>$results = $wpdb->get_results( $query );<br><br>if ( $results ) {<br> echo "<ul>";<br> foreach ( $results as $result ) {<br> echo "<li>ID: " . $result->ID . ", 标题: " . $result->post_title . "</li>";<br> }<br> echo "</ul>";<br>} else {<br> echo "没有找到文章！";<br>}<br><br>echo "<br>";<br>echo "最近一次执行的SQL语句： " . $wpdb->last_query;<br>` \| 查询所有文章的ID和标题，并输出最近一次执行的SQL语句。使用 `$wpdb->get_results()` 获取多个结果。循环遍历结果集，显示文章ID和标题。使用 `$wpdb->last_query` 获取最后执行的SQL查询。
`php<br>$all_queries = array();<br><br>function my_wpdb_query( $query ) {<br> global $wpdb, $all_queries;<br> $all_queries[] = $query;<br> return $wpdb->query( $query );<br>}<br><br>// 使用示例<br>global $wpdb;<br>$query1 = "SELECT * FROM {$wpdb->posts} WHERE ID = 1";<br>my_wpdb_query( $query1 );<br><br>$query2 = "SELECT * FROM {$wpdb->options} WHERE option_name = 'siteurl'";<br>my_wpdb_query( $query2 );<br><br>echo "<pre>";<br>print_r( $all_queries );<br>echo "</pre>";<br>` \| 自定义函数 `my_wpdb_query()` 用于记录所有执行的SQL查询。每次调用 `my_wpdb_query()` 都会将查询语句添加到 `$all_queries` 数组中。最后，打印 `$all_queries` 数组以查看所有查询。
`php<br>// 在 wp-config.php 中<br>define( 'SAVEQUERIES', true );<br><br>// 在你的代码中<br>global $wpdb;<br>// 执行一些查询...<br><br>if ( defined( 'SAVEQUERIES' ) && SAVEQUERIES ) {<br> echo "<pre>";<br> print_r( $wpdb->queries );<br> echo "</pre>";<br>}<br>` \| 使用 `SAVEQUERIES` 常量记录所有执行的SQL查询 (不推荐生产环境)。在 `wp-config.php` 中定义 `SAVEQUERIES` 为 `true`。使用 `$wpdb->queries` 数组访问所有查询。注意：这种方法会显著降低性能，因此不建议在生产环境中使用。

代码示例	描述
`php<br>global $wpdb;<br><br>$post_id = 1;<br>$query = $wpdb->prepare(<br> "SELECT post_title FROM {$wpdb->posts} WHERE ID = %d",<br> $post_id<br>);<br>$result = $wpdb->get_var( $query );<br><br>if ( $result ) {<br> echo "文章标题： " . $result;<br>} else {<br> echo "没有找到文章！";<br>}<br><br>echo "<br>";<br>echo "最近一次执行的SQL语句： " . $wpdb->last_query;<br>` \| 查询文章标题，并输出最近一次执行的SQL语句。使用 `$wpdb->prepare()` 防止SQL注入。使用 `$wpdb->get_var()` 获取单个变量结果。使用 `$wpdb->last_query` 获取最后执行的SQL查询。
`php<br>global $wpdb;<br><br>$post_id = 1;<br>$new_title = 'Updated Title';<br><br>$query = $wpdb->prepare(<br> "UPDATE {$wpdb->posts} SET post_title = %s WHERE ID = %d",<br> $new_title,<br> $post_id<br>);<br><br>$result = $wpdb->query( $query );<br><br>if ( $result !== false ) {<br> echo "文章更新成功！";<br>} else {<br> echo "文章更新失败！";<br>}<br><br>echo "<br>";<br>echo "最近一次执行的SQL语句： " . $wpdb->last_query;<br>` \| 更新文章标题，并输出最近一次执行的SQL语句。使用 `$wpdb->prepare()` 防止SQL注入。使用 `$wpdb->query()` 执行更新查询。使用 `$wpdb->last_query` 获取最后执行的SQL查询。
`php<br>global $wpdb;<br><br>$query = "SELECT ID, post_title FROM {$wpdb->posts}";<br>$results = $wpdb->get_results( $query );<br><br>if ( $results ) {<br> echo "<ul>";<br> foreach ( $results as $result ) {<br> echo "<li>ID: " . $result->ID . ", 标题: " . $result->post_title . "</li>";<br> }<br> echo "</ul>";<br>} else {<br> echo "没有找到文章！";<br>}<br><br>echo "<br>";<br>echo "最近一次执行的SQL语句： " . $wpdb->last_query;<br>` \| 查询所有文章的ID和标题，并输出最近一次执行的SQL语句。使用 `$wpdb->get_results()` 获取多个结果。循环遍历结果集，显示文章ID和标题。使用 `$wpdb->last_query` 获取最后执行的SQL查询。
`php<br>$all_queries = array();<br><br>function my_wpdb_query( $query ) {<br> global $wpdb, $all_queries;<br> $all_queries[] = $query;<br> return $wpdb->query( $query );<br>}<br><br>// 使用示例<br>global $wpdb;<br>$query1 = "SELECT * FROM {$wpdb->posts} WHERE ID = 1";<br>my_wpdb_query( $query1 );<br><br>$query2 = "SELECT * FROM {$wpdb->options} WHERE option_name = 'siteurl'";<br>my_wpdb_query( $query2 );<br><br>echo "<pre>";<br>print_r( $all_queries );<br>echo "</pre>";<br>` \| 自定义函数 `my_wpdb_query()` 用于记录所有执行的SQL查询。每次调用 `my_wpdb_query()` 都会将查询语句添加到 `$all_queries` 数组中。最后，打印 `$all_queries` 数组以查看所有查询。
`php<br>// 在 wp-config.php 中<br>define( 'SAVEQUERIES', true );<br><br>// 在你的代码中<br>global $wpdb;<br>// 执行一些查询...<br><br>if ( defined( 'SAVEQUERIES' ) && SAVEQUERIES ) {<br> echo "<pre>";<br> print_r( $wpdb->queries );<br> echo "</pre>";<br>}<br>` \| 使用 `SAVEQUERIES` 常量记录所有执行的SQL查询 (不推荐生产环境)。在 `wp-config.php` 中定义 `SAVEQUERIES` 为 `true`。使用 `$wpdb->queries` 数组访问所有查询。注意：这种方法会显著降低性能，因此不建议在生产环境中使用。

发表回复 取消回复

发表回复取消回复