phpcms公用庫函數(shù)原型
message($alert,$goback='');--; 顯示JS消息對話框形式的提示信息
無返回值,$alert為提示信息內(nèi)容,$goback參數(shù)是用戶確認(rèn)后跳轉(zhuǎn)的url地址(此參數(shù)可選,默認(rèn)為空即不進(jìn)行跳轉(zhuǎn),如果該參數(shù)的值為 “goback”,則用戶確認(rèn)后瀏覽器自動跳轉(zhuǎn)到前一個打開的地址,如果該參數(shù)的值為“close”,則用戶確認(rèn)后瀏覽器自動關(guān)閉當(dāng)前窗口。
createdir($dir='');--; 創(chuàng)建目錄
無返回值,$dir參數(shù)必須是一個目錄地址,默認(rèn)為空不創(chuàng)建目錄。目錄地址可以是多層次的目錄,該函數(shù)會逐層目錄地檢查該目錄是否創(chuàng)建,如果已經(jīng)創(chuàng)建則繼續(xù)檢查下級目錄,如果沒有創(chuàng)建則自動創(chuàng)建目錄。目錄屬性默認(rèn)為 0777
file_write($filename,$content);--; 創(chuàng)建一個文件并寫入內(nèi)容
無返回值,$filename為要創(chuàng)建的文件名,$content為要寫入該文件的內(nèi)容。
dhtmlspecialchars($string);--; 把特殊字符轉(zhuǎn)換為html實(shí)體
返回字符串或者數(shù)組,$string參數(shù)可以是一個字符串,也可以是一個數(shù)組。
daddslashes($string) -- 使用反斜線引用字符串
返回字符串或者數(shù)組,該字符串為了數(shù)據(jù)庫查詢語句等的需要在某些字符前加上了反斜線。這些字符是單引號(')、雙引號(')、反斜線()與 NUL(NULL 字符)。
random($length,$chars='0123456789') -- 生成隨機(jī)字符串
返回字符串,$length為返回的字符串長度,$chars為字符串的組成字符,默認(rèn)為數(shù)字即'0123456789'。
language($file,$language) -- 獲取語言包文件的路徑
返回字符串,$file為文件名(不帶后綴.php),$language為語言包目錄(比如“chinese-gb2312”)。
template($file,$admin=0) -- 獲取模板文件路徑
返回字符串,$file為文件名(不帶后綴.htm),$admin參數(shù)為可選值,默認(rèn)值為0,即表示調(diào)用前臺模板文件,如果$admin=1,則表示調(diào)用后臺模板文件。
html($file) -- 調(diào)用 ./include/html/ 目錄下的文件并執(zhí)行
無返回值,$file參數(shù)為不帶后綴.php的文件名,該文件應(yīng)該是存在于 ./include/html/ 目錄下的,調(diào)用此函數(shù)后該文件將被執(zhí)行,通常情況下次函數(shù)用在生成html的程序中
articlepage($pagenumber=1,$page=0,$path='') -- 一篇文章分頁
返回字符串,$pagenumber為文章總頁數(shù)默認(rèn)為1,$page為當(dāng)前頁數(shù)默認(rèn)為0,$path為文章路徑。此函數(shù)返回一篇文章的分頁連接。
showpage($totle,$perpage=30,$page=1,$url='?') -- 文章分頁
返回字符串,$totle 為總記錄數(shù),$perpage為每頁顯示的記錄條數(shù)(默認(rèn)為30),$page為當(dāng)前頁碼(默認(rèn)為1),$url為分頁鏈接的基準(zhǔn)地址(默認(rèn)為“?”),此函數(shù)將返回文章分頁的鏈接。
wordscut($string, $length ,$sss=0) -- 字符串截斷
返回字符串,$string為需要截斷的字符串,$length為截斷后的最大長度,$sss為設(shè)置是否顯示“...”的開關(guān),當(dāng)值為1時顯示“...”,默認(rèn)為不顯示。
str_out($string) -- 處理要輸出的字符串
返回字符串或者數(shù)組,$string為要處理的字符串或者數(shù)組,該函數(shù)會還原經(jīng)addslashes處理過的字符串,把html實(shí)體化,把textarea中的換行變成“<br>”,把空格變成“ ”。
str_in($string) -- 處理插入到數(shù)據(jù)庫的字符串
返回字符串或者數(shù)組,$string為要處理的字符串或者數(shù)組,該函數(shù)會對目標(biāo)字符串或者數(shù)組進(jìn)行addslashes處理。
chartype($pattern,$string) -- 對字符串或者數(shù)組進(jìn)行正則檢查
返回字符串或者數(shù)組,$string為要處理的字符串或者數(shù)組,$pattern為perl格式的正則表達(dá)式,值得一提的是該函數(shù)可對數(shù)組進(jìn)行正則檢查。
file_ext($name,$exts) -- 檢查文件擴(kuò)展名
返回文件擴(kuò)展名或者false,$name參數(shù)為要檢查的文件名,$exts為需要判斷的文件名后綴,多個后綴用“|”隔開,如果$name的后綴是$exts中的一個則函數(shù)返回該后綴名,如果不是則返回false。此函數(shù)一般用在對上傳文件后綴判斷中。
menu($parentid=0) -- 獲取子欄目信息
返回一個數(shù)組,$parentid為子欄目的上級欄目的catid,如果$menu=menu($parentid=0),那么$menu [url]為欄目鏈接地址,$menu[catname]為欄目名稱,$menu[description]為欄目描述,$menu[target]為欄 目打開的目標(biāo)窗口。
(二)./admin/global.php 中的函數(shù)可在phpcms后臺的任何一個程序中調(diào)用,下面是各函數(shù)的原型及用法。
showmessage($msg, $url_forward = '', $msgtype = 'message') -- 顯示提示信息
無返回值,$msg為提示信息內(nèi)容,$url_forward 為跳轉(zhuǎn)的url地址,$msgtype 為顯示形式,有“message”和“form”可供選擇
dir_writeable($dir) -- 判斷目錄是否可寫
返回true或者false,$dir為要檢查的目錄
copydir($source,$destination,$child=1) -- 拷貝目錄
無返回值,$source為要拷貝的源目錄路徑,$destination為目標(biāo)目錄路徑,當(dāng)$child為1時此函數(shù)將自動拷貝$source目 錄下所有子目錄和文件至$destination目錄(如果$destination目錄不存在則自動創(chuàng)建),當(dāng)$child為0時此函數(shù)將自動拷貝$ source目錄下所有文件至$destination目錄(如果$destination目錄不存在則自動創(chuàng)建)。
deletedir($dirname) -- 刪除目錄
無返回值,自動刪除$dirname目錄下所有的子目錄和文件
sizecount($filesize) -- 空間大小換算
返回浮點(diǎn)型數(shù)字,自動把$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網(wǎng)頁分頁,而listpages($totle,$perpage=30,$page=1,$path='')則適用于php網(wǎng)頁分 頁
checkadmin($msg,$referer='') -- 權(quán)限檢查
無返回值,$msg為提示信息內(nèi)容,$referer為跳轉(zhuǎn)URL。此函數(shù)自動檢查當(dāng)前用戶是否為管理員以及是否具有當(dāng)前操作權(quán)限,如果沒有則顯示$msg信息并跳轉(zhuǎn)至$referer
相關(guān)文章:
