wp_signon() | WordPress自定义用户登录函数

函数

wp_signon($credentials, $secure_cookie);

描述

wp_signon() 函数的作用是验证用户名和密码后授权用户登录，简单点理解就是用户提交用户名和密码后经过 wp_signon() 验证，验证成功返回 WP_User 信息，验证失败则返回 WP_Error 的信息。该函数常用于开发 WordPress 前台登录表单功能，是 WordPress 2.5 版本之后替代 wp_login() 的一个 WordPress 函数。

参数

$credentials – （数组）（可选），提交的登录信息，如用户名、密码，默认值为空数组 array()。

$secure_cookie – （字符串或布尔型）（可选），是否使用安全 Cookie，默认值为空。
提示：如果 $credentials 为空，则默认使用 $_POST['log']、$_POST['pwd']、$_POST['remember'] 传递过来的值，等于为空。

返回值

成功返回 WP_User，失败返回 WP_Error。

$creds = array();
$creds['user_login'] = 'WordPress 迷';
$creds['user_password'] = 'wordpressmi';
$creds['remember'] = true;
$user = wp_signon( $creds, false); //登陆，并把回的信息附值给变量 $user
if(is_wp_error($user)) {
	wp_die('登录失败');
	exit();
}else {
	wp_safe_redirect('https://maosiji.com/'); //登录成功，跳转到指定页面
	exit();
}

源文件

wp-includes/user.php