phpcms公用庫函數原型

message($alert,$goback='');--; 顯示JS消息對話框形式的提示信息

無返回值，$alert為提示信息內容，$goback參數是用戶確認后跳轉的url地址（此參數可選，默認為空即不進行跳轉，如果該參數的值為 “goback”，則用戶確認后瀏覽器自動跳轉到前一個打開的地址，如果該參數的值為“close”，則用戶確認后瀏覽器自動關閉當前窗口。

createdir($dir='');--; 創建目錄

無返回值，$dir參數必須是一個目錄地址，默認為空不創建目錄。目錄地址可以是多層次的目錄，該函數會逐層目錄地檢查該目錄是否創建，如果已經創建則繼續檢查下級目錄，如果沒有創建則自動創建目錄。目錄屬性默認為 0777

file_write($filename,$content);--; 創建一個文件并寫入內容

無返回值，$filename為要創建的文件名，$content為要寫入該文件的內容。

dhtmlspecialchars($string);--; 把特殊字符轉換為html實體

返回字符串或者數組，$string參數可以是一個字符串，也可以是一個數組。

daddslashes($string) -- 使用反斜線引用字符串

返回字符串或者數組，該字符串為了數據庫查詢語句等的需要在某些字符前加上了反斜線。這些字符是單引號（'）、雙引號（'）、反斜線（）與 NUL（NULL 字符）。

random($length,$chars='0123456789') -- 生成隨機字符串

返回字符串，$length為返回的字符串長度，$chars為字符串的組成字符，默認為數字即'0123456789'。

language($file,$language) -- 獲取語言包文件的路徑

返回字符串，$file為文件名（不帶后綴.php），$language為語言包目錄（比如“chinese-gb2312”）。

template($file,$admin=0) -- 獲取模板文件路徑

返回字符串，$file為文件名（不帶后綴.htm），$admin參數為可選值，默認值為0，即表示調用前臺模板文件，如果$admin=1，則表示調用后臺模板文件。

html($file) -- 調用 ./include/html/ 目錄下的文件并執行

無返回值，$file參數為不帶后綴.php的文件名，該文件應該是存在于 ./include/html/ 目錄下的，調用此函數后該文件將被執行，通常情況下次函數用在生成html的程序中

articlepage($pagenumber=1,$page=0,$path='') -- 一篇文章分頁

返回字符串，$pagenumber為文章總頁數默認為1，$page為當前頁數默認為0，$path為文章路徑。此函數返回一篇文章的分頁連接。

showpage($totle,$perpage=30,$page=1,$url='?') -- 文章分頁

返回字符串，$totle 為總記錄數，$perpage為每頁顯示的記錄條數（默認為30），$page為當前頁碼（默認為1），$url為分頁鏈接的基準地址（默認為“?”），此函數將返回文章分頁的鏈接。

wordscut($string, $length ,$sss=0) -- 字符串截斷

返回字符串，$string為需要截斷的字符串，$length為截斷后的最大長度，$sss為設置是否顯示“...”的開關，當值為1時顯示“...”，默認為不顯示。

str_out($string) -- 處理要輸出的字符串

返回字符串或者數組，$string為要處理的字符串或者數組，該函數會還原經addslashes處理過的字符串，把html實體化，把textarea中的換行變成“<br>”，把空格變成“&nbsp;”。

str_in($string) -- 處理插入到數據庫的字符串

返回字符串或者數組，$string為要處理的字符串或者數組，該函數會對目標字符串或者數組進行addslashes處理。

chartype($pattern,$string) -- 對字符串或者數組進行正則檢查

返回字符串或者數組，$string為要處理的字符串或者數組，$pattern為perl格式的正則表達式，值得一提的是該函數可對數組進行正則檢查。

file_ext($name,$exts) -- 檢查文件擴展名

返回文件擴展名或者false，$name參數為要檢查的文件名，$exts為需要判斷的文件名后綴，多個后綴用“|”隔開，如果$name的后綴是$exts中的一個則函數返回該后綴名，如果不是則返回false。此函數一般用在對上傳文件后綴判斷中。

menu($parentid=0) -- 獲取子欄目信息

返回一個數組，$parentid為子欄目的上級欄目的catid，如果$menu=menu($parentid=0)，那么$menu [url]為欄目鏈接地址，$menu[catname]為欄目名稱，$menu[description]為欄目描述，$menu[target]為欄 目打開的目標窗口。

（二）./admin/global.php 中的函數可在phpcms后臺的任何一個程序中調用，下面是各函數的原型及用法。

showmessage($msg, $url_forward = '', $msgtype = 'message') -- 顯示提示信息

無返回值，$msg為提示信息內容，$url_forward 為跳轉的url地址，$msgtype 為顯示形式，有“message”和“form”可供選擇

dir_writeable($dir) -- 判斷目錄是否可寫

返回true或者false，$dir為要檢查的目錄

copydir($source,$destination,$child=1) -- 拷貝目錄

無返回值，$source為要拷貝的源目錄路徑，$destination為目標目錄路徑，當$child為1時此函數將自動拷貝$source目 錄下所有子目錄和文件至$destination目錄（如果$destination目錄不存在則自動創建），當$child為0時此函數將自動拷貝$ source目錄下所有文件至$destination目錄（如果$destination目錄不存在則自動創建）。

deletedir($dirname) -- 刪除目錄

無返回值，自動刪除$dirname目錄下所有的子目錄和文件

sizecount($filesize) -- 空間大小換算

返回浮點型數字，自動把$filesize從bytes單位換算成K、M、G的單位

listpages($totle,$perpage=30,$page=1,$path='') -- 文章分頁

listpages($totle,$perpage=30,$page=1,$path='')類似于showpage($totle,$ perpage=30,$page=1,$url='?')，但是showpage($totle,$perpage=30,$page=1,$url= '?')適用于htm網頁分頁，而listpages($totle,$perpage=30,$page=1,$path='')則適用于php網頁分 頁

checkadmin($msg,$referer='') -- 權限檢查

無返回值，$msg為提示信息內容，$referer為跳轉URL。此函數自動檢查當前用戶是否為管理員以及是否具有當前操作權限，如果沒有則顯示$msg信息并跳轉至$referer