网站首页学无止境PHP

discuz核心函数库function_core的函数注释

发布时间:2015-10-23 14:46:12编辑:songlin阅读(55)

    1. /** 
    2.  * 系统错误处理 
    3.  * @param <type> $message 错误信息 
    4.  * @param <type> $show 是否显示信息 
    5.  * @param <type> $save 是否存入日志 
    6.  * @param <type> $halt 是否中断访问 
    7.  */ 
    8. function system_error($message$show = true, $save = true, $halt = true) { 
    9.     ......     
    10.  
    11. /** 
    12.  * 更新 session 
    13.  * @global <type> $_G 
    14.  * @staticvar boolean $updated 
    15.  * @param boolean $force 
    16.  * @return boolean 
    17.  */ 
    18. function updatesession($force = false) { 
    19.     ......     
    20.  
    21. /** 
    22.  * 获取 microtime float 数值,为了兼容php4 
    23.  * @return <float> 
    24.  */ 
    25. function dmicrotime() { 
    26.     ......     
    27.  
    28. /** 
    29.  * 设置全局 $_G 中的变量 
    30.  * @global <array> $_G 
    31.  * @param <string> $key 键 
    32.  * @param <string> $value 值 
    33.  * @param <mix> $group 组(准备废弃,尽量不用) 
    34.  * @return true 
    35.  * 
    36.  * @example 
    37.  * setglobal('test', 1); // $_G['test'] = 1; 
    38.  * setglobal('config/test/abc') = 2; //$_G['config']['test']['abc'] = 2; 
    39.  * 
    40.  */ 
    41. function setglobal($key , $value$group = null) { 
    42.     ......     
    43.  
    44. /** 
    45.  * 获取全局变量 $_G 当中的某个数值 
    46.  * @global  $_G 
    47.  * @param <type> $key 
    48.  * @param <type> $group 计划废弃的参数,不建议使用 
    49.  * @return <mix> 
    50.  * 
    51.  * $v = getglobal('test'); // $v = $_G['test'] 
    52.  * $v = getglobal('test/hello/ok');  // $v = $_G['test']['hello']['ok'] 
    53.  */ 
    54. function getglobal($key$group = null) { 
    55.     ......     
    56.  
    57. /** 
    58.  * 取出 get, post, cookie 当中的某个变量 
    59.  * 
    60.  * @param string $k  key 值 
    61.  * @param string $type 类型 
    62.  * @return mix 
    63.  */ 
    64. function getgpc($k$type='GP') { 
    65.     ......     
    66.  
    67. /** 
    68.  * 根据uid 获取用户基本数据 
    69.  * @staticvar array $users 存放已经获取的用户的信息,避免重复查库 
    70.  * @param <int> $uid 
    71.  * @return <array> 
    72.  */ 
    73. function getuserbyuid($uid) { 
    74.     ......     
    75.  
    76. /** 
    77. * 获取当前用户的扩展资料 
    78. * @param $field 字段 
    79. */ 
    80. function getuserprofile($field) { 
    81.     ......     
    82.  
    83. /** 
    84.  * 对字符串或者输入进行 addslashes 操作 
    85.  * @param <mix> $string 
    86.  * @param <int> $force 
    87.  * @return <mix> 
    88.  */ 
    89. function daddslashes($string$force = 1) { 
    90.     ......     
    91.  
    92. /** 
    93.  * 对字符串进行加密和解密 
    94.  * @param <string> $string 
    95.  * @param <string> $operation  DECODE 解密 | ENCODE  加密 
    96.  * @param <string> $key 当为空的时候,取全局密钥 
    97.  * @param <int> $expiry 有效期,单位秒 
    98.  * @return <string> 
    99.  */ 
    100. function authcode($string$operation = 'DECODE'$key = ''$expiry = 0) { 
    101.     ......     
    102.  
    103. /** 
    104.  * 远程文件文件请求兼容函数 
    105.  */ 
    106. function dfsockopen($url$limit = 0, $post = ''$cookie = ''$bysocket = FALSE, $ip = ''$timeout = 15, $block = TRUE) { 
    107.     ......     
    108.  
    109. /** 
    110. * HTML转义字符 
    111. * @param $string - 字符串 
    112. * @return 返回转义好的字符串 
    113. */ 
    114. function dhtmlspecialchars($string) { 
    115.     ......     
    116.  
    117. /** 
    118.  * 退出程序 同 exit 的区别, 对输出数据会进行 重新加工和处理 
    119.  * 通常情况下,我们建议使用本函数终止程序, 除非有特别需求 
    120.  * @param <type> $message 
    121.  */ 
    122. function dexit($message = '') { 
    123.     ......     
    124.  
    125. /** 
    126.  * 同 php header函数, 针对 location 跳转做了特殊处理 
    127.  * @param <type> $string 
    128.  * @param <type> $replace 
    129.  * @param <type> $http_response_code 
    130.  */ 
    131. function dheader($string$replace = true, $http_response_code = 0) { 
    132.     ......     
    133.  
    134. /** 
    135. * 设置cookie 
    136. * @param $var - 变量名 
    137. * @param $value - 变量值 
    138. * @param $life - 生命期 
    139. * @param $prefix - 前缀 
    140. * @param $httponly - 安全属性 
    141. */ 
    142. function dsetcookie($var$value = ''$life = 0, $prefix = 1, $httponly = false) { 
    143.     ......     
    144.  
    145. /** 
    146.  * 获取cookie 
    147.  * @param $key - cookie名称,不需要带前缀 
    148.  */ 
    149. function getcookie($key) { 
    150.     ......     
    151.  
    152. /** 
    153.  * 获取文件扩展名 
    154.  * @param $filename 文件名 
    155.  */ 
    156. function fileext($filename) { 
    157.     ......     
    158.  
    159. /** 
    160. * 检查是否是以手机浏览器进入(IN_MOBILE) 
    161. */ 
    162. function checkmobile() { 
    163.     ......     
    164.  
    165. /** 
    166.  * 字符串方式实现 preg_match("/(s1|s2|s3)/", $string, $match) 
    167.  * @param string $string 源字符串 
    168.  * @param array $arr 要查找的字符串 如array('s1', 's2', 's3') 
    169.  * @param bool $returnvalue 是否返回找到的值 
    170.  * @return bool 
    171.  */ 
    172. function dstrpos($string, &$arr$returnvalue = false) { 
    173.     ......     
    174.  
    175. /** 
    176. * 检查邮箱是否有效 
    177. * @param $email 要检查的邮箱 
    178. * @param 返回结果 
    179. */ 
    180. function isemail($email) { 
    181.     ......     
    182.  
    183. /** 
    184. * 问题答案加密 
    185. * @param $questionid - 问题 
    186. * @param $answer - 答案 
    187. * @return 返回加密的字串 
    188. */ 
    189. function quescrypt($questionid$answer) { 
    190.     ......     
    191.  
    192. /** 
    193. * 产生随机码 
    194. * @param $length - 要多长 
    195. * @param $numberic - 数字还是字符串 
    196. * @return 返回字符串 
    197. */ 
    198. function random($length$numeric = 0) { 
    199.     ......     
    200.  
    201. /** 
    202.  * 判断一个字符串是否在另一个字符串中存在 
    203.  * 
    204.  * @param string 原始字串 $string 
    205.  * @param string 查找 $find 
    206.  * @return boolean 
    207.  */ 
    208. function strexists($string$find) { 
    209.     ......     
    210.  
    211. /** 
    212.  * 获取头像 
    213.  * 
    214.  * @param int $uid 需要获取的用户UID值 
    215.  * @param string $size 获取尺寸 'small', 'middle', 'big' 
    216.  * @param boolean $returnsrc 是否直接返回图片src 
    217.  * @param boolean $real 是否返回真实图片 
    218.  * @param boolean $static 是否返回真实路径 
    219.  * @param string $ucenterurl 强制uc路径 
    220.  */ 
    221. function avatar($uid$size = 'middle'$returnsrc = FALSE, $real = FALSE, $static = FALSE, $ucenterurl = '') { 
    222.     ......     
    223.  
    224. /** 
    225. * 加载语言 
    226. * 语言文件统一为 $lang = array(); 
    227. * @param $file - 语言文件,可包含路径如 forum/xxx home/xxx 
    228. * @param $langvar - 语言文字索引 
    229. * @param $vars - 变量替换数组 
    230. * @param $default - 指定默认值,当找不到对应言包时生效 
    231. * @return 语言文字 
    232. */ 
    233. function lang($file$langvar = null, $vars = array(), $default = null) { 
    234.     ......     
    235.  
    236. /** 
    237. * 检查模板源文件是否更新 
    238. * 当编译文件不存时强制重新编译 
    239. * 当 tplrefresh = 1 时检查文件 
    240. * 当 tplrefresh > 1 时,则根据 tplrefresh 取余,无余时则检查更新 
    241. * 
    242. */ 
    243. function checktplrefresh($maintpl$subtpl$timecompare$templateid$cachefile$tpldir$file) { 
    244.     ......     
    245.  
    246. /** 
    247. * 解析模板 
    248. * @return 返回域名 
    249. */ 
    250. function template($file$templateid = 0, $tpldir = ''$gettplfile = 0, $primaltpl='') { 
    251.     ......     
    252.  
    253. /** 
    254.  * 对某id进行个性化md5 
    255.  */ 
    256. function modauthkey($id) { 
    257.     ......     
    258.  
    259. /** 
    260.  * 获得当前应用页面选中的导航id 
    261.  */ 
    262. function getcurrentnav() { 
    263.     ......     
    264.  
    265. /** 
    266. * 读取缓存 
    267. * @param $cachenames - 缓存名称数组或字串 
    268. */ 
    269. function loadcache($cachenames$force = false) { 
    270.     ......     
    271.  
    272. /** 
    273.  * 通过memcache\mysql\file等几种手段读缓存 
    274.  * @param mixed $cachenames 缓存名的数组或字串 
    275.  */ 
    276. function cachedata($cachenames) { 
    277.     ......     
    278.  
    279. /** 
    280. * 格式化时间 
    281. * @param $timestamp - 时间戳 
    282. * @param $format - dt=日期时间 d=日期 t=时间 u=个性化 其他=自定义 
    283. * @param $timeoffset - 时区 
    284. * @return string 
    285. */ 
    286. function dgmdate($timestamp$format = 'dt'$timeoffset = '9999'$uformat = '') { 
    287.     ......     
    288.  
    289. /** 
    290.     得到时间戳 
    291. */ 
    292. function dmktime($date) { 
    293.     ......     
    294.  
    295. /** 
    296. * 更新缓存 
    297. * @param $cachename - 缓存名称 
    298. * @param $data - 缓存数据 
    299. */ 
    300. function save_syscache($cachename$data) { 
    301.     ......     
    302.  
    303. /** 
    304. * Portal模块 
    305. * @param $parameter - 参数集合 
    306. */ 
    307. function block_get($parameter) { 
    308.     ......     
    309.  
    310. /** 
    311. * Portal 模块显示 
    312. * 
    313. * @param $parameter - 参数集合 
    314. */ 
    315. function block_display($bid) { 
    316.     ......     
    317.  
    318. /** 
    319. * 返回库文件的全路径 
    320. * 
    321. * @param string $libname 库文件分类及名称 
    322. * @param string $folder 模块目录'module','include','class' 
    323. * @return string 
    324. * 
    325. * @example require DISCUZ_ROOT.'./source/function/function_cache.php' 
    326. * @example 我们可以利用此函数简写为:require libfile('function/cache'); 
    327. * 
    328. */ 
    329. function libfile($libname$folder = '') { 
    330.     ......     
    331.  
    332. /** 
    333.  * 针对uft-8进行特殊处理的strlen 
    334.  * @param string $str 
    335.  * @return int 
    336.  */ 
    337. function dstrlen($str) { 
    338.     ......     
    339.  
    340. /** 
    341. * 根据中文裁减字符串 
    342. * @param $string - 字符串 
    343. * @param $length - 长度 
    344. * @param $doc - 缩略后缀 
    345. * @return 返回带省略号被裁减好的字符串 
    346. */ 
    347. function cutstr($string$length$dot = ' ...') { 
    348.     ......     
    349.  
    350. /** 
    351. * 论坛 aid url 生成 
    352. */ 
    353. function aidencode($aid$type = 0, $tid = 0) { 
    354.     ......     
    355.  
    356. /** 
    357.  * 返回论坛缩放附件图片的地址 url 
    358.  */ 
    359. function getforumimg($aid$nocache = 0, $w = 140, $h = 140, $type = '') { 
    360.     ......     
    361.  
    362.  
    363. /** 
    364.  * 获取rewrite字符串 
    365.  * @param string $type 需要获取的rewite 
    366.  * @param boolean $returntype true:直接返回href, false:返回a标签 
    367.  * @param string $host 可选网站域名 
    368.  * @return string 
    369.  */ 
    370. function rewriteoutput($type$returntype$host) { 
    371.     ......     
    372.  
    373. /** 
    374. * 手机模式下替换所有链接为mobile=yes形式 
    375. * @param $file - 正则匹配到的文件字符串 
    376. * @param $file - 要被替换的字符串 
    377. * @$replace 替换后字符串 
    378. */ 
    379. function mobilereplace($file$replace) { 
    380.     ......     
    381.  
    382. /** 
    383. * 手机的output函数 
    384. */ 
    385. function mobileoutput() { 
    386.     ......     
    387.  
    388. /** 
    389. * 系统输出 
    390. * @return 返回内容 
    391. */ 
    392. function output() { 
    393.     ......     
    394.  
    395. /** 
    396.  * ajax footer使用输出页面内容 
    397.  */ 
    398. function output_ajax() { 
    399.     ......     
    400.  
    401. /** 
    402.  * 运行钩子 
    403.  */ 
    404. function runhooks() { 
    405.     ......     
    406.  
    407. /** 
    408.  * 执行插件脚本 
    409.  */ 
    410. function hookscript($script$hscript$type = 'funcs'$param = array(), $func = '') { 
    411.     ......     
    412.  
    413. /** 
    414.  * 获取插件模块 
    415.  */ 
    416. function pluginmodule($pluginid$type) { 
    417.     ......     
    418.  
    419. /** 
    420.  * 执行积分规则 
    421.  * @param String $action:  规则action名称 
    422.  * @param Integer $uid: 操作用户 
    423.  * @param array $extrasql: common_member_count的额外操作字段数组格式为 array('extcredits1' => '1') 
    424.  * @param String $needle: 防重字符串 
    425.  * @param Integer $coef: 积分放大倍数 
    426.  * @param Integer $update: 是否执行更新操作 
    427.  * @param Integer $fid: 版块ID 
    428.  * @return 返回积分策略 
    429.  */ 
    430. function updatecreditbyaction($action$uid = 0, $extrasql = array(), $needle = ''$coef = 1, $update = 1, $fid = 0) { 
    431.     ......     
    432.  
    433. /** 
    434. * 检查积分下限 
    435. * @param string $action: 策略动作Action或者需要检测的操作积分值使如extcredits1积分进行减1操作检测array('extcredits1' => -1) 
    436. * @param Integer $uid: 用户UID 
    437. * @param Integer $coef: 积分放大倍数/负数为减分操作 
    438. * @param Integer $returnonly: 只要返回结果,不用中断程序运行 
    439. */ 
    440. function checklowerlimit($action$uid = 0, $coef = 1, $fid = 0, $returnonly = 0) { 
    441.     ......     
    442.  
    443. /** 
    444.  * 批量执行某一条策略规则 
    445.  * @param String $action:  规则action名称 
    446.  * @param Integer $uids: 操作用户可以为单个uid或uid数组 
    447.  * @param array $extrasql: common_member_count的额外操作字段数组格式为 array('extcredits1' => '1') 
    448.  * @param Integer $coef: 积分放大倍数,当为负数时为反转操作 
    449.  * @param Integer $fid: 版块ID 
    450.  */ 
    451. function batchupdatecredit($action$uids = 0, $extrasql = array(), $coef = 1, $fid = 0) { 
    452.     ......     
    453.  
    454. /** 
    455.  * 添加积分 
    456.  * @param Integer $uids: 用户uid或者uid数组 
    457.  * @param String $dataarr: member count相关操作数组,例: array('threads' => 1, 'doings' => -1) 
    458.  * @param Boolean $checkgroup: 是否检查用户组 true or false 
    459.  * @param String $operation: 操作类型 
    460.  * @param Integer $relatedid: 
    461.  * @param String $ruletxt: 积分规则文本 
    462.  */ 
    463.  
    464. function updatemembercount($uids$dataarr = array(), $checkgroup = true, $operation = ''$relatedid = 0, $ruletxt = '') { 
    465.     if(!emptyempty($uids) && (is_array($dataarr) && $dataarr)) { 
    466.         require_once libfile('function/credit'); 
    467.         return _updatemembercount($uids$dataarr$checkgroup$operation$relatedid$ruletxt); 
    468.     } 
    469.     return true; 
    470.  
    471. /** 
    472.  * 校验用户组 
    473.  * @param $uid 
    474.  */ 
    475. function checkusergroup($uid = 0) { 
    476.     ......     
    477.  
    478. /** 
    479. * 调试信息 
    480. */ 
    481. function debuginfo() { 
    482.     ......     
    483.  
    484. /** 
    485.  * 随机取出一个站长推荐的条目 
    486.  * @param $module 当前模块 
    487.  * @return array 
    488. */ 
    489. function getfocus_rand($module) { 
    490.     ......     
    491.  
    492. /** 
    493.  * 检查验证码正确性 
    494.  * @param $value 验证码变量值 
    495.  */ 
    496. function check_seccode($value$idhash) { 
    497.     ......     
    498.  
    499. /** 
    500.  * 检查验证问答正确性 
    501.  * @param $value 验证问答变量值 
    502.  */ 
    503. function check_secqaa($value$idhash) { 
    504.     ......     
    505.  
    506. /** 
    507.  * 获取广告 
    508.  */ 
    509. function adshow($parameter) { 
    510.     ......     
    511.  
    512. /** 
    513.  * 显示提示信息 
    514.  * @param $message - 提示信息,可中文也可以是 lang_message.php 中的数组 key 值 
    515.  * @param $url_forward - 提示后跳转的 url 
    516.  * @param $values - 提示信息中可替换的变量值 array(key => value ...) 形式 
    517.  * @param $extraparam - 扩展参数 array(key => value ...) 形式 
    518.  *  跳转控制 
    519.         header      header跳转 
    520.         location    location JS 跳转,限于 msgtype = 2、3 
    521.         timeout     定时跳转 
    522.         refreshtime 自定义跳转时间 
    523.         closetime   自定义关闭时间,限于 msgtype = 2,值为 true 时为默认 
    524.         locationtime    自定义跳转时间,限于 msgtype = 2,值为 true 时为默认 
    525.     内容控制 
    526.         alert       alert 图标样式 right/info/error 
    527.         return      显示请返回 
    528.         redirectmsg 下载时用的提示信息,当跳转时显示的信息样式 
    529.                     0:如果您的浏览器没有自动跳转,请点击此链接 
    530.                     1:如果 n 秒后下载仍未开始,请点击此链接 
    531.         msgtype     信息样式 
    532.                     1:非 Ajax 
    533.                     2:Ajax 弹出框 
    534.                     3:Ajax 只显示信息文本 
    535.         showmsg     显示信息文本 
    536.         showdialog  关闭原弹出框显示 showDialog 信息,限于 msgtype = 2 
    537.         login       未登录时显示登录链接 
    538.         extrajs     扩展 js 
    539.         striptags   过滤 HTML 标记 
    540.     Ajax 控制 
    541.         handle      执行 js 回调函数 
    542.         showid      控制显示的对象 ID 
    543.  */ 
    544. function showmessage($message$url_forward = ''$values = array(), $extraparam = array(), $custom = 0) { 
    545.     ......     
    546.  
    547. /** 
    548. * 检查是否正确提交了表单 
    549. * @param $var 需要检查的变量 
    550. * @param $allowget 是否允许GET方式 
    551. * @param $seccodecheck 验证码检测是否开启 
    552. * @return 返回是否正确提交了表单 
    553. */ 
    554. function submitcheck($var$allowget = 0, $seccodecheck = 0, $secqaacheck = 0) { 
    555.     ......     
    556.  
    557. /** 
    558. * 分页 
    559. * @param $num - 总数 
    560. * @param $perpage - 每页数 
    561. * @param $curpage - 当前页 
    562. * @param $mpurl - 跳转的路径 
    563. * @param $maxpages - 允许显示的最大页数 
    564. * @param $page - 最多显示多少页码 
    565. * @param $autogoto - 最后一页,自动跳转 
    566. * @param $simple - 是否简洁模式(简洁模式不显示上一页、下一页和页码跳转) 
    567. * @return 返回分页代码 
    568. */ 
    569. function multi($num$perpage$curpage$mpurl$maxpages = 0, $page = 10, $autogoto = FALSE, $simple = FALSE) { 
    570.     ......     
    571.  
    572. /** 
    573. * 只有上一页下一页的分页(无需知道数据总数) 
    574. * @param $num - 本次所取数据条数 
    575. * @param $perpage - 每页数 
    576. * @param $curpage - 当前页 
    577. * @param $mpurl - 跳转的路径 
    578. * @return 返回分页代码 
    579. */ 
    580. function simplepage($num$perpage$curpage$mpurl) { 
    581.     ......     
    582.  
    583. /** 
    584.  * 词语过滤 
    585.  * @param $message - 词语过滤文本 
    586.  * @return 成功返回原始文本,否则提示错误或被替换 
    587.  */ 
    588. function censor($message$modword = NULL, $return = FALSE) { 
    589.     ......     
    590.  
    591. /** 
    592.     词语过滤,检测是否含有需要审核的词 
    593. */ 
    594. function censormod($message) { 
    595.     ......     
    596.  
    597. /** 
    598. * 刷新重定向 
    599. */ 
    600. function dreferer($default = '') { 
    601.     ......     
    602.  
    603. /** 
    604.  * 远程FTP使用 
    605.  */ 
    606. function ftpcmd($cmd$arg1 = '') { 
    607.     ......     
    608.  
    609. /** 
    610.  * 编码转换 
    611.  * @param <string> $str 要转码的字符 
    612.  * @param <string> $in_charset 输入字符集 
    613.  * @param <string> $out_charset 输出字符集(默认当前) 
    614.  * @param <boolean> $ForceTable 强制使用码表(默认不强制) 
    615.  * 
    616.  */ 
    617. function diconv($str$in_charset$out_charset = CHARSET, $ForceTable = FALSE) { 
    618.     ......     
    619.  
    620. /** 
    621.  * 重建数组 
    622.  * @param <string> $array 需要反转的数组 
    623.  * @return array 原数组与的反转后的数组 
    624.  */ 
    625. function renum($array) { 
    626.     ......     
    627.  
    628. /** 
    629.  * 获取当前脚本在线人数 
    630.  * @param <int> $fid 分类 ID,版块、群组 的 id, 
    631.  * @param <int> $tid 内容 ID,帖子 的 id 
    632.  */ 
    633. function getonlinenum($fid = 0, $tid = 0) { 
    634.     ......     
    635.  
    636. /** 
    637. * 字节格式化单位 
    638. * @param $filesize - 大小(字节) 
    639. * @return 返回格式化后的文本 
    640. */ 
    641. function sizecount($size) { 
    642.     ......     
    643.  
    644. /** 
    645.  * 写入运行日志 
    646.  */ 
    647. function writelog($file$log) { 
    648.     ......     
    649.  
    650. /** 
    651.  * 调色板 
    652.  * @param <type> $colorid 
    653.  * @param <type> $id 
    654.  * @param <type> $background 
    655.  * @return <type> 
    656.  */ 
    657. function getcolorpalette($colorid$id$background$fun = '') { 
    658.     ......     
    659.  
    660. /** 
    661.  * 取得某标志位的数值 (0|1) 
    662.  * 
    663.  * @param 数值 $status 
    664.  * @param 位置 $position 
    665.  * @return 0 | 1 
    666.  */ 
    667. function getstatus($status$position) { 
    668.     ......     
    669.  
    670. /** 
    671.  * 设置某一bit位的数值 0 or 1 
    672.  * 
    673.  * @param int $position  1-16 
    674.  * @param int $value  0|1 
    675.  * @param 原始数值 $baseon  0x0000-0xffff 
    676.  * @return int 
    677.  */ 
    678. function setstatus($position$value$baseon = null) { 
    679.     ......     
    680.  
    681. /** 
    682.  * 通知 
    683.  * @param Integer $touid: 通知给谁 
    684.  * @param String $type: 通知类型 
    685.  * @param String $note: 语言key 
    686.  * @param Array $notevars: 语言变量对应的值 
    687.  * @param Integer $system: 是否为系统通知 0:非系统通知; 1:系统通知 
    688.  */ 
    689. function notification_add($touid$type$note$notevars = array(), $system = 0) { 
    690.     ......     
    691.  
    692. /** 
    693. * 发送管理通知 
    694. * @param $type - 通知类型 
    695. */ 
    696. function manage_addnotify($type$from_num = 0, $langvar = array()) { 
    697.     ......     
    698.  
    699. /** 
    700. * 发送短消息(兼容提醒) 
    701. * @param $toid - 接收方id 
    702. * @param $subject - 标题 
    703. * @param $message - 内容 
    704. * @param $fromid - 发送方id 
    705. */ 
    706. function sendpm($toid$subject$message$fromid = ''$replypmid = 0, $isusername = 0, $type = 0) { 
    707.     ......     
    708.  
    709. /** 
    710.  * 
    711.  * 通过tid得到相应的单一post表名或post表集合 
    712.  * @param <mix> $tids: 允许传进单个tid,也可以是tid集合 
    713.  * @param $primary: 是否只查主题表 0:遍历所有表;1:只查主表 
    714.  * @return 当传进来的是单一的tid将直接返回表名,否则返回表集合的二维数组例:array('forum_post' => array(tids),'forum_post_1' => array(tids)) 
    715.  * @TODO tid传进来的是字符串的,返回单个表名,传进来的是数组的,不管是不是一个数组,返回的还是数组,保证进出值对应 
    716.  */ 
    717. function getposttablebytid($tids$primary = 0) { 
    718.     ......     
    719.  
    720. /** 
    721.  * 获取论坛帖子表名 
    722.  * @param <int> $tableid: 分表ID,默认为:fourm_post表 
    723.  * @param <boolean> $prefix: 是否默认带有表前缀 
    724.  * @return forum_post or forum_post_* 
    725.  */ 
    726. function getposttable($tableid = 0, $prefix = false) { 
    727.     ......     
    728.  
    729. /** 
    730.  * 内存读写接口函数 
    731.  * 
    732.  * @param 命令 $cmd (set|get|rm|check) 
    733.  * @param 键值 $key 
    734.  * @param 数据 $value 
    735.  * @param 有效期 $ttl 
    736.  * @return mix 
    737.  * 
    738.  * @example set : 写入内存 $ret = memory('set', 'test', 'ok') 
    739.  * @example get : 读取内存 $data = memory('get', 'test') 
    740.  * @example rm : 删除内存  $ret = memory('rm', 'test') 
    741.  * @example check : 检查内存功能是否可用 $allow = memory('check') 
    742.  */ 
    743. function memory($cmd$key=''$value=''$ttl = 0) { 
    744.     ......     
    745.  
    746. /** 
    747. * ip允许访问 
    748. * @param $ip 要检查的ip地址 
    749. * @param - $accesslist 允许访问的ip地址 
    750. * @param 返回结果 
    751. */ 
    752. function ipaccess($ip$accesslist) { 
    753.     ......     
    754.  
    755. /** 
    756. * ip限制访问 
    757. * @param $ip 要检查的ip地址 
    758. * @param 返回结果 
    759. */ 
    760. function ipbanned($onlineip) { 
    761.     ......     
    762.  
    763. /** 
    764.  * 系统级消息 
    765.  */ 
    766. function sysmessage($message) { 
    767.     ......     
    768.  
    769. /** 
    770. * 论坛权限 
    771. * @param $permstr - 权限信息 
    772. * @param $groupid - 只判断用户组 
    773. * @return 0 无权限 > 0 有权限 
    774. */ 
    775. function forumperm($permstr$groupid = 0) { 
    776.     ......     
    777.  
    778. /** 
    779.  * PHP 兼容性函数 
    780.  */ 
    781. if(!function_exists('file_put_contents')) { 
    782.     if(!defined('FILE_APPEND')) define('FILE_APPEND', 8); 
    783.     function file_put_contents($filename$data$flag = 0) { 
    784.         $return = false; 
    785.         if($fp = @fopen($filename$flag != FILE_APPEND ? 'w' : 'a')) { 
    786.             if($flag == LOCK_EX) @flock($fp, LOCK_EX); 
    787.             $return = fwrite($fpis_array($data) ? implode(''$data) : $data); 
    788.             fclose($fp); 
    789.         } 
    790.         return $return
    791.     } 
    792.  
    793. //检查权限 
    794. function checkperm($perm) { 
    795.     global $_G
    796.     return (emptyempty($_G['group'][$perm])?'':$_G['group'][$perm]); 
    797.  
    798. /** 
    799. * 时间段设置检测 
    800. * @param $periods - 那种时间段 $settings[$periods]  $settings['postbanperiods'] $settings['postmodperiods'] 
    801. * @param $showmessage - 是否提示信息 
    802. * @return 返回检查结果 
    803. */ 
    804. function periodscheck($periods$showmessage = 1) { 
    805.     ......     
    806.  
    807. /** 
    808.  * 用户操作日志 
    809.  * @param int $uid 用户ID 
    810.  * @param string $action 操作类型 tid=thread pid=post blogid=blog picid=picture doid=doing sid=share aid=article uid_cid/blogid_cid/sid_cid/picid_cid/aid_cid/topicid_cid=comment 
    811.  * @return bool 
    812.  */ 
    813. function useractionlog($uid$action) { 
    814.     ......     
    815.  
    816. /** 
    817.  * 得到用户操作的代码或代表字符,参数为数字返回字符串,参数为字符串返回数字 
    818.  * @param string/int $var 
    819.  * @return int/string 注意:如果失败返回false,请使用===判断,因为代码0代表tid 
    820.  */ 
    821. function getuseraction($var) { 
    822.     ......     
    823.  
    824. /** 
    825.  * 获取我的中心中展示的应用 
    826.  */ 
    827. function getuserapp($panel = 0) { 
    828.     ......     
    829.  
    830. /** 
    831.  * 获取manyou应用本地图标路径 
    832.  * @param <type> $appid 
    833.  */ 
    834. function getmyappiconpath($appid$iconstatus=0) { 
    835.     ......     
    836.  
    837. /** 
    838.  * 获取文字内的url列表 
    839.  * 
    840.  * @param $message 文字 
    841.  * @return <array> url列表 
    842.  * 
    843.  */ 
    844. function get_url_list($message) { 
    845.     ......     
    846.  
    847. /** 
    848.  * 检查文字内的URL 
    849.  * 
    850.  * @param $allowposturl 用户组设置中的值 0=禁止 1=允许但审核 2=允许但不解析 
    851.  * @param $message 待处理的文字内容 
    852.  * @return 0=禁止 1=允许但审核 2=允许但不解析 
    853.  */ 
    854. function checkurl($allowposturl, &$message) { 
    855.     ......     
    856.  
    857. /** 
    858.  * 更新页面和模块的关系 
    859.  * @param string $targettplname 页面名称 
    860.  * @param array $blocks 模块IDS 
    861.  */ 
    862. function update_template_block($targettplname$blocks) { 
    863.     ......     
    864.  
    865. /** 
    866.  * 获取批定类型的关联连接 
    867.  * 
    868.  * @param string $extent 内容所需关联链接范围 article, forum, group, blog 
    869.  * @return string 有效的关联链接 
    870.  */ 
    871. function getrelatedlink($extent) { 
    872.     ......     
    873.  
    874. /** 
    875.  * 判断 Connect 链接参数有效性 
    876.  * @global  $_G 
    877.  * @param array $params 参数数组 
    878.  * @param array $connect_params 返回参数 
    879.  * @return boolean 
    880.  */ 
    881. function connect_valid($params, &$connect_params) { 
    882.     ......     
    883.  
    884. /** 
    885.  * 获取 Token 
    886.  * @global  $_G 
    887.  * @param string $type 
    888.  * @return string 
    889.  */ 
    890. function connect_get_access_token($type = 'USER') { 
    891.     ......     
    892.  
    893. /** 
    894.  * 获取 Connect 参数签名 
    895.  * @param array $params 参数数组 
    896.  * @param string $access_token 加密 Token 
    897.  * @return string 
    898.  */ 
    899. function connect_get_sig($params$access_token) { 
    900.     ......     
    901.  
    902. /** 
    903.  * 通过 AID 获取附件表名 
    904.  * @param <int> $aid 
    905.  */ 
    906. function getattachtablebyaid($aid) { 
    907.     ......     
    908.  
    909. /** 
    910.  * 返回指定 TID 所对应的附件表编号 
    911.  * @param <int> $tid 
    912.  */ 
    913. function getattachtableid($tid) { 
    914.     ......     
    915.  
    916. /** 
    917.  * 通过 TID 获取附件表名 
    918.  * @param <int> $tid 
    919.  */ 
    920. function getattachtablebytid($tid) { 
    921.     ......     
    922.  
    923. /** 
    924.  * 通过 PID 获取附件表名 
    925.  * @param <int> $pid 
    926.  */ 
    927. function getattachtablebypid($pid) { 
    928.     ......     
    929.  
    930. /** 
    931.  * 添加一个新的附件索引记录,并返回新附件 ID 
    932.  * @param <int> $uid 
    933.  */ 
    934. function getattachnewaid($uid = 0) { 
    935.     ......     
    936.  
    937. /** 
    938.  * 获取 SEO设置 
    939.  * @param string $page 调用哪个页面的 
    940.  * @param array $data 可替换数据 
    941.  * @return array('seotitle', 'seodescription', 'seokeywords') 
    942.  */ 
    943. function get_seosetting($page$data = array(), $defset = array()) { 
    944.     ......     
    945.  
    946. /** 
    947.  * 需处理连续分隔符的str_replace() 
    948.  * @param array $searchs 被替换的数组 
    949.  * @param array $replaces 用于替换的数组 
    950.  * @param string $str 目标字符串 
    951.  */ 
    952. function strreplace_strip_split($searchs$replaces$str) { 
    953.     ......     
    954.  
    955. /** 
    956.  * 返回带第几页的title 
    957.  * @global  $_G 
    958.  * @param string $navtitle 源标题 
    959.  * @param int $page 页码 
    960.  * @return string 
    961.  */ 
    962. function get_title_page($navtitle$page){ 
    963.     if($page > 1) { 
    964.     ......     
    965.  
    966. /** 
    967.  * 
    968.  * 生成缩略图文件名 
    969.  * @param String $fileStr: 原文件名,允许附带路径 
    970.  * @param String $extend: 新文件名后缀 
    971.  * @param Boolean $holdOldExt: 是否保留原扩展名 
    972.  * @return 返加新的后缀文件名 
    973.  */ 
    974. function getimgthumbname($fileStr$extend='.thumb.jpg'$holdOldExt=true) { 
    975.     ......     
    976.  
    977. /** 
    978.  * 更新数据的审核状态 
    979.  * @param <string> $idtype 数据类型 tid=thread pid=post blogid=blog picid=picture doid=doing sid=share aid=article uid_cid/blogid_cid/sid_cid/picid_cid/aid_cid/topicid_cid=comment 
    980.  * @param <array/int> $ids ID 数组、ID 值 
    981.  * @param <int> $status 状态 0=加入审核(默认) 1=忽略审核 2=审核通过 
    982.  */ 
    983. function updatemoderate($idtype$ids$status = 0) { 
    984.     ......     
    985.  
    986. /** 
    987.  * 显示漫游应用公告 
    988.  */ 
    989. function userappprompt() { 
    990.     ......     

     

本文来源地址:http://jancy.iteye.com/blog/1260834