Uc user login

出自Discuz! 技术文库

uc_user_login

array uc_user_login(string username , string password [, bool isuid , bool checkques , integer questionid , string answer])

目录 1 描述 2 参数 3 范例 4 返回值

描述

本接口函数用于用户的登录验证，用户名及密码正确无误则返回用户在 UCenter 的基本数据，否则返回相应的错误信息。如果应用程序是升级过来的，并且当前登录用户和已有用户重名，那么返回的数组中 [4] 的值将返回 1。

参数

参数名	类型	是否必需	说明	备注
username	string	是	用户名 / 用户 ID / 用户 E-mail
password	string	是	密码
isuid	bool	否	是否使用用户 ID登录	1:使用用户 ID登录 2:使用用户 E-mail登录 0:(默认值) 使用用户名登录
checkques	bool	否	是否验证安装提问	1:验证安全提问 0:(默认值) 不验证安全提问
questionid	integer	否	安全提问索引
answer	string	否	安全提问答案

范例

list($uid, $username, $password, $email) = uc_user_login($_POST['username'], $_POST['password']);
if($uid > 0) {
	echo '登录成功';
} elseif($uid == -1) {
	echo '用户不存在,或者被删除';
} elseif($uid == -2) {
	echo '密码错';
} else {
	echo '未定义';
}

返回值

返回值类型	说明	备注
array	成功返回用户信息，失败返回错误代码	数组结构看下方说明

返回值数组结构

key	类型	value
0	integer	大于 0:返回用户 ID，表示用户登录成功 -1:用户不存在，或者被删除 -2:密码错 -3:安全提问错
1	string	用户名
2	string	密码
3	string	Email
4	bool	用户名是否重名