帝国CMS常用函数 · 常用笔记

# 帝国CMS常用函数 ``` <pre class="calibre15">``` 函数: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代码里的"<\\","<?","<%"为"<\\","<?","<%" 位置:/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']?> ``` ```