check_ajax_referer() 到底如何工作？

聪明的 WordPress 人们说 http://www.prelovac.com/vladimir/improving-security-in-wordpress-plugins-using-nonces插件开发人员应该在从页面发送回 WordPress 博客 (admin-ajax.php) 的每个 AJAX 请求中使用随机数。

这是通过 (1) 在服务器端生成一个随机数来完成的，通过

$nonce = wp_create_nonce  ('my-nonce');

...(2) 使该随机数可用于发送 AJAX 请求的 Javascript 代码。例如你可以这样做：

function myplg_emit_scriptblock() {
    $nonce = wp_create_nonce('myplg-nonce');
    echo "<script type='text/javascript'>\n" .
        " var WpPlgSettings = {\n" .
        "   ajaxurl : '" . admin_url( 'admin-ajax.php' ) . "',\n" .
        "   nonce : '" . $nonce . "'\n" .
        " };\n" .
        "</script>\n";
}
add_action('wp_print_scripts','myplg_emit_scriptblock');

...然后 (3) javascript ajax 逻辑引用该全局变量。

    var url = WpPlgSettings.ajaxurl +
        "?action=my-wp-plg-action&" +
        "nonce=" + WpPlgSettings .nonce +
        "docid=" + id;

    $.ajax({type: "GET",
            url: url,
            headers : { "Accept" : 'application/json' },
            dataType: "json",
            cache: false,
            error: function (xhr, textStatus, errorThrown) {
                ...
            },
            success: function (data, textStatus, xhr) {
                ...
            }
           });

...最后 (4) 在服务器端逻辑中检查接收到的随机数。

add_action( 'wp_ajax_nopriv_skydrv-hotlink', 'myplg_handle_ajax_request' );
add_action( 'wp_ajax_skydrv-hotlink', 'myplg_handle_ajax_request' );
function myplg_handle_ajax_request() {
    check_ajax_referer( 'myplg-nonce', 'nonce' );  // <<=-----
    if (isset($_GET['docid'])) {
        $docid = $_GET['docid'];
        $response = myplg_generate_the_response($docid);
        header( "Content-Type: application/json" );
        echo json_encode( $response ) ;
    }
    else {
        $response = array("error" => "you must specify a docid parameter.");
        echo json_encode( $response ) ;
    }

    exit;
}

但支票到底如何运作呢？

修改一些AJAX程序 https://stackoverflow.com/a/13614297/1287812，我也提出了同样的问题。这是一个简单的检查问题功能码 http://queryposts.com/function/check_ajax_referer/:

function check_ajax_referer( $action = -1, $query_arg = false, $die = true ) {
    if ( $query_arg )
        $nonce = $_REQUEST[$query_arg];
    else
        $nonce = isset($_REQUEST['_ajax_nonce']) ? $_REQUEST['_ajax_nonce'] : $_REQUEST['_wpnonce'];

    $result = wp_verify_nonce( $nonce, $action );

    if ( $die && false == $result ) {
        if ( defined( 'DOING_AJAX' ) && DOING_AJAX )
            wp_die( -1 );
        else
            die( '-1' );
    }

    do_action('check_ajax_referer', $action, $result);

    return $result;
}

If wp_verify_nonce is false并且你还没有发送false in the $die参数，然后就会执行wp_die( -1 );.

在您的示例代码中，check_ajax_referer()将中断执行并返回-1到 AJAX 调用。如果你想自己处理错误，请添加参数$die做你的事情$do_check:

$do_check = check_ajax_referer( 'myplg-nonce', 'nonce', false ); 

Note that the proper way to handle AJAX in WordPress is: register http://codex.wordpress.org/Function_Reference/wp_register_script, enqueue http://codex.wordpress.org/Function_Reference/wp_enqueue_script and localize http://codex.wordpress.org/Function_Reference/wp_localize_script the JavaScript files using wp_enqueue_scripts http://codex.wordpress.org/Plugin_API/Action_Reference/wp_enqueue_scripts instead of wp_print_scripts.
_{See Use wp_enqueue_scripts() not wp_print_styles() http://make.wordpress.org/core/2011/12/12/use-wp_enqueue_scripts-not-wp_print_styles-to-enqueue-scripts-and-styles-for-the-frontend/.}

Check this update in December 2020 from a core contributor ^{h/t: Rafael Atías https://stackoverflow.com/questions/10874571/how-does-check-ajax-referer-really-work/18358174?noredirect=1#comment127986378_18358174}:

显然我们现在应该使用wp_add_inline_script代替wp_localize_script公开脚本需要使用的全局对象。 https://developer.wordpress.org/reference/functions/wp_add_inline_script/#comment-4632