client.php 解析

<?php

/**
* 文件名称:client.php
* 功能：通过调用这个文件的不同函数，寻找不同的控制器与不同的方法
*
* @copyright 2009 ymaozi Site:www.codedesign.cn
* QQ群:83400173
* 分析时间:2009-6-7
*/

if(!defined('UC_API')) {
exit('Access dened');
} //是否定义UC_API,在config.php定义的是ucenter的url

error_reporting(0); //屏蔽所有的错误

define('IN_UC', TRUE); //定义IN_UC,以防直接访问控制文件
define('UC_CLIENT_VERSION', '1.5.0'); //定义版本
define('UC_CLIENT_RELEASE', '20081212'); //定义版本更新时间
define('UC_ROOT', substr(__FILE__, 0, -10)); //note 用户中心客户端的根目录 UC_CLIENTROOT
define('UC_DATADIR', UC_ROOT.'./data/'); //note 用户中心的数据缓存目录
define('UC_DATAURL', UC_API.'/data'); //note 用户中心的数据 URL
define('UC_API_FUNC', UC_CONNECT == 'mysql' ? 'uc_api_mysql' : 'uc_api_post'); //如果数据库是mysql则执行uc_api_mysql()函数,否则则执行uc_api_post
$GLOBALS['uc_controls'] = array(); //定义一全局数组
/**
* 在执行sql语句时，在需要在某些字符前加上了反斜线，这些字符有单引号(')、双引号(")、反斜线(/)
*
* @param string/array $string 如果$string 为字符串，则直接用转换，如果是数组的话，通过foreach循环遂个进行转换
* @param bool $force
* @param bool $strip
* @return string
* get_magic_quotes_gpc():本函式取得 PHP 环境设定的变数 magic_quotes_gpc (GPC, Get/Post/Cookie) 值。如果传回0为关闭，1为打开
* string addslashes(string str) 在某些字符前加上了反斜线
* string stripslashes (string str) 将用addslashes()函数处理后的字符串返回原样。
*/<span id="more-69"></span>
function uc_addslashes($string, $force = 0, $strip = FALSE) {
!defined('MAGIC_QUOTES_GPC') &amp;&amp; define('MAGIC_QUOTES_GPC', get_magic_quotes_gpc()); //是否定义MAGIC_QUOTES_GPC,没有的话就定义
if(!MAGIC_QUOTES_GPC || $force) {
if(is_array($string)) {
foreach($string as $key => $val) {
$string[$key] = uc_addslashes($val, $force, $strip);
}
} else {
$string = addslashes($strip ? stripslashes($string) : $string);
}
}
return $string;
}
//判断是否存在daddslashes函数，如果不存在则定义
if(!function_exists('daddslashes')) {

/**
* 在需要在某些字符前加上了反斜线
*
* @param string $string
* @param bool $force
* @return string
*/
function daddslashes($string, $force = 0) {
return uc_addslashes($string, $force);
}
}

/**
* 将用addslashes()函数处理后的字符串返回原样
*
* @param string $string
* @return string
*/
function uc_stripslashes($string) {
!defined('MAGIC_QUOTES_GPC') &amp;&amp; define('MAGIC_QUOTES_GPC', get_magic_quotes_gpc());
if(MAGIC_QUOTES_GPC) {
return stripslashes($string);
} else {
return $string;
}
}

/**
* dfopen 方式取指定的模块和动作的数据
*
* @param string $module 请求的模块
* @param string $action 请求的动作
* @param array $arg 参数（会加密的方式传送）
* @return string
*/
function uc_api_post($module, $action, $arg = array()) {
$s = $sep = '';
foreach($arg as $k => $v) {
$k = urlencode($k);
if(is_array($v)) {
$s2 = $sep2 = '';
foreach($v as $k2 => $v2) {
$k2 = urlencode($k2);
$s2 .= "$sep2{$k}[$k2]=".urlencode(uc_stripslashes($v2));
$sep2 = '&amp;';
}
$s .= $sep.$s2;
} else {
$s .= "$sep$k=".urlencode(uc_stripslashes($v));
}
$sep = '&amp;';
}
$postdata = uc_api_requestdata($module, $action, $s);
return uc_fopen2(UC_API.'/index.php', 500000, $postdata, '', TRUE, UC_IP, 20);
}

/**
* 构造发送给用户中心的请求数据
*
* @param string $module 请求的模块
* @param string $action 请求的动作
* @param string $arg 参数（会加密的方式传送）
* @param string $extra 附加参数（传送时不加密）
* @return string
*/
function uc_api_requestdata($module, $action, $arg='', $extra='') {
$input = uc_api_input($arg);
$post = "m=$module&amp;a=$action&amp;inajax=2&amp;release=".UC_CLIENT_RELEASE."&amp;input=$input&amp;appid=".UC_APPID.$extra;
return $post;
}

function uc_api_url($module, $action, $arg='', $extra='') {
$url = UC_API.'/index.php?'.uc_api_requestdata($module, $action, $arg, $extra);
return $url;
}

function uc_api_input($data) {
$s = urlencode(uc_authcode($data.'&amp;agent='.md5($_SERVER['HTTP_USER_AGENT'])."&amp;time=".time(), 'ENCODE', UC_KEY));
return $s;
}

/**
* MYSQL 方式取指定的模块和动作的数据
*
* @param string $model 请求的模块
* @param string $action 请求的动作
* @param string $args 参数（会加密的方式传送）
* @return mix
*/
function uc_api_mysql($model, $action, $args=array()) {
global $uc_controls;
if(empty($uc_controls[$model])) {
include_once UC_ROOT.'./lib/db.class.php';
include_once UC_ROOT.'./model/base.php';
include_once UC_ROOT."./control/$model.php";
eval("/$uc_controls['$model'] = new {$model}control();");
}
if($action{0} != '_') {
$args = uc_addslashes($args, 1, TRUE);
$action = 'on'.$action;

$uc_controls[$model]->input = $args;
return $uc_controls[$model]->$action($args);
} else {
return '';
}
}

/**
* 将数组转换成xml
*
* @param arrau $arr
* @param bool $htmlon
* @return string
*/
function uc_serialize($arr, $htmlon = 0) {
include_once UC_ROOT.'./lib/xml.class.php';
return xml_serialize($arr, $htmlon);
}

/**
* 将xml转换成为数组
*
* @param stromg $s
* @return array
*/
function uc_unserialize($s) {
include_once UC_ROOT.'./lib/xml.class.php';
return xml_unserialize($s);
}

/**
* 字符串加密以及解密函数
*
* @param string $string 原文或者密文
* @param string $operation 操作(ENCODE | DECODE), 默认为 DECODE
* @param string $key 密钥
* @param int $expiry 密文有效期, 加密时候有效， 单位 秒，0 为永久有效
* @return string 处理后的 原文或者 经过 base64_encode 处理后的密文
*
* @example
*
* $a = authcode('abc', 'ENCODE', 'key');
* $b = authcode($a, 'DECODE', 'key'); // $b(abc)
*
* $a = authcode('abc', 'ENCODE', 'key', 3600);
* $b = authcode('abc', 'DECODE', 'key'); // 在一个小时内，$b(abc)，否则 $b 为空
*/
function uc_authcode($string, $operation = 'DECODE', $key = '', $expiry = 0) {

$ckey_length = 4; //note 随机密钥长度 取值 0-32;
//note 加入随机密钥，可以令密文无任何规律，即便是原文和密钥完全相同，加密结果也会每次不同，增大破解难度。
//note 取值越大，密文变动规律越大，密文变化 = 16 的 $ckey_length 次方
//note 当此值为 0 时，则不产生随机密钥

$key = md5($key ? $key : UC_KEY);
$keya = md5(substr($key, 0, 16));
$keyb = md5(substr($key, 16, 16));
$keyc = $ckey_length ? ($operation == 'DECODE' ? substr($string, 0, $ckey_length): substr(md5(microtime()), -$ckey_length)) : '';

$cryptkey = $keya.md5($keya.$keyc);
$key_length = strlen($cryptkey);

$string = $operation == 'DECODE' ? base64_decode(substr($string, $ckey_length)) : sprintf('%010d', $expiry ? $expiry + time() : 0).substr(md5($string.$keyb), 0, 16).$string;
$string_length = strlen($string);

$result = '';
$box = range(0, 255);

$rndkey = array();
for($i = 0; $i <= 255; $i++) {
$rndkey[$i] = ord($cryptkey[$i % $key_length]);
}

for($j = $i = 0; $i < 256; $i++) {
$j = ($j + $box[$i] + $rndkey[$i]) % 256;
$tmp = $box[$i];
$box[$i] = $box[$j];
$box[$j] = $tmp;
}

for($a = $j = $i = 0; $i < $string_length; $i++) {
$a = ($a + 1) % 256;
$j = ($j + $box[$a]) % 256;
$tmp = $box[$a];
$box[$a] = $box[$j];
$box[$j] = $tmp;
$result .= chr(ord($string[$i]) ^ ($box[($box[$a] + $box[$j]) % 256]));
}

if($operation == 'DECODE') {
if((substr($result, 0, 10) == 0 || substr($result, 0, 10) - time() > 0) &amp;&amp; substr($result, 10, 16) == substr(md5(substr($result, 26).$keyb), 0, 16)) {
return substr($result, 26);
} else {
return '';
}
} else {
return $keyc.str_replace('=', '', base64_encode($result));
}
}

/**
* 远程打开URL
* @param string $url 打开的url，　如 http://www.baidu.com/123.htm
* @param int $limit 取返回的数据的长度
* @param string $post 要发送的 POST 数据，如uid=1&amp;password=1234
* @param string $cookie 要模拟的 COOKIE 数据，如uid=123&amp;auth=a2323sd2323
* @param bool $bysocket TRUE/FALSE 是否通过SOCKET打开
* @param string $ip IP地址
* @param int $timeout 连接超时时间
* @param bool $block 是否为阻塞模式
* @return 取到的字符串
*/
function uc_fopen2($url, $limit = 0, $post = '', $cookie = '', $bysocket = FALSE, $ip = '', $timeout = 15, $block = TRUE) {
$__times__ = isset($_GET['__times__']) ? intval($_GET['__times__']) + 1 : 1;
if($__times__ > 2) {
return '';
}
$url .= (strpos($url, '?') === FALSE ? '?' : '&amp;')."__times__=$__times__";
return uc_fopen($url, $limit, $post, $cookie, $bysocket, $ip, $timeout, $block);
}

function uc_fopen($url, $limit = 0, $post = '', $cookie = '', $bysocket = FALSE, $ip = '', $timeout = 15, $block = TRUE) {
$return = '';
$matches = parse_url($url);
!isset($matches['host']) &amp;&amp; $matches['host'] = '';
!isset($matches['path']) &amp;&amp; $matches['path'] = '';
!isset($matches['query']) &amp;&amp; $matches['query'] = '';
!isset($matches['port']) &amp;&amp; $matches['port'] = '';
$host = $matches['host'];
$path = $matches['path'] ? $matches['path'].($matches['query'] ? '?'.$matches['query'] : '') : '/';
$port = !empty($matches['port']) ? $matches['port'] : 80;
if($post) {
$out = "POST $path HTTP/1.0/r/n";
$out .= "Accept: */*/r/n";
//$out .= "Referer: $boardurl/r/n";
$out .= "Accept-Language: zh-cn/r/n";
$out .= "Content-Type: application/x-www-form-urlencoded/r/n";
$out .= "User-Agent: $_SERVER[HTTP_USER_AGENT]/r/n";
$out .= "Host: $host/r/n";
$out .= 'Content-Length: '.strlen($post)."/r/n";
$out .= "Connection: Close/r/n";
$out .= "Cache-Control: no-cache/r/n";
$out .= "Cookie: $cookie/r/n/r/n";
$out .= $post;
} else {
$out = "GET $path HTTP/1.0/r/n";
$out .= "Accept: */*/r/n";
//$out .= "Referer: $boardurl/r/n";
$out .= "Accept-Language: zh-cn/r/n";
$out .= "User-Agent: $_SERVER[HTTP_USER_AGENT]/r/n";
$out .= "Host: $host/r/n";
$out .= "Connection: Close/r/n";
$out .= "Cookie: $cookie/r/n/r/n";
}
$fp = @fsockopen(($ip ? $ip : $host), $port, $errno, $errstr, $timeout);
if(!$fp) {
return '';//note $errstr : $errno /r/n
} else {
stream_set_blocking($fp, $block);
stream_set_timeout($fp, $timeout);
@fwrite($fp, $out);
$status = stream_get_meta_data($fp);
if(!$status['timed_out']) {
while (!feof($fp)) {
if(($header = @fgets($fp)) &amp;&amp; ($header == "/r/n" || $header == "/n")) {
break;
}
}

$stop = false;
while(!feof($fp) &amp;&amp; !$stop) {
$data = fread($fp, ($limit == 0 || $limit > 8192 ? 8192 : $limit));
$return .= $data;
if($limit) {
$limit -= strlen($data);
$stop = $limit <= 0;
}
}
}
@fclose($fp);
return $return;
}
}

function uc_app_ls() {
$return = call_user_func(UC_API_FUNC, 'app', 'ls', array());
return UC_CONNECT == 'mysql' ? $return : uc_unserialize($return);
}

/**
* 添加 feed
*
* @param string $icon 图标
* @param string $uid uid
* @param string $username 用户名
* @param string $title_template 标题模板
* @param array $title_data 标题内容
* @param string $body_template 内容模板
* @param array $body_data 内容内容
* @param string $body_general 保留
* @param string $target_ids 保留
* @param array $images 图片
* 格式为:
* array(
* array('url'=>'http://domain1/1.jpg', 'link'=>'http://domain1'),
* array('url'=>'http://domain2/2.jpg', 'link'=>'http://domain2'),
* array('url'=>'http://domain3/3.jpg', 'link'=>'http://domain3'),
* )
* 示例:
* $feed['images'][] = array('url'=>$vthumb1, 'link'=>$vthumb1);
* $feed['images'][] = array('url'=>$vthumb2, 'link'=>$vthumb2);
* @return int feedid
*/
function uc_feed_add($icon, $uid, $username, $title_template='', $title_data='', $body_template='', $body_data='', $body_general='', $target_ids='', $images = array()) {
return call_user_func(UC_API_FUNC, 'feed', 'add',
array( 'icon'=>$icon,
'appid'=>UC_APPID,
'uid'=>$uid,
'username'=>$username,
'title_template'=>$title_template,
'title_data'=>$title_data,
'body_template'=>$body_template,
'body_data'=>$body_data,
'body_general'=>$body_general,
'target_ids'=>$target_ids,
'image_1'=>$images[0]['url'],
'image_1_link'=>$images[0]['link'],
'image_2'=>$images[1]['url'],
'image_2_link'=>$images[1]['link'],
'image_3'=>$images[2]['url'],
'image_3_link'=>$images[2]['link'],
'image_4'=>$images[3]['url'],
'image_4_link'=>$images[3]['link']
)
);
}

/**
* 每次取多少条
*
* @param int $limit
* @return array()
*/
function uc_feed_get($limit = 100, $delete = TRUE) {
$return = call_user_func(UC_API_FUNC, 'feed', 'get', array('limit'=>$limit, 'delete'=>$delete));
return UC_CONNECT == 'mysql' ? $return : uc_unserialize($return);
}

/**
* 添加好友
*
* @param int $uid 用户ID
* @param int $friendid 好友ID
* @return
* >0 成功
* <=0 失败
*/
function uc_friend_add($uid, $friendid, $comment='') {
return call_user_func(UC_API_FUNC, 'friend', 'add', array('uid'=>$uid, 'friendid'=>$friendid, 'comment'=>$comment));
}

/**
* 删除好友
*
* @param int $uid 用户ID
* @param array $friendids 好友ID
* @return
* >0 成功
* <=0 失败,或者好友已经删除
*/
function uc_friend_delete($uid, $friendids) {
return call_user_func(UC_API_FUNC, 'friend', 'delete', array('uid'=>$uid, 'friendids'=>$friendids));
}

/**
* 好友总数
* @param int $uid 用户ID
* @return int
*/
function uc_friend_totalnum($uid, $direction = 0) {
return call_user_func(UC_API_FUNC, 'friend', 'totalnum', array('uid'=>$uid, 'direction'=>$direction));
}

/**
* 好友列表
*
* @param int $uid 用户ID
* @param int $page 当前页
* @param int $pagesize 每页条目数
* @param int $totalnum 总数
* @param int $direction 默认为正向. 正向:1 , 反向:2 , 双向:3
* @return array
*/
function uc_friend_ls($uid, $page = 1, $pagesize = 10, $totalnum = 10, $direction = 0) {
$return = call_user_func(UC_API_FUNC, 'friend', 'ls', array('uid'=>$uid, 'page'=>$page, 'pagesize'=>$pagesize, 'totalnum'=>$totalnum, 'direction'=>$direction));
return UC_CONNECT == 'mysql' ? $return : uc_unserialize($return);
}

/**
* 用户注册
*
* @param string $username 用户名
* @param string $password 密码
* @param string $email Email
* @param int $questionid 安全提问
* @param string $answer 安全提问答案
* @return int
-1 : 用户名不合法
-2 : 包含不允许注册的词语
-3 : 用户名已经存在
-4 : email 格式有误
-5 : email 不允许注册
-6 : 该 email 已经被注册
>1 : 表示成功，数值为 UID
*/
function uc_user_register($username, $password, $email, $questionid = '', $answer = '') {
return call_user_func(UC_API_FUNC, 'user', 'register', array('username'=>$username, 'password'=>$password, 'email'=>$email, 'questionid'=>$questionid, 'answer'=>$answer));
}

/**
* 用户注册
*
* @param string $username 用户名
* @param string $password 密码
* @param string $email Email
* @param int $questionid 安全提问
* @param string $answer 安全提问答案
* @return int
-1 : 用户名不合法
-2 : 包含不允许注册的词语
-3 : 用户名已经存在
-4 : email 格式有误
-5 : email 不允许注册
-6 : 该 email 已经被注册
>1 : 表示成功，数值为 UID

function uc_ef007_register($username, $password, $email, $usertype) {
return call_user_func(UC_API_FUNC, 'user', 'register', array('username'=>$username, 'password'=>$password, 'email'=>$email, 'questionid'=>$questionid, 'answer'=>$answer,'usertype'=>$usertype));
}
/**
* 中介机构注册
*
* @param int $city
* @param string $companyName
* @param string $companyEmailk
* @param string $contactTel
* @param string $contactPerson
* @param string $companyAddress
* @param int $companyNo 工商注册号
* @param int $companyRegCount 注册资本
* @param string $companyRegDate
* @param int $companyUnit
* @param string $companyInfo
* @param string $companyRemark
*
* @return int
* -1 : 用户名不合法
* >1 : 表示成功，数值为 UID
*/
function uc_agency_register($city,$companyname,$category,$userName,$companyEmail,$companyPass,$contactTel,$contactPerson,$companyAddress,$companyNo,$companyRegCount,$companyRegDate,$companyUnit,$companyInfo,$companyRemark){

return call_user_func(UC_API_FUNC,'agency','shopreg',array('city' => $city, 'companyname' => $companyname, 'category' => $category,'username' => $userName, 'companyEmail' => $companyEmail,'companyPass' => $companyPass, 'contactTel' => $contactTel, 'contactPerson' => $contactPerson, 'companyAddress' => $companyAddress,'companyNo' => $companyNo,'companyRegCount' => $companyRegCount, 'companyRegDate' => $companyRegDate,'companyUnit' => $companyUnit, 'companyInfo' => $companyInfo,'companyRemark' => $companyRemark));
}

/**
* 用户登陆检查
*
* @param string $username 用户名/uid
* @param string $password 密码
* @param int $isuid 是否为uid
* @param int $checkques 是否使用检查安全问答
* @param int $questionid 安全提问
* @param string $answer 安全提问答案
* @return array (uid/status, username, password, email)
数组第一项
1 : 成功
-1 : 用户不存在,或者被删除
-2 : 密码错
*/
function uc_user_login($username, $password, $isuid = 0, $checkques = 0, $questionid = '', $answer = '') {
$isuid = intval($isuid);
$return = call_user_func(UC_API_FUNC, 'user', 'login', array('username'=>$username, 'password'=>$password, 'isuid'=>$isuid, 'checkques'=>$checkques, 'questionid'=>$questionid, 'answer'=>$answer));
return UC_CONNECT == 'mysql' ? $return : uc_unserialize($return);
}

/**
* 进入同步登录代码
*
* @param int $uid 用户ID
* @return string HTML代码
*/
function uc_user_synlogin($uid) {
$uid = intval($uid);
$return = uc_api_post('user', 'synlogin', array('uid'=>$uid));
return $return;
}

/**
* 进入同步登出代码
*
* @return string HTML代码
*/
function uc_user_synlogout() {
$return = uc_api_post('user', 'synlogout', array());
return $return;
}

/**
* 编辑用户
*
* @param string $username 用户名
* @param string $oldpw 旧密码
* @param string $newpw 新密码
* @param string $email Email
* @param int $ignoreoldpw 是否忽略旧密码, 忽略旧密码, 则不进行旧密码校验.
* @param int $questionid 安全提问
* @param string $answer 安全提问答案
* @return int
1 : 修改成功
0 : 没有任何修改
-1 : 旧密码不正确
-4 : email 格式有误
-5 : email 不允许注册
-6 : 该 email 已经被注册
-7 : 没有做任何修改
-8 : 受保护的用户，没有权限修改
*/
function uc_user_edit($username, $oldpw, $newpw, $email, $ignoreoldpw = 0, $questionid = '', $answer = '') {
return call_user_func(UC_API_FUNC, 'user', 'edit', array('username'=>$username, 'oldpw'=>$oldpw, 'newpw'=>$newpw, 'email'=>$email, 'ignoreoldpw'=>$ignoreoldpw, 'questionid'=>$questionid, 'answer'=>$answer));
}

/**
* 删除用户
*
* @param string/array $uid 用户的 UID
* @return int
>0 : 成功
0 : 失败
*/
function uc_user_delete($uid) {
return call_user_func(UC_API_FUNC, 'user', 'delete', array('uid'=>$uid));
}

/**
* 删除用户头像
*
* @param string/array $uid 用户的 UID
*/
function uc_user_deleteavatar($uid) {
uc_api_post('user', 'deleteavatar', array('uid'=>$uid));
}

/**
* 检查用户名是否为合法
*
* @param string $username 用户名
* @return int
1 : 合法
-1 : 用户名不合法
-2 : 包含要允许注册的词语
-3 : 用户名已经存在
*/
function uc_user_checkname($username) {
return call_user_func(UC_API_FUNC, 'user', 'check_username', array('username'=>$username));
}

/**
* 检查Email地址是否正确
*
* @param string $email Email
* @return
* 1 : 成功
* -4 : email 格式有误
* -5 : email 不允许注册
* -6 : 该 email 已经被注册
*/
function uc_user_checkemail($email) {
return call_user_func(UC_API_FUNC, 'user', 'check_email', array('email'=>$email));
}

/**
* 添加保护用户
*
* @param string/array $username 保护用户名
* @param string $admin 操作的管理员
* @return
* -1 : 失败
* 1 : 成功
*/
function uc_user_addprotected($username, $admin='') {
return call_user_func(UC_API_FUNC, 'user', 'addprotected', array('username'=>$username, 'admin'=>$admin));
}

/**
* 删除保护用户
*
* @param string/array $username 保护用户名
* @return
* -1 : 失败
* 1 : 成功
*/
function uc_user_deleteprotected($username) {
return call_user_func(UC_API_FUNC, 'user', 'deleteprotected', array('username'=>$username));
}

/**
* 得到受保护的用户名列表
*
* @param empty
* @return
* 受到保护的用户名列表
* array()
*/
function uc_user_getprotected() {
$return = call_user_func(UC_API_FUNC, 'user', 'getprotected', array('1'=>1));
return UC_CONNECT == 'mysql' ? $return : uc_unserialize($return);
}

/**
* 取得用户数据
*
* @param string $username 用户名
* @param int $isuid 是否为UID
* @return array (uid, username, email)
*/
function uc_get_user($username, $isuid=0) {
$return = call_user_func(UC_API_FUNC, 'user', 'get_user', array('username'=>$username, 'isuid'=>$isuid));
return UC_CONNECT == 'mysql' ? $return : uc_unserialize($return);
}

/**
* 用户合并最后的处理
*
* @param string $oldusername 老用户名
* @param string $newusername 新用户名
* @param string $uid 老UID
* @param string $password 密码
* @param string $email Email
* @return int
-1 : 用户名不合法
-2 : 包含不允许注册的词语
-3 : 用户名已经存在
>1 : 表示成功，数值为 UID
*/
function uc_user_merge($oldusername, $newusername, $uid, $password, $email) {
return call_user_func(UC_API_FUNC, 'user', 'merge', array('oldusername'=>$oldusername, 'newusername'=>$newusername, 'uid'=>$uid, 'password'=>$password, 'email'=>$email));
}

/**
* 移去合并用户记录
* @param string $username 用户名
*/
function uc_user_merge_remove($username) {
return call_user_func(UC_API_FUNC, 'user', 'merge_remove', array('username'=>$username));
}

/**
* 获取指定应用的指定用户积分值
* @param int $appid 应用Id
* @param int $uid 用户Id
* @param int $credit 积分编号
*/
function uc_user_getcredit($appid, $uid, $credit) {
return call_user_func(UC_API_FUNC, 'user', 'getcredit', array('appid'=>$appid, 'uid'=>$uid, 'credit'=>$credit));
}

/**
* 进入短消息界面
*
* @param int $uid 用户ID
* @param int $newpm 是否直接进入newpm
*/
function uc_pm_location($uid, $newpm = 0) {
$apiurl = uc_api_url('pm_client', 'ls', "uid=$uid", ($newpm ? '&amp;folder=newbox' : ''));
@header("Expires: 0");
@header("Cache-Control: private, post-check=0, pre-check=0, max-age=0", FALSE);
@header("Pragma: no-cache");
@header("location: $apiurl");
}

/**
* 检查新短消息
*
* @param int $uid 用户ID
* @param int $more 详细信息
* @return int 是否存在新短消息
* 2 详细 (短消息数、公共消息数、最后消息时间, 最后消息内容)
* 1 简单 (短消息数、公共消息数、最后消息时间)
* 0 否
*/
function uc_pm_checknew($uid, $more = 0) {
$return = call_user_func(UC_API_FUNC, 'pm', 'check_newpm', array('uid'=>$uid, 'more'=>$more));
return (!$more || UC_CONNECT == 'mysql') ? $return : uc_unserialize($return);
}

/**
* 发送短消息
*
* @param int $fromuid 发件人uid 0 为系统消息
* @param mix $msgto 收件人 uid/username 多个逗号分割
* @param mix $subject 标题
* @param mix $message 内容
* @param int $instantly 立即发送 1 立即发送(默认) 0 进入短消息发送界面
* @param int $replypid 回复的消息Id
* @param int $isusername 0 = $msgto 为 uid、1 = $msgto 为 username
* @return
* >1 发送成功的人数
* 0 收件人不存在
*/
function uc_pm_send($fromuid, $msgto, $subject, $message, $instantly = 1, $replypmid = 0, $isusername = 0) {
if($instantly) {
$replypmid = @is_numeric($replypmid) ? $replypmid : 0;
return call_user_func(UC_API_FUNC, 'pm', 'sendpm', array('fromuid'=>$fromuid, 'msgto'=>$msgto, 'subject'=>$subject, 'message'=>$message, 'replypmid'=>$replypmid, 'isusername'=>$isusername));
} else {
$fromuid = intval($fromuid);
$subject = urlencode($subject);
$msgto = urlencode($msgto);
$message = urlencode($message);
$replypmid = @is_numeric($replypmid) ? $replypmid : 0;
$replyadd = $replypmid ? "&amp;pmid=$replypmid&amp;do=reply" : '';
$apiurl = uc_api_url('pm_client', 'send', "uid=$fromuid", "&amp;msgto=$msgto&amp;subject=$subject&amp;message=$message$replyadd");
@header("Expires: 0");
@header("Cache-Control: private, post-check=0, pre-check=0, max-age=0", FALSE);
@header("Pragma: no-cache");
@header("location: ".$apiurl);
}
}

/**
* 删除短消息
*
* @param int $uid 用户Id
* @param string $folder 打开的目录 inbox=收件箱，outbox=发件箱
* @param array $pmids 要删除的消息ID数组
* @return
* >0 成功
* <=0 失败
*/
function uc_pm_delete($uid, $folder, $pmids) {
return call_user_func(UC_API_FUNC, 'pm', 'delete', array('uid'=>$uid, 'folder'=>$folder, 'pmids'=>$pmids));
}

/**
* 按照用户删除短消息
*
* @param int $uid 用户Id
* @param array $uids 要删除的消息用户ID数组
* @return
* >0 成功
* <=0 失败
*/
function uc_pm_deleteuser($uid, $touids) {
return call_user_func(UC_API_FUNC, 'pm', 'deleteuser', array('uid'=>$uid, 'touids'=>$touids));
}

/**
* 标记已读/未读状态
*
* @param int $uid 用户Id
* @param array $uids 要标记已读状态的用户ID数组
* @param array $pmids 要标记已读状态的消息ID数组
* @param int $status 1 已读 0 未读
*/
function uc_pm_readstatus($uid, $uids, $pmids = array(), $status = 0) {
return call_user_func(UC_API_FUNC, 'pm', 'readstatus', array('uid'=>$uid, 'uids'=>$uids, 'pmids'=>$pmids, 'status'=>$status));
}

/**
* 获取短消息列表
*
* @param int $uid 用户Id
* @param int $page 当前页
* @param int $pagesize 每页最大条目数
* @param string $folder 打开的目录 newbox=未读消息，inbox=收件箱，outbox=发件箱
* @param string $filter 过滤方式 newpm=未读消息，systempm=系统消息，announcepm=公共消息
$folder $filter
--------------------------
newbox
inbox newpm
systempm
announcepm
outbox newpm
searchbox *
* @param string $msglen 截取的消息文字长度
* @return array('count' => 消息总数, 'data' => 短消息数据)
*/
function uc_pm_list($uid, $page = 1, $pagesize = 10, $folder = 'inbox', $filter = 'newpm', $msglen = 0) {
$uid = intval($uid);
$page = intval($page);
$pagesize = intval($pagesize);
$return = call_user_func(UC_API_FUNC, 'pm', 'ls', array('uid'=>$uid, 'page'=>$page, 'pagesize'=>$pagesize, 'folder'=>$folder, 'filter'=>$filter, 'msglen'=>$msglen));
return UC_CONNECT == 'mysql' ? $return : uc_unserialize($return);
}

/**
* 忽略未读消息提示
*
* @param int $uid 用户Id
*/
function uc_pm_ignore($uid) {
$uid = intval($uid);
return call_user_func(UC_API_FUNC, 'pm', 'ignore', array('uid'=>$uid));
}

/**
* 获取短消息内容
*
* @param int $uid 用户Id
* @param int $pmid 消息Id
* @param int $touid 消息对方用户Id
* @param int $daterange 日期范围 1=今天,2=昨天,3=前天,4=上周,5=更早
* @return array() 短消息内容数组
*/
function uc_pm_view($uid, $pmid, $touid = 0, $daterange = 1) {
$uid = intval($uid);
$touid = intval($touid);
$pmid = @is_numeric($pmid) ? $pmid : 0;
$return = call_user_func(UC_API_FUNC, 'pm', 'view', array('uid'=>$uid, 'pmid'=>$pmid, 'touid'=>$touid, 'daterange'=>$daterange));
return UC_CONNECT == 'mysql' ? $return : uc_unserialize($return);
}

/**
* 获取单条短消息内容
*
* @param int $uid 用户Id
* @param int $pmid 消息Id
* @param int $type 0 = 获取指定单条消息
1 = 获取指定用户发的最后单条消息
2 = 获取指定用户收的最后单条消息
* @return array() 短消息内容数组
*/
function uc_pm_viewnode($uid, $type = 0, $pmid = 0) {
$uid = intval($uid);
$pmid = @is_numeric($pmid) ? $pmid : 0;
$return = call_user_func(UC_API_FUNC, 'pm', 'viewnode', array('uid'=>$uid, 'pmid'=>$pmid, 'type'=>$type));
return UC_CONNECT == 'mysql' ? $return : uc_unserialize($return);
}

/**
* 获取黑名单
*
* @param int $uid 用户Id
* @return string 黑名单内容
*/
function uc_pm_blackls_get($uid) {
$uid = intval($uid);
return call_user_func(UC_API_FUNC, 'pm', 'blackls_get', array('uid'=>$uid));
}

/**
* 设置黑名单
*
* @param int $uid 用户Id
* @param int $blackls 黑名单内容
*/
function uc_pm_blackls_set($uid, $blackls) {
$uid = intval($uid);
return call_user_func(UC_API_FUNC, 'pm', 'blackls_set', array('uid'=>$uid, 'blackls'=>$blackls));
}

/**
* 添加黑名单项目
*
* @param int $uid 用户Id
* @param int $username 用户名
*/
function uc_pm_blackls_add($uid, $username) {
$uid = intval($uid);
return call_user_func(UC_API_FUNC, 'pm', 'blackls_add', array('uid'=>$uid, 'username'=>$username));
}

/**
* 删除黑名单项目
*
* @param int $uid 用户Id
* @param int $username 用户名
*/
function uc_pm_blackls_delete($uid, $username) {
$uid = intval($uid);
return call_user_func(UC_API_FUNC, 'pm', 'blackls_delete', array('uid'=>$uid, 'username'=>$username));
}

/**
* 获取域名解析表
*
* @return array()
*/
function uc_domain_ls() {
$return = call_user_func(UC_API_FUNC, 'domain', 'ls', array('1'=>1));
return UC_CONNECT == 'mysql' ? $return : uc_unserialize($return);
}

/**
* 积分兑换请求
*
* @param int $uid 用户ID
* @param int $from 原积分
* @param int $to 目标积分
* @param int $toappid 目标应用ID
* @param int $amount 积分数额
* @return
* 1 : 成功
* 0 : 失败
*/
function uc_credit_exchange_request($uid, $from, $to, $toappid, $amount) {
$uid = intval($uid);
$from = intval($from);
$toappid = intval($toappid);
$to = intval($to);
$amount = intval($amount);
return uc_api_post('credit', 'request', array('uid'=>$uid, 'from'=>$from, 'to'=>$to, 'toappid'=>$toappid, 'amount'=>$amount));
}

/**
* 返回指定的相关TAG数据
*
* @param string $tagname TAG名称
* @param int $totalnum 返回数据的条目数
* @return array() 序列化过的数组，数组内容为当前或其他应用的相关TAG数据
*/
function uc_tag_get($tagname, $nums = 0) {
$return = call_user_func(UC_API_FUNC, 'tag', 'gettag', array('tagname'=>$tagname, 'nums'=>$nums));
return UC_CONNECT == 'mysql' ? $return : uc_unserialize($return);
}

/**
* 修改头像
*
* @param int $uid 用户ID
* @param string $type 头像类型 real OR virtual 默认为 virtual
* @return string
*/
function uc_avatar($uid, $type = 'virtual', $returnhtml = 1) {
$uid = intval($uid);
$uc_input = uc_api_input("uid=$uid");
$uc_avatarflash = UC_API.'/images/camera.swf?inajax=1&amp;appid='.UC_APPID.'&amp;input='.$uc_input.'&amp;agent='.md5($_SERVER['HTTP_USER_AGENT']).'&amp;ucapi='.urlencode(UC_API).'&amp;avatartype='.$type;
if($returnhtml) {
return '<object classid="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000" codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,0,0" width="447" height="477" id="mycamera" align="middle">
<param name="allowScriptAccess" value="always" />
<param name="scale" value="exactfit" />
<param name="wmode" value="transparent" />
<param name="quality" value="high" />
<param name="bgcolor" value="#ffffff" />
<param name="movie" value="'.$uc_avatarflash.'" />
<param name="menu" value="false" />
<embed src="'.$uc_avatarflash.'" mce_src="'.$uc_avatarflash.'" quality="high" bgcolor="#ffffff" width="447" height="477" name="mycamera" align="middle" allowScriptAccess="always" allowFullScreen="false" scale="exactfit" wmode="transparent" type="application/x-shockwave-flash" pluginspage="http://www.macromedia.com/go/getflashplayer" />
</object>';
} else {
return array(
'width', '447',
'height', '477',
'scale', 'exactfit',
'src', $uc_avatarflash,
'id', 'mycamera',
'name', 'mycamera',
'quality','high',
'bgcolor','#ffffff',
'wmode','transparent',
'menu', 'false',
'swLiveConnect', 'true',
'allowScriptAccess', 'always'
);
}
}

/**
* 邮件队列
*
* @param string $uids 用户名id，多个用逗号(,)隔开
* @param string $emails 邮件地址，多个用逗号隔开
* @param string $subject 邮件标题
* @param string $message 邮件内容
* @param string $charset 邮件字符集，可选参数，默认为gbk
* @param boolean $htmlon 是否按html格式发送邮件，可选参数，默认为否
* @param integer $level 邮件级别，可选参数，取值0-127，默认为1，越大发送的优先级越高，为0时不入库，直接发送，会影响当前进程速度，慎用
* @return integer
* =0 : 失败
* >0 : 成功，返回插入记录的id，如果是多条则返回最后一条记录的id，若level等于0，则返回1
*/
function uc_mail_queue($uids, $emails, $subject, $message, $frommail = '', $charset = 'gbk', $htmlon = FALSE, $level = 1) {
return call_user_func(UC_API_FUNC, 'mail', 'add', array('uids' => $uids, 'emails' => $emails, 'subject' => $subject, 'message' => $message, 'frommail' => $frommail, 'charset' => $charset, 'htmlon' => $htmlon, 'level' => $level));
}

/**
* 检测是否存在指定头像
* @param integer $uid 用户id
* @param string $size 头像尺寸，取值范围(big,middle,small)，默认为 middle
* @param string $type 头像类型，取值范围(virtual,real)，默认为virtual
* @return boolean
* true : 头像存在
* false: 头像不存在
*/
function uc_check_avatar($uid, $size = 'middle', $type = 'virtual') {
$url = UC_API."/avatar.php?uid=$uid&amp;size=$size&amp;type=$type&amp;check_file_exists=1";
$res = @file_get_contents($url);
if($res == 1) {
return 1;
} else {
return 0;
}
}

/**
* 检测uc_server的数据库版本和程序版本
* @return mixd
* array('db' => 'xxx', 'file' => 'xxx');
* null 无法调用到接口
* string 文件版本低于1.5
*/
function uc_check_version() {
$return = uc_api_post('version', 'check', array());
$data = uc_unserialize($return);
return is_array($data) ? $data : $return;
}

?>