设为首页收藏本站

 找回密码
 立即注册

QQ登录

只需一步，快速开始

搜索
新秀网络验证系统»首页 › ☆=〖新秀网络验证DZ3.5〗=☆ › 二次开发 › Discuz x3.5 核心文件 function/function_friend.php 函 ...
返回列表 发新帖
查看: 4685|回复: 0

[内置扩展] Discuz x3.5 核心文件 function/function_friend.php 函数注释

[复制链接]
admin
发表于 2024-6-23 13:30:31 | 显示全部楼层 |阅读模式

马上注册，结交更多好友，享用更多功能，让你轻松玩转社区

您需要 登录 才可以下载或查看，没有账号？立即注册

×
[PHP] 纯文本查看 复制代码
<?php

/**
 *      [Discuz!] (C)2001-2099 Comsenz Inc.
 *      This is NOT a freeware, use is subject to license terms
 *
 *      $Id: function_friend.php 26635 2011-12-19 01:59:13Z zhangguosheng $
 */

if(!defined('IN_DISCUZ')) {
	exit('Access Denied');
}
/**
 * 获取指定用户的友人列表
 *
 * @param int $uid 用户ID
 * @param int $limit 返回结果的数量限制
 * @param int $start 返回结果的起始位置（默认为0）
 * @return array 返回友人列表，键为友人的ID，值为友人信息
 */
function friend_list($uid, $limit, $start=0) {
    $list = array();
    $query = C::t('home_friend')->fetch_all_by_uid($uid, $start, $limit, true);
    foreach($query as $value) {
        $list[$value['fuid']] = $value;
    }
    return $list;
}

/**
 * 获取当前用户的友人分组列表
 *
 * @return array 返回友人分组列表
 */
function friend_group_list() {
    global $_G;

    $space = array('uid' => $_G['uid']);
    space_merge($space, 'field_home');

    $groups = array();
    $spacegroup = empty($space['privacy']['groupname'])?array():$space['privacy']['groupname'];
    for($i = 0; $i < $_G['setting']['friendgroupnum']; $i++) {
        if($i == 0) {
            $groups[0] = lang('friend', 'friend_group_default');
        } else {
            if(!empty($spacegroup[$i])) {
                $groups[$i] = $spacegroup[$i];
            } else {
                if($i<8) {
                    $groups[$i] = lang('friend', 'friend_group_'.$i);
                } else {
                    $groups[$i] = lang('friend', 'friend_group_more', array('num'=>$i));
                }
            }
        }
    }
    return $groups;
}

/**
 * 检查指定用户是否为当前用户的友人
 *
 * @param mixed $touids 可以是单个用户ID或用户ID数组
 * @param int $isfull 是否获取完整友人信息，默认为0（只检查友人关系是否存在）
 * @return mixed 如果是数组形式的$touids，返回布尔值；如果是单个用户ID，返回布尔值或友人信息数组
 */
function friend_check($touids, $isfull = 0) {
    global $_G;

    if(empty($_G['uid'])) return false;
    if(is_array($touids)) {
        $query = C::t('home_friend')->fetch_all_by_uid_fuid($_G['uid'], $touids);

        foreach($query as $value) {
            $touid = $value['fuid'];
            $var = "home_friend_{$_G['uid']}_{$touid}";
            $fvar = "home_friend_{$touid}_{$_G['uid']}";
            $_G[$var] = $_G[$fvar] = true;
            if($isfull) {
                $fvarinfo = "home_friend_info_{$touid}_{$_G['uid']}";
                $_G[$fvarinfo] = $value;
            }
        }

        if(count($query) != count($touids)) {
            return false;
        } else {
            return true;
        }
    } else {
        $touid = $touids;
        $var = "home_friend_{$_G['uid']}_{$touid}";
        $fvar = "home_friend_{$touid}_{$_G['uid']}";
        if(!isset($_G[$var])) {
            $query = C::t('home_friend')->fetch_all_by_uid_fuid($_G['uid'], $touid);
            $friend = isset($query[0]) ? $query[0] : '';
            if($friend) {
                $_G[$var] = $_G[$fvar] = true;
                if($isfull) {
                    $fvarinfo = "home_friend_info_{$touid}_{$_G['uid']}";
                    $_G[$fvarinfo] = $friend;
                }
            } else {
                $_G[$var] = $_G[$fvar] = false;
            }
        }
        return $_G[$var];
    }
}

/**
 * 检查指定用户是否向当前用户发送了友人请求
 *
 * @param int $touid 目标用户ID
 * @return bool 返回目标用户是否发送了友人请求
 */
function friend_request_check($touid) {
    global $_G;

    $var = "home_friend_request_{$touid}";
    if(!isset($_G[$var])) {
        $result = C::t('home_friend_request')->fetch_by_uid_fuid($_G['uid'], $touid);
        $_G[$var] = $result?true:false;
    }
    return $_G[$var];
}

/**
 * 添加友人关系
 *
 * @param int $touid 目标用户ID
 * @param int $gid 友人分组ID，默认为0
 * @param string $note 添加友人的备注信息，默认为空
 * @return int 返回执行结果，-2表示目标用户是当前用户，-1表示目标用户已发送添加请求，1表示添加成功
 */
function friend_add($touid, $gid=0, $note='') {
    global $_G;

    if($touid == $_G['uid']) return -2;
    if(friend_check($touid)) return -2;

    include_once libfile('function/stat');
    $freind_request = C::t('home_friend_request')->fetch_by_uid_fuid($_G['uid'], $touid);
    if($freind_request) {
        // 处理已存在的友人请求，建立友人关系
        $setarr = array(
            'uid' => $_G['uid'],
            'fuid' => $freind_request['fuid'],
            'fusername' => addslashes($freind_request['fusername']),
            'gid' => $gid,
            'dateline' => $_G['timestamp']
        );
        C::t('home_friend')->insert($setarr);

        friend_request_delete($touid);

        friend_cache($_G['uid']);

        $setarr = array(
            'uid' => $touid,
            'fuid' => $_G['uid'],
            'fusername' => $_G['username'],
            'gid' => $freind_request['gid'],
            'dateline' => $_G['timestamp']
        );
        C::t('home_friend')->insert($setarr);

        addfriendlog($_G['uid'], $touid);
        friend_cache($touid);
        updatestat('friend');
    } else {
        // 处理目标用户未发送请求的情况，插入新的友人请求
        $to_freind_request = C::t('home_friend_request')->fetch_by_uid_fuid($touid, $_G['uid']);
        if($to_freind_request) {
            return -1;
        }

        $setarr = array(
            'uid' => $touid,
            'fuid' => $_G['uid'],
            'fusername' => $_G['username'],
            'gid' => $gid,
            'note' => $note,
            'dateline' => $_G['timestamp']
        );
        C::t('home_friend_request')->insert($setarr);

        updatestat('addfriend');
    }

    return 1;
}
/**
 * 添加好友
 *
 * @param int $touid 目标用户的ID
 * @param string $tousername 目标用户的用户名
 * @param bool $checkrequest 是否检查好友请求，默认为true
 * @return bool 返回false表示操作失败，否则成功
 */
function friend_make($touid, $tousername, $checkrequest=true) {
	global $_G;

	// 检查是否尝试添加自己为好友
	if($touid == $_G['uid']) return false;

	// 如果需要检查好友请求
	if($checkrequest) {
		// 删除目标用户向当前用户发出的好友请求
		$to_freind_request = C::t('home_friend_request')->fetch_by_uid_fuid($touid, $_G['uid']);
		if($to_freind_request) {
			C::t('home_friend_request')->delete_by_uid_fuid($touid, $_G['uid']);
		}

		// 删除当前用户向目标用户发出的好友请求
		$to_freind_request = C::t('home_friend_request')->fetch_by_uid_fuid($_G['uid'], $touid);
		if($to_freind_request) {
			C::t('home_friend_request')->delete_by_uid_fuid($_G['uid'], $touid);
		}
	}

	// 插入两条好友记录，互为好友
	$insertarray = array(
		'uid' => $touid,
		'fuid' => $_G['uid'],
		'fusername' => $_G['username'],
		'dateline' => $_G['timestamp'],
	);
	C::t('home_friend')->insert($insertarray, false, true);

	$insertarray = array(
		'uid' => $_G['uid'],
		'fuid' => $touid,
		'fusername' => $tousername,
		'dateline' => $_G['timestamp'],
	);
	C::t('home_friend')->insert($insertarray, false, true);

	// 添加好友操作日志
	addfriendlog($_G['uid'], $touid);
	// 更新统计信息
	include_once libfile('function/stat');
	updatestat('friend');
	// 更新好友缓存
	friend_cache($touid);
	friend_cache($_G['uid']);
}

/**
 * 添加好友日志
 *
 * @param int $uid 发起操作的用户ID
 * @param int $touid 被操作的用户ID
 * @param string $action 操作类型，默认为'add'
 * @return bool 返回true表示日志添加成功，false表示添加失败
 */
function addfriendlog($uid, $touid, $action = 'add') {
	global $_G;

	// 检查是否提供了有效的用户ID
	if($uid && $touid) {
		$flog = array(
				'uid' => $uid > $touid ? $uid : $touid,
				'fuid' => $uid > $touid ? $touid : $uid,
				'dateline' => $_G['timestamp'],
				'action' => $action
		);
		DB::insert('home_friendlog', $flog, false, true);
		return true;
	}

	return false;

}

/**
 * 增加好友数量统计
 *
 * @param int $touid 目标用户的ID
 */
function friend_addnum($touid) {
	global $_G;

	// 检查是否为当前用户ID，且不为自身
	if($_G['uid'] && $_G['uid'] != $touid) {
		C::t('home_friend')->update_num_by_uid_fuid(1, $_G['uid'], $touid);
	}
}

/**
 * 更新好友缓存
 *
 * @param int $touid 用户ID
 */
function friend_cache($touid) {
	global $_G;

	// 合并用户空间信息
	$tospace = array('uid' => $touid);
	space_merge($tospace, 'field_home');

	// 获取过滤组ID
	$filtergids = empty($tospace['privacy']['filter_gid'])?array():$tospace['privacy']['filter_gid'];

	$uids = array();
	$count = 0;
	$fcount = 0;
	// 获取所有好友信息
	$query = C::t('home_friend')->fetch_all_by_uid($touid, 0, 0, true);
	foreach($query as $value) {
		// 排除自身
		if($value['fuid'] == $touid) continue;
		// 达到缓存好友数量上限
		if($fcount > 200) {
			$count = count($query);
			break;
		} elseif(empty($filtergids) || !in_array($value['gid'], $filtergids)) {
			$uids[] = $value['fuid'];
			$fcount++;
		}
		$count++;
	}
	// 更新用户的好友列表缓存和好友数量
	C::t('common_member_field_home')->update($touid, array('feedfriend'=>implode(',', $uids)));
	C::t('common_member_count')->update($touid, array('friends'=>$count));
}

/**
 * 删除好友请求
 * @param int $touid 目标用户的UID
 * @return bool 删除操作的结果，成功返回true，失败返回false
 */
function friend_request_delete($touid) {
	global $_G;

	// 通过UID和目标UID删除好友请求
	return C::t('home_friend_request')->delete_by_uid_fuid($_G['uid'], $touid);
}

/**
 * 删除好友
 * @param int $touid 目标用户的UID
 * @return bool 删除操作的结果，成功返回true，失败返回false
 * 注：如果目标用户不是好友，则不执行删除操作并返回false。
 */
function friend_delete($touid) {
	global $_G;

	// 检查是否为好友，如果不是则直接返回false
	if(!friend_check($touid)) return false;

	// 删除好友关系
	C::t('home_friend')->delete_by_uid_fuid_dual($_G['uid'], $touid);

	// 如果删除操作影响了行数（即删除成功），则进行后续操作
	if(DB::affected_rows()) {
		// 添加删除好友的日志
		addfriendlog($_G['uid'], $touid, 'delete');
		// 更新好友缓存
		friend_cache($_G['uid']);
		friend_cache($touid);
	}
}

?>

回复

使用道具 举报

返回列表 发新帖
高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

QQ|Archiver|手机版|新秀网络验证系统API[软著登字第13061951号] ( 豫ICP备2021033257号-1 )

GMT+8, 2026-1-8 07:47 , Processed in 0.259814 second(s), 63 queries , Redis On.

Powered by Discuz! X3.5 Licensed

© 2001-2026 Discuz! Team.

快速回复 返回顶部 返回列表
slot777
slot qris
atlas123
KAPAK123
MENARA123
BARONG123
VIRGO123
HORAS123
KAKEK123
ION123
PATEN123
SALAM123
TUYUL123
KUNGLO123
PINTU123
JOKI123
INTI123
JADI123
MENANGBET
JADIJP
ACEH123
TINGGIBET
SUMBER4D
PULANG4D
POLAMAXWIN
INTAN123
dingin4d
paten123
slotsultan
slot sultan