WordPress自定义用户登录函数wp_signon()使用手册
wp_signon()
函数的作用是验证用户名和密码后授权用户登录,简单点理解就是用户提交用户名和密码后经过wp_signon()
验证,验证成功返回WP_User信息,验证失败则返回WP_Error的信息。该函数常用于开发WordPress前台登录表单功能,是WordPress 2.5版本之后替代wp_login()
的一个WordPress函数。
函数结构
1 |
<?php wp_signon($credentials, $secure_cookie);?> |
参数说明:
$credentials – (数组)(可选),提交的登录信息,如用户名、密码,默认值为空数组array()
。
$secure_cookie – (字符串或布尔型)(可选),是否使用安全Cookie,默认值为空。
提示:如果$credentials
为空,则默认使用$_POST['log']
、$_POST['pwd']
、$_POST['remember']
传递过来的值,等于为空。
返回值:
成功返回WP_User,失败返回WP_Error
示例
1 2 3 4 5 6 7 8 9 10 11 12 |
$creds = array(); $creds['user_login'] = '博客吧'; $creds['user_password'] = '1234567890'; $creds['remember'] = true; $user = wp_signon( $creds, false); //登陆,并把回的信息附值给变量$user if(is_wp_error($user)) { wp_die('登录失败'); exit(); }else { wp_safe_redirect('http://www.boke8.net/'); //登录成功,跳转到指定页面 exit(); } |
函数位置
文件:wp-includes/user.php
THE END