discuz 系统函数库function_core注释

 

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