帝国CMS8.0版（Empire CMS）中一些常用函数的介绍，分类整理如下：

日期相关

一、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

三、to_time()时间转unix时间戳函数

语法：to_time(正常时间)

说明：将日期或时间转为unix时间戳。

使用范例：

<?=to_time('2010-06-30 10:30:10')?>，返回结果为：1277865010

<?=to_time('2010-06-30')?>，返回结果为：1277827200

信息相关

一、通过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']?>

二、通过ID取得栏目地址函数2

语法：sys_eReturnBqClassUrl(栏目ID)

说明：和sys_ReturnBqClassname()的区别是sys_eReturnBqClassUrl参数是栏目ID。

使用范例：取得栏目ID=2的栏目地址。

<?php

$classurl=sys_eReturnBqClassUrl(2);

echo $classurl;

?>

三、通过ID取得专题地址函数

语法：sys_ReturnBqZtname($r)

说明：$r为含专题ID的数组，变量名可任意命名。

使用范例：取得专题ID=2的专题地址。

<?php

$ztr['ztid']=2;

$zturl=sys_ReturnBqZtname($ztr);

echo $zturl;

?>

四、通过ID取得专题地址函数2

语法：sys_eReturnBqZtUrl(专题ID)

说明：和sys_ReturnBqZtname()的区别是sys_eReturnBqZtUrl参数是专题ID。

使用范例：取得专题ID=2的专题地址。

<?php

$zturl=sys_eReturnBqZtUrl(2);

echo $zturl;

?>

五、取得专题子类地址函数

语法：sys_ReturnBqZtTypeUrl($r)

说明：$r为含“ztid,tfile,ttype”的数组，变量名可任意命名。

使用范例：取得专题子类ID=6的地址

<?php

$zttyper=$empire->fetch1("select ztid,ttype,tfile from {$dbtbpre}enewszttype where cid='6'");

$zttypeurl=sys_ReturnBqZtTypeUrl($zttyper);

echo $zttypeurl;

?>

六、通过ID取得标题分类地址函数

语法：sys_ReturnBqInfoTypeUrl(标题分类ID)

说明：参数是标题分类ID。

使用范例：取得标题分类ID=2的标题分类页地址。

<?php

$tturl=sys_ReturnBqInfoTypeUrl(2);

echo $tturl;

?>

七、取得信息内容页地址函数

语法：sys_ReturnBqTitleLink($r)

说明：$r为含“id,classid,isurl,titleurl”字段内容的数组，变量名可任意命名。

使用范例：取得信息ID=8的新闻页面地址

<?php

$nr=$empire->fetch1("select id,classid,isurl,titleurl from {$dbtbpre}ecms_news where id='8'");

$titleurl=sys_ReturnBqTitleLink($nr);

echo $titleurl;

?>

通过ID取得信息内容页地址的其他方法：

/e/public/InfoUrl/?classid=栏目ID&id=信息ID

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

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

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

九、esub()截取字段函数

语法：esub(字符串,截取字数,后缀)

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

使用范例：

<?=esub('12345678',6)?>，返回结果为：123456

<?=esub('12345678',6,'...')?>，返回结果为：123456...

十、动态页面显示分页函数

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

说明：

$num：总记录数

$line：每页显示数量

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

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

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

$search：链接附加参数

提示信息函数

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

附加说明：(8.0以上版本可不指定)

此函数需结合$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')，提示信息内容为“添加完毕”，转向帝国网站

附加说明：

此函数不需要结合其他变量，可以在任意目录层次使用。不支持使用语言包变量。

三、提示信息函数3 (直接转向地址)

语法：printerrortourl($gotourl,$error,$sec)

说明：

$gotourl：提示信息转向链接地址

$error：直接提示信息的内容。

$sec：几秒后转向地址，默认为0

使用范例：

printerrortourl('http://www.phome.net','添加完毕',2)，提示信息内容为“添加完毕”，2秒后转向帝国网站

附加说明：

此函数不需要结合其他变量，可以在任意目录层次使用。不支持使用语言包变量。

其他函数

一、设置系统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;

?>