check_admin_referer是WordPress中一个非常重要的钩子函数，用于验证提交的请求是否来自合法的来源页面。它主要用于保护WordPress后台的安全性，防止跨站请求伪造（CSRF）攻击。
使用check_admin_referer函数需要提供两个参数，分别是$action和$query_arg。
1. $action参数是一个字符串，用于标识当前请求的动作。这个参数是必选的，并且在验证时必须与请求中的$action参数值保持一致。可以使用任意字符串作为$action的值，但建议使用唯一且容易辨识的值。
2. $query_arg参数是一个字符串，用于指定在请求中传递$action参数值的参数名。这个参数是可选的，默认为false。如果指定了$query_arg参数，则必须将$action参数值作为请求中的$query_arg参数传递。
在使用check_admin_referer函数时，通常会将其放在一个if语句中进行条件判断。如果验证失败，则可以执行一些错误处理的逻辑，例如输出错误提示信息、重定向到其他页面等。
下面是check_admin_referer函数的示例用法：
if ( isset( $_REQUEST['submit'] ) ) {
// 验证请求是否来自合法的来源页面
check_admin_referer( 'my_action', 'my_action_nonce' );
// 在这里执行提交请求的处理逻辑
} else {
// 显示表单页面
}
在上面的示例中，假设有一个提交表单的页面，在表单中有一个名为submit的提交按钮。当用户点击提交按钮时，会将代表动作的$action和对应的nonce值一起提交到服务端。然后，使用check_admin_referer函数验证请求是否来自合法的来源页面，如果验证成功，则执行提交请求的处理逻辑。
在表单中，需要添加一个隐藏的nonce字段，用于存放$action的值。这个字段在提交表单时，由WordPress自动生成并添加到表单中。可以使用wp_nonce_field函数来生成nonce字段。
总结：check_admin_referer是WordPress中用于验证请求来源的钩子函数，用于防止跨站请求伪造攻击。使用时需要提供$action参数和$query_arg参数，并将check_admin_referer函数放在一个if语句中进行条件判断。在表单中，需要添加一个隐藏的nonce字段，用于存放$action的值。
0 个评论