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格式返回给客户端。
0 个评论