auth_redirect函数是WordPress提供的一个用于身份验证重定向的函数。它用于在用户未登录时,将用户重定向到登录页面。以下是auth_redirect函数的详细用法解析:

1. 函数定义:
auth_redirect函数的定义如下:

function auth_redirect( $redirect_to = '', $status = 302, $secure = null ) {
// ...
}

2. 参数说明:
- $redirect_to(可选):指定用户登录后要重定向到的页面。默认为空,表示重定向到当前页面。
- $status(可选):指定重定向的HTTP状态码,默认为302。
- $secure(可选):指定是否强制使用HTTPS进行重定向,默认为null。当$secure为true时,将使用HTTPS;当$secure为false时,将使用HTTP。

3. 函数功能:
auth_redirect函数的主要功能是在用户未登录时,将用户重定向到登录页面。它会检查用户是否已登录,如果用户未登录,则会重定向到登录页面,并在重定向时传递$redirect_to参数指定要重定向到的页面。

4. 使用示例:
下面是一个使用auth_redirect函数的示例:

在上面的示例中,我们创建了一个自定义模板,并在模板的开始处使用了auth_redirect函数。当用户访问该自定义模板时,如果用户未登录,则会被重定向到登录页面,并在登录后返回到当前页面。

总结:
auth_redirect函数是WordPress中用于身份验证重定向的一个函数。它会检查用户是否已登录,如果用户未登录,则会重定向到登录页面。可以通过$redirect_to参数指定重定向后要返回的页面,通过$status参数指定重定向的HTTP状态码,通过$secure参数指定是否强制使用HTTPS进行重定向。