integer uc_user_register(string username , string password , string email)
函数参数
参数 string username string password string email
含义
用户名
密码
电子邮件
返回值
值 integer
含义
大于 0:返回用户 ID,表示用户注册成功
-1:用户名不合法
-2:包含不允许注册的词语
-3:用户名已经存在
-4:Email 格式有误
-5:Email 不允许注册
-6:该 Email 已经被注册
本接口函数用于新用户的注册。用户名、密码、Email 为一个用户在 UCenter 的基本数据,提交后 UCenter 会按照注册设置和词语过滤的规则检测用户名和 Email 的格式是否正确合法,如果正确则返回注册后的用户 ID,否则返回相应的错误信息。
用户登录
array uc_user_login(string username , string password [, bool isuid])
函数参数
参数 string username string password bool isuid
含义
用户名 / 用户 ID
密码
是否使用用户 ID登录
1:使用用户 ID登录
0:(默认值) 使用用户名登录
返回值
值 arrayinteger [0] string [1] string [2] string [3] bool [4]
含义
大于 0:返回用户 ID,表示用户登录成功
-1:用户不存在,或者被删除
-2:密码错
用户名
密码
用户名是否重名
本接口函数用于用户的登录验证,用户名及密码正确无误则返回用户在 UCenter 的基本数据,否则返回相应的错误信息。如果应用程序是升级过来的,并且当前登录用户和已有用户重名,那么返回的数组中 [4] 的值将返回 1。
获取用户数据
array uc_get_user(string username [, bool isuid])
函数参数
参数 string username bool isuid
含义
用户名
是否使用用户 ID获取
1:使用用户 ID获取
0:(默认值) 使用用户名获取
返回值
值 arrayinteger [0] string [1] string [2]
含义
用户 ID
用户名
本接口函数用于获取用户在 UCenter 的基本数据,如用户不存在,返回值为 integer 的数值 0。
更新用户资料
integer uc_user_edit(string username , string oldpw , string newpw , string email [, boolignoreoldpw])
函数参数
参数 string username string oldpw string newpw string email bool ignoreoldpw
含义
用户名
旧密码
新密码,如不修改为空
Email,如不修改为空
是否忽略旧密码
1:忽略,更改资料不需要验证密码
0:(默认值) 不忽略,更改资料需要验证密码
返回值
值 integer
含义
1:更新成功
0:没有做任何修改
-1:旧密码不正确
-4:Email 格式有误
-5:Email 不允许注册
-6:该 Email 已经被注册
-7:没有做任何修改
-8:该用户受保护无权限更改
本接口函数用于更新用户资料。更新资料需验证用户的原密码是否正确,除非指定 ignoreoldpw 为 1。如果只修改 Email 不修改密码,可让 newpw 为空;同理如果只修改密码不修改 Email,可让 email 为空。
删除用户
integer uc_user_delete(string/array username)
函数参数
参数 string username
含义
用户名
返回值
值 integer
含义
1:成功
0:失败
同步登录
string uc_user_synlogin(integer uid)
函数参数
参数 integer uid
含义
用户 ID
返回值
值 string
含义
同步登录的 HTML 代码
如果当前应用程序在 UCenter 中设置允许同步登录,那么本接口函数会通知其他设置了同步登录的应用程序登录,把返回的 HTML 输出在页面中即可完成对其它应用程序的通知。输出的 HTML 中包含执行远程的 javascript 脚本,请让页面在此脚本运行完毕后再进行跳转操作,否则可能会导致无法同步登录成功。同时要保证同步登录的正确有效,请保证其他应用程序的 Cookie 域和 Cookie 路径设置正确。
同步退出
string uc_user_synlogout()
返回值
值 string
含义
同步退出的 HTML 代码
如果当前应用程序在 UCenter 中设置允许同步登录,那么本接口函数会通知其他设置了同步登录的应用程序退出登录,把返回的 HTML 输出在页面中即可完成其它应用程序的通知。输出的 HTML 中包含执行远程的 javascript 脚本,请让页面在此脚本运行完毕后再进行跳转操作,否则可能会导致无法同步退出登录。同时要保证同步退出登录的正确有效,请保证其他应用程序的 Cookie 域和 Cookie 路径设置正确。
检查 Email 地址
integer uc_user_checkemail(string email)
函数参数
参数 string email
含义
返回值
值 integer
含义
1:成功
-4:Email 格式有误
-5:Email 不允许注册
-6:该 Email 已经被注册
本接口函数用于检查用户输入的 Email 的合法性。
检查用户名
integer uc_user_checkname(string username)
函数参数
参数 string username
含义
用户名
返回值
值 integer
含义
1:成功
-1:用户名不合法
-2:包含要允许注册的词语
-3:用户名已经存在
本接口函数用于检查用户输入的用户名的合法性。
添加保护用户
integer uc_user_addprotected(string/array username , string admin)
函数参数
参数 string/array username string admin
含义
保护用户名
操作的管理员
返回值
值 integer
含义
1:成功
-1:失败
本接口函数用于添加被保护的用户。
删除保护用户
integer uc_user_deleteprotected(string/array username)
函数参数
参数 string/array username
含义
保护用户名
返回值
值 integer
含义
1:成功
-1:失败
本接口函数用于删除被保护的用户。
得到受保护的用户名列表
integer uc_user_getprotected()
返回值
值 array
含义
受保护的用户数据
本接口函数用于获得被保护的用户列表。
把重名用户合并到 UCenter
integer uc_user_merge(string/ oldusername , string newusername, integer uid, stringpassword, string email)
函数参数
参数 string oldusername string newusername integer uid string password string email
含义
老用户名
新用户名
用户 ID
密码
电子邮件
返回值
值 integer
含义
大于 0:返回用户 ID,表示用户注册成功
-1:用户名不合法
-2:包含不允许注册的词语
-3:用户名已经存在
本接口函数用于把重名的用户合并到 UCenter。
用户的合并和用户重名的处理
如果您的应用程序集成到 UCenter 时包含旧的用户数据,我们建议您可以采取以下范例的方式把您的用户导入到 UCenter。 本方式的基本流程是:首先,获取当前 UCenter 中的最大用户 ID 的值。然后,读取应用程序自己的用户表,判读用户名是否在 UCenter 重复。如果重复,把重名的用户名保存到 UCenter 的 mergemembers 表中,不合并这个用户。如果不重名,则按正常方式导入用户进行合并。当用户插入到 mergemembers 表后,用户在这个应用程序登录的时候,登录状态的返回数组中 [4] 的值将返回 1(请参考上面关于 uc_user_login() 函数的说明)。当登录状态返回重名状态后建议您在应用程序中判读用户合法性后进行更名的处理,调用本接口函数。
2KB项目(www.2kb.com,源码交易平台),提供担保交易、源码交易、虚拟商品、在家创业、在线创业、任务交易、网站设计、软件设计、网络兼职、站长交易、域名交易、链接买卖、网站交易、广告买卖、站长培训、建站美工等服务 |