check_ajax_referer函数是WordPress中用于验证AJAX请求是否来自当前站点的函数。它主要用于防止CSRF(跨站请求伪造)攻击。

check_ajax_referer函数的用法如下:

1. 语法:check_ajax_referer( $action, $query_args = false, $die = true )

- $action(必需):表示用于验证的动作名称。在发送AJAX请求时,可以通过在请求数据中添加一个名为'action'的参数来指定这个动作名称。

- $query_args(可选):是一个关联数组,表示额外的查询参数。这些查询参数将被添加到验证哈希中,以增加验证的安全性。

- $die(可选):表示当验证失败时是否终止脚本执行。默认值为true,即验证失败会终止脚本执行,可以通过设置为false来禁用此功能。

2. 返回值:如果验证通过,则函数不会返回任何值。如果验证失败并且$die参数设置为true,则会输出一条错误消息并终止脚本执行。如果验证失败并且$die参数设置为false,则函数会返回false。

使用示例:

add_action( 'wp_ajax_my_ajax_action', 'my_ajax_function' );
add_action( 'wp_ajax_nopriv_my_ajax_action', 'my_ajax_function' );

function my_ajax_function() {
// 验证AJAX请求
check_ajax_referer( 'my_ajax_nonce', 'nonce' );

// 在这里编写你的AJAX处理代码

wp_send_json_success( 'Success message' );
}

在上面的示例中,我们首先使用`add_action()`函数将`my_ajax_function`函数添加为`wp_ajax_my_ajax_action`和`wp_ajax_nopriv_my_ajax_action`两个AJAX处理的回调函数。

然后,在`my_ajax_function`中,我们通过调用`check_ajax_referer`函数来验证AJAX请求。这里我们指定了动作名称为`my_ajax_nonce`,并通过'nonce'参数传递了客户端发送的验证哈希。

如果验证通过,我们可以在函数中编写具体的AJAX处理代码。

最后,我们使用`wp_send_json_success`函数将成功消息以JSON格式返回给客户端。