Uc user login
出自Discuz! 技术文库
uc_user_login
- array uc_user_login(string username , string password [, bool isuid , bool checkques , integer questionid , string answer])
目录 |
描述
本接口函数用于用户的登录验证,用户名及密码正确无误则返回用户在 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 | |
4 | bool | 用户名是否重名 |