精華 帝國PHP系統CMS常用函數介紹

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