本文对官方教程中的帝国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代码里的”<“,”<?”,”<%”为”&lt;”,”&lt;?”,”&lt;%”

位置:/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:网址