wordpress函数：wp_signon() 用户登录

wp_signon() 函数常用于用户提交登录表单后的登录，区别于 wp_set_current_user() 一般用于注册后登录，后者无需用户密码即可登录。

函数介绍

wp_signon() 函数用于授权给用户登录wordpress并可记住该用户名称。该函数取代了wp_login。

WordPress 2.5版本起启用。

函数使用

<?php wp_signon( $credentials, $secure_cookie ) ?>

参数说明

$credentials (array) (可选) 登录用户数据 Default: None

$secure_cookie (boolean) (可选) 是否使用安全cookie Default: None

注：若 $credentials 为空，wp_signon()默认使用 $_POST 参数键值：“log”，“pwd” 和 “rememberme”。

返回值

(object) 登录失败返回对象WP_Error，登录成功则返回WP_User

函数实例

$creds = array();
$creds['user_login'] = 'admin';  //也可通过表单提交获取
$creds['user_password'] = '123456';
$creds['remember'] = true;
$user = wp_signon( $creds, false );
if( is_wp_error($user) )
	echo $user->get_error_message();

函数位置

wp_signon() 位于 wp-includes/user.php

拓展参考

函数 wp_set_current_user()