帝国CMS一些常用封装好的函数介绍和使用方法

函数:printerror()
功能:提示信息
位置:/e/class/connect.php line 108
参数:
        $error:提示信息
        $gotourl:转向地址
例子:printerror("RegisterSuccess","history.go(-1)",1); //返回上个页面.

函数:ReturnLeftLevel()
功能:验证操作权限
位置:/e/class/functions.php line 3144
参数:
        $groupid:组id

函数:checklevel()
功能:验证操作权限
位置: /e/class/functions.php line 3154
参数:
        $userid:用户id
        $username:用户名
        $classid:栏目id
        $enews:模块名   //$enews="news"

函数:insert_dolog()
功能:记录日志
位置:/e/class/functions.php line 3295
参数:
        $doing:日志信息

函数:db_connect()
功能:连接数据库
位置: /e/class/connect.php line 43
参数:无

函数:db_close()
功能:关闭数据库
位置:/e/class/connect.php line 86
参数:无

函数:is_login()
功能:是否登录
位置:/e/class/functions.php line 3184
参数:  //不需要参数也能验证是否登录
        $uid:用户id
        $uname:帐号
        $urnd:随机码
例子:$lur=is_login();   //返回一个用户数组

函数:RepPostVar()
功能:字符串替换处理
位置:/e/class/connect.php line 309
参数:
        $val:字符串

函数:gettotal()
功能:统计记录数
位置:/e/class/db_sql.php line 52
参数:
        $query:sql语句

函数:lastid()
功能:获得最后执行sql的id
位置:/e/class/db_sql.php line 70
参数:无

函数:getcvar()
功能:返回cookie / 配合esetcookie()使用
位置:/e/class/connect.php line 125
参数:
        $var:必填 cookie名
        $ecms:选填, 0是前台. 1是后台. 默认0.

函数:esetcookie()
功能:设置cookie / 函数向客户端发送一个 HTTP cookie 主要带了帝国CMS前后台cookie前缀 path 等用起来方便
位置:/e/class/connect.php line 118
参数:
        $var:必填 cookie名
        $val:必填 cookie值
        $life:选填,过期unix时间戳
        $ecms:选填, 0是前台. 1是后台. 默认0.

函数:LoadLang()
功能:载入语言包
位置:/e/class/connect.php line 294
参数:
        $file:语言包文件名

函数:islogin()
功能:验证是否登录
位置:/e/class/user.php line 775
参数:
        $uid:用户id
        $uname:帐号
        $urnd:随机码
例子:$user_r=islogin();   //返回一个用户数组

函数:Close()
功能:关闭SMTP
位置:/e/class/class.smtp.php line 193
参数:无

函数:reppoststr()
功能:处理提交字符
位置:/e/class/connect.php line 381
参数:
        $val:字符串
        $ecms:默认为0.
例子:$val=RepPostStr($val,1);

函数:page2()
功能:后台分页
位置:/e/class/functions.php line 58
参数:
        $num:总数
        $line:每页显示多少条
        $page_line:每页显示链接数
        $start:没用
        $page:当前页号加1
        $search:参数   //&orderby=0&mydesc=0 
例子:$returnpage=page2($num,$line,$page_line,$start,$page,$search);//http: //192.168.0.55/ListUser.php?page=0&orderby=0&mydesc=0

函数:page1()
功能:前台分页
位置:/e/class/connect.php line 539
参数:$num:总数
        $line:每页显示多少条
        $page_line:每页显示链接数
        $start:没用
        $page:当前页号加1
        $search:参数   //&orderby=0&mydesc=0 
例子:$returnpage=page1($num,$line,$page_line,$start,$page,$search);//http: //192.168.0.55/ListUser.php?page=0&orderby=0&mydesc=0

函数:SpOpenChFile()
功能:上传图片
位置:/e/admin/AddNews.php line 399
参数:
        type:类型  //1是图片.2是flash文件.3是多媒体文件.0是其他附件.
        field:默认是titlepic.应该是标题图片的意思

函数:GetTemptb()
功能:返回模板表名
位置:/e/class/connect.php line 248
参数:
        $temptb:表名
例子:select tempid,tempname from GetTemptb("enewsvotetemp")

函数:RepPhpAspJspcode()
功能:替换php代码里的"<\\","<?","<%"为"&lt;\\","&lt;?","&lt;%"
位置:/e/class/q_functions.php line 47
参数:
        $string:字符串

函数:sys_ReturnBqTitleLink()
功能:返回标题连接
位置:/e/class/connect.php line 797
参数:
        $r:从数据库获取的数组

函数:GetConfig()
功能:更新配置文件config.php
位置:/e/class/functions.php line 4745
参数:
        $domod:默认为0，为1时更新e/class/config.php文件
例子:GetConfig(1);

函数:to_time()
功能:返回unix时间戳
位置:/e/class/connect.php line 587
参数:
        $datetime:时间 //日期类型格式如:2012-12-12 日期时间如:2012-12-12 12:12:12

函数:doUtfAndGbk()
功能:编码转化
位置:/e/class/user.php line 50
参数:
        $str:字符串
        $phome:默认为0.为0时是UTF8转GBK. 为1时是GBK转UTF8。

函数:CheckFileMod()
功能:检查文件或目录的权限
位置:/e/admin/PathLevel.php line 37
参数:
        $filename:文件或目录地址
        $smallfile="":默认为空.
例子://1、CheckFileMod("../../d","../../d/txt")      //2、CheckFileMod("../../s")

函数:WriteFiletext_n()
功能:写入文件
位置:/e/class/connect.php line 671
备注:WriteFiletext_n() 和WriteFiletext()功能一样，WriteFiletext()写入的时候删除由 [addslashes()](http://www.w3school.com.cn/php/func_string_addslashes.asp "PHP addslashes() 函数") 函数添加的反斜杠。
参数:
        $filepath:文件地址
        $string:要写入的内容
例子:
        <?php
                  $jsfile="../data/fc/cmsclass.js";
                   WriteFiletext_n($jsfile,"document.write(\"".addslashes($jsstr)."\");");
         ?>

函数:sub()
功能:截取字符串
位置:/e/class/connect.php line 442
参数:
        $string:字符串
        $start:默认是0.开始截取的位置
        $length:截取的长度
        $mode=false:默认是false.
        $dot:默认为空.截取后末尾的字符。例如:.......
例子:sub($value,0,$subtitle,false,'');

函数:esub()
功能:截取字数
位置:/e/class/connect.php line 498
参数:
        $string:字符串
        $length:截取长度
        $dot:默认为空。例如:...........

函数:egetip()
功能:获取ip
位置:/e/class/connect.php line 300
参数:无

函数:ReadFiletext()
功能:获取文件内容
位置:/e/class/connect.php line 637
参数:
        $filepath:文件地址

函数:DoMkdir()
功能:建立目录
位置:/e/class/connect.php line 708
参数:
        $path:要建立的目录

函数:DoChmodFile()
功能:设置上传文件的目录权限
位置:/e/class/connect.php line 741
参数:
        $file:目录

函数:SubSmalltextVal()
功能:截取简介
位置:/e/class/connect.php line 1218
参数:
        $value:字符串
        $len:要截取的长度

函数:GetFiletype()
功能:获取文件扩展名
位置:/e/class/connect.php line 411
参数:
        $filename:文件名

函数:clearaddsdata()
功能:删除由 [addslashes()](http://www.w3school.com.cn/php/func_string_addslashes.asp "PHP addslashes() 函数") 函数添加的反斜杠。
位置:/e/class/connect.php line 2046
参数:
        $data:字符串

函数:AddAddsData()
功能:添加反斜杠
位置:/e/class/connect.php line 2055
参数:
        $data:字符串

函数:wipespecial()
功能:回车替换
位置:/e/class/ftp.php line 8
参数:
        $str:字符串

函数:ReplaceFc()
功能:替换回车
位置:/e/class/ftp.php line 8
参数:
        $str:字符串

函数:ReturnFormHidden()
功能:添加隐藏表单项
位置:/e/class/functions.php line 388
参数:
        $vname:name值
        $value:value值
例子:<input type=hidden name=\"".$vname."\" value=\"".$value."\">

函数:GetHtml()
功能:生成内容页
位置:/e/class/functions.php line 1992
参数:
        $add:当前要生成内容页的数组

函数:make_password()
功能:获取随机数
位置:/e/class/connect.php line 503
参数:
        $pw_length:位数

函数:DoTitleFont()
功能:标题属性(粗体/斜体/删除线)
位置:/e/class/connect.php line 683
参数:
       $titlefont:信息数组的titlefont字段
       $title:信息数组的title字段
例子:DoTitleFont($r[titlefont],$r[title])

函数:InstallShowMsg()
功能:js提示跳转返回
位置:/e/install/data/fun.php line 218
参数:
        $msg:提示信息
        $url:网址

一、esub()截取字段函数 
语法：esub(字符串,截取字数,后缀) 
说明：后缀为截取字符后附带内容，此参数可以省略。 
使用范例： 
<?=esub('12345678',6)?>，返回结果为：123456 
<?=esub('12345678',6,'...')?>，返回结果为：123456... 

二、date()转换时间格式函数 
语法：date(时间格式,时间戳) 
说明：PHP本身函数，使用说明可以参考：http://cn.php.net/manual/en/function.date.php 
使用范例： 
<?=date('Y-m-d H:i:s',1277865010)?>，返回结果为：2010-06-30 10:30:10

三、format_datetime()转换时间格式函数2 
语法：format_datetime(正常时间,时间格式) 
说明：和date()的区别是format_datetime是转换正常时间，而date是转换unix时间戳。 
使用范例： 
<?=format_datetime('2010-06-30 10:30:10','m/d')?>，返回结果为：06/30 

四、通过ID取得栏目地址函数 
语法：sys_ReturnBqClassname($r,9) 
说明：$r为含栏目ID的数组，变量名可任意命名。 
使用范例：取得栏目ID=2的栏目地址。 
<?php 
$cr['classid']=2; 
$classurl=sys_ReturnBqClassname($cr,9); 
echo $classurl; 
?> 

通过ID取得栏目地址的其他方法： 
(1)、/e/public/ClassUrl/?classid=栏目ID 
(2)、/<?=$class_r[栏目ID]['classpath']?> 

五、取得信息内容页地址函数 
语法：sys_ReturnBqTitleLink($r) 
说明：$r为含“id,classid,newspath,filename,groupid,titleurl”字段内容的数组，变量名可任意命名。 
使用范例：取得信息ID=8的新闻页面地址 
<?php 
$nr=$empire->fetch1("select id,classid,newspath,filename,groupid,titleurl from {$dbtbpre}ecms_news where id='8' limit 1"); 
$titleurl=sys_ReturnBqTitleLink($nr); 
echo $titleurl; 
?> 

通过ID取得信息内容页地址的其他方法： 
/e/public/InfoUrl/?classid=栏目ID&id=信息ID 

六、提示信息函数1 
语法：printerror($error,$gotourl,$ecms,$noautourl,$novar) 
说明： 
$error：提示信息内容，可以为语言包变量，也可以直接提示内容。 
$gotourl：提示信息转向链接地址 
$ecms：0为后台提示信息、1为前台提示信息、8为后台提示信息(alert方式)、9为前台提示信息(alert方式) 
$noautourl：0为自动转向页面，1为不自动转向页面。此参数可省略，默认为0 
$novar：0为提示信息内容采用语言包变量，1为提示信息内容为直接提示内容。此参数可以省略，默认为0 
使用范例： 
printerror('DbError','http://www.phome.net',1)，前台提示，提示信息内容为语言包DbError变量内容，转向帝国网站 
printerror('数据库出错','http://www.phome.net',1,0,1)，前台提示，提示信息内容为“数据库出错”，转向帝国网站 
附加说明： 
此函数需结合$editor变量来确定目录层次。默认$editor变量为0。 
当程序文件在/e/path/目录，$editor不用设置，也就是用默认0。 
当程序文件在/e/path/path2/目录，$editor=1。 
当程序文件在/e/path/path2/path3/目录，$editor=2。 
当程序文件在/e/path/path2/path3/path4/目录，$editor=3。 

七、提示信息函数2 (直接提示内容) 
语法：printerror2($error,$gotourl,$ecms,$noautourl) 
说明： 
$error：直接提示信息的内容。 
$gotourl：提示信息转向链接地址 
$ecms：0为默认提示信息方式、9为弹出提示信息方式(alert方式)。此参数可省略，默认为0 
$noautourl：0为自动转向页面，1为不自动转向页面。此参数可省略，默认为0 
使用范例： 
printerror2('添加完毕','http://www.phome.net')，提示信息内容为“添加完毕”，转向帝国网站 
附加说明： 
此函数不需要结合其他变量，可以在任意目录层次使用。不支持使用语言包变量。

八、设置系统COOKIE变量函数 
语法：esetcookie($var,$val,$life,$ecms) 
说明： 
$var：为变量名 
$val：为变量值 
$life：为COOKIE有效时间，单位秒，0为不保存。此参数可省略，默认为不保存。 
$ecms：0为设置前台COOKIE变量，1为设置后台COOKIE变量。此参数可省略，默认为0。 
使用范例： 
esetcookie('mybody','帝国')，定义前台“COOKIE前缀+mybody”变量，变量内容为“帝国” 
esetcookie('mybody','帝国',0,1)，定义后台“COOKIE前缀+mybody”变量，变量内容为“帝国” 
附加说明： 
此设置COOKIE函数会给变量名加上COOKIE前缀，你可也可以直接用PHP本身的setcookie来定义。

九、取得系统COOKIE变量函数 
语法：getcvar($var,$ecms) 
说明： 
$var：为变量名 
$ecms：0为设置前台COOKIE变量，1为设置后台COOKIE变量。此参数可省略，默认为0。 
使用范例： 
getcvar('mlusername')，取得前台登陆会员的用户名 
getcvar('loginusername',1)，取得后台登陆管理员的用户名 
附加说明： 
此取得COOKIE函数是取得变量名加上COOKIE前缀的变量，你可也可以直接用PHP本身的$_COOKIE['变量名']来取得。 

十、取得IP地址函数 
语法：egetip() 
使用范例： 
<?php 
$ip=egetip(); 
echo $ip; 
?> 

十一、动态页面显示分页函数 
语法：page1($num,$line,$page_line,$start,$page,$search) 
说明： 
$num：总记录数 
$line：每页显示数量 
$page_line：每页显示分页链接数 
$start：预设变量，设置0即可。 
$page：当前页码(0为起始页码) 
$search：链接附加参数 

十二、通过栏目ID取得栏目名和栏目别名方法： 
栏目名：<?=$class_r[栏目ID]['classname']?> 
栏目别名：<?=$class_r[栏目ID]['bname']?>