帝国cms常用函数汇总给仿站或二次开发的朋友参考

本文对官方教程中的帝国CMS常用函数介绍进行了重新整理和补充，加上了函数位置，方便仿站和二次开发的同学参考

　　帝国cms常用函数：

　　一、esub()截取字段函数

语法：esub($string,$length,后缀)

位置：/e/class/connect.php line 498

参数说明：

$string：字符串

$length：截取长度

默认为空。例如：...........

后缀为截取字符后附带内容，此参数可以省略。

使用范例：

<?=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)

位置：/e/class/connect.php line 797

参数说明：$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)

位置：/e/class/connect.PHP line 108

参数说明：

$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)，前台提示，提示信息内容为“数据库出错”，转向帝国网站

printerror("RegisterSuccess","history.Go(-1)",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)

位置：/e/class/connect.php line 118

参数说明：

$var：必填，为cookie变量名

$val：必填，为cookie变量值

$life：选填，为COOKIE有效时间，单位秒，0为不保存。此参数可省略，默认为不保存。

$ecms：选填，0为设置前台COOKIE变量，1为设置后台COOKIE变量。此参数可省略，默认为0。

使用范例：

esetcookie('mybody','帝国')，定义前台“COOKIE前缀+mybody”变量，变量内容为“帝国”

esetcookie('mybody','帝国',0,1)，定义后台“COOKIE前缀+mybody”变量，变量内容为“帝国”

附加参数说明：

此设置COOKIE函数会给变量名加上COOKIE前缀，你可也可以直接用PHP本身的setcookie来定义。

　　九、取得系统COOKIE变量函数，配合esetcookie()使用

语法：getcvar($var,$ecms)

位置：/e/class/connect.php line 125

参数说明：

$var：必填，为cookie变量名

$ecms：选填，0为设置前台COOKIE变量，1为设置后台COOKIE变量。此参数可省略，默认为0。

使用范例：

getcvar('mlusername')，取得前台登陆会员的用户名

getcvar('loginusername',1)，取得后台登陆管理员的用户名

附加参数说明：

此取得COOKIE函数是取得变量名加上COOKIE前缀的变量，你可也可以直接用PHP本身的$_COOKIE['变量名']来取得。

　　十、取得IP地址函数

语法：egetip()

位置：/e/class/connect.php line 300

使用范例：

<?php

$ip=egetip();

echo $ip;

　　十一、动态页面显示分页函数：前台分页

语法：page1($num,$line,$page_line,$start,$page,$search)

位置：/e/class/connect.php line 539

参数说明：

$num：总记录数

$line：每页显示数量

$page_line：每页显示分页链接数

$start：预设变量，设置0即可。

$page：当前页码加1(0为起始页码)

$search：链接附加参数//&orderby=0&mydesc=0

　　十二、动态页面显示分页函数：后台分页

语法：page2($num,$line,$page_line,$start,$page,$search)

位置：/e/class/functions.php line 58

参数说明：

$num：总记录数

$line：每页显示数量

$page_line：每页显示分页链接数

$start：预设变量，设置0即可。

$page：当前页码加1(0为起始页码)

$search：链接附加参数//&orderby=0&mydesc=0

　　十三、通过栏目ID取得栏目名和栏目别名方法：

栏目名：<?=$class_r[栏目ID]['classname']?>

栏目别名：<?=$class_r[栏目ID]['bname']?>

　　更多帝国cms函数查看：

1.函数：ReturnLeftLevel()

功能：验证操作权限

位置：/e/class/functions.php line 3144

参数：

$groupid：组id

2.函数：checklevel()

功能：验证操作权限

位置： /e/class/functions.php line 3154

参数：

$userid：用户id

$username：用户名

$classid：栏目id

$enews：模块名 //$enews="news"

3.函数：insert_dolog()

功能：记录日志

位置：/e/class/functions.php line 3295

参数：

$doing：日志信息

4.函数：db_connect()

功能：连接数据库

位置： /e/class/connect.php line 43

参数：无

5.函数：db_close()

功能：关闭数据库

位置：/e/class/connect.php line 86

参数：无

6.函数：is_login()

功能：是否登录

位置：/e/class/functions.php line 3184

参数： //不需要参数也能验证是否登录

$uid：用户id

$uname：帐号

$urnd：随机码

例子：$lur=is_login(); //返回一个用户数组

7.函数：RepPostVar()

功能：字符串替换处理

位置：/e/class/connect.php line 309

参数：

$val：字符串

8.函数：gettotal()

功能：统计记录数

位置：/e/class/db_sql.php line 52

参数：

$query：sql语句

9.函数：lastid()

功能：获得最后执行sql的id

位置：/e/class/db_sql.php line 70

参数：无

10.函数：LoadLang()

功能：载入语言包

位置：/e/class/connect.php line 294

参数：

$file：语言包文件名

11.函数：islogin()

功能：验证是否登录

位置：/e/class/user.php line 775

参数：

$uid：用户id

$uname：帐号

$urnd：随机码

例子：$user_r=islogin(); //返回一个用户数组

12.函数：Close()

功能：关闭SMTP

位置：/e/class/class.smtp.php line 193

参数：无

13.函数：reppoststr()

功能：处理提交字符

位置：/e/class/connect.php line 381

参数：

$val：字符串

$ecms：默认为0.

例子：$val=RepPostStr($val,1);

14.函数：SpOpenChFile()

功能：上传图片

位置：/e/admin/AddNews.php line 399

参数：

type：类型 //1是图片.2是flash文件.3是多媒体文件.0是其他附件.

field：默认是titlepic.应该是标题图片的意思

15.函数：GetTemptb()

功能：返回模板表名

位置：/e/class/connect.php line 248

参数：

$temptb：表名

例子：select tempid,tempname from GetTemptb("enewsvotetemp")

16.函数：RepPhpAspJspcode()

功能：替换php代码里的"<\\","<?","<%"为"<\\","<?","<%"

位置：/e/class/q_functions.php line 47

参数：

$string：字符串

17.函数：GetConfig()

功能：更新配置文件config.php

位置：/e/class/functions.php line 4745

参数：

$domod：默认为0，为1时更新e/class/config.php文件

例子：GetConfig(1);

18.函数：to_time()

功能：返回unix时间戳

位置：/e/class/connect.php line 587

参数：

$datetime：时间 //日期类型格式如：2012-12-12 日期时间如：2012-12-12 12：12：12

19.函数：doUtfAndGbk()

功能：编码转化

位置：/e/class/user.php line 50

参数：

$str：字符串

$phome：默认为0.为0时是UTF8转GBK. 为1时是GBK转UTF8。

20.函数：CheckFileMod()

功能：检查文件或目录的权限

位置：/e/admin/PathLevel.php line 37

参数：

$filename：文件或目录地址

$smallfile=""：默认为空.

例子：//1、CheckFileMod("../../d","../../d/txt") //2、CheckFileMod("../../s")

21.函数：WriteFiletext_n()

功能：写入文件

位置：/e/class/connect.php line 671

备注：WriteFiletext_n() 和WriteFiletext()功能一样，WriteFiletext()写入的时候删除由 addslashes() 函数添加的反斜杠。

参数：

$filepath：文件地址

$string：要写入的内容

例子：

<?php

$jsfile="../data/fc/cmsclass.js";

WriteFiletext_n($jsfile,"document.write(\"".addslashes($jsstr)."\");");

22.函数：sub()

功能：截取字符串

位置：/e/class/connect.php line 442

参数：

$string：字符串

$start：默认是0.开始截取的位置

$length：截取的长度

$mode=false：默认是false.

$dot：默认为空.截取后末尾的字符。例如：.......

例子：sub($value,0,$subtitle,false,'');

23.函数：egetip()

功能：获取ip

位置：/e/class/connect.php line 300

参数：无

24.函数：ReadFiletext()

功能：获取文件内容

位置：/e/class/connect.php line 637

参数：

$filepath：文件地址

25.函数：DoMkdir()

功能：建立目录

位置：/e/class/connect.php line 708

参数：

$path：要建立的目录

26.函数：DoChmodFile()

功能：设置上传文件的目录权限

位置：/e/class/connect.php line 741

参数：

$file：目录

27.函数：SubSmalltextVal()

功能：截取简介

位置：/e/class/connect.php line 1218

参数：

$value：字符串

$len：要截取的长度

28.函数：GetFiletype()

功能：获取文件扩展名

位置：/e/class/connect.php line 411

参数：

$filename：文件名

29.函数：clearaddsdata()

功能：删除由 addslashes() 函数添加的反斜杠。

位置：/e/class/connect.php line 2046

参数：

$data：字符串

30.函数：AddAddsData()

功能：添加反斜杠

位置：/e/class/connect.php line 2055

参数：

$data：字符串

31.函数：wipespecial()

功能：回车替换

位置：/e/class/ftp.php line 8

参数：

$str：字符串

32.函数：ReplaceFc()

功能：替换回车

位置：/e/class/ftp.php line 8

参数：

$str：字符串

33.函数：ReturnFormHidden()

功能：添加隐藏表单项

位置：/e/class/functions.php line 388

参数：

$vname：name值

$value：value值

例子：<input type=hidden name=\"".$vname."\" value=\"".$value."\">

34.函数：GetHtml()

功能：生成内容页

位置：/e/class/functions.php line 1992

参数：

$add：当前要生成内容页的数组

35.函数：make_password()

功能：获取随机数

位置：/e/class/connect.php line 503

参数：

$pw_length：位数

36.函数：DoTitleFont()

功能：标题属性(粗体/斜体/删除线)

位置：/e/class/connect.php line 683

参数：

$titlefont：信息数组的titlefont字段

$title：信息数组的title字段

例子：DoTitleFont($r[titlefont],$r[title])

37.函数：InstallShowMsg()

功能：js提示跳转返回

位置：/e/install/data/fun.php line 218

参数：

$msg：提示信息

$url：网址

帝国cms常用函数汇总给仿站或二次开发的朋友参考