[ 永遠的UNIX > PHP4手冊:函數庫及函數(二十一) PHP 選項及相關資訊函式庫 ]

[ 永遠的UNIX::UNIX技術資料的寶庫 ] GB | BIG5

首頁 > 編程技術 > Php > 正文

PHP4手冊:函數庫及函數(二十一) PHP 選項及相關資訊函式庫

http://netleader.126.com 星空浪子 (2001-04-18 14:09:19)

--------------------------------------------------------------------------------
　PHP　選項及相關資訊函式庫　
--------------------------------------------------------------------------------
　

本函式庫共有　17　個函式
error_log:　送出一個錯誤訊息。　
error_reporting:　設定錯誤訊息回報的等級。　
getenv:　取得系統的環境變數　
get_cfg_var:　取得　PHP　的設定選項值。　
get_current_user:　取得　PHP　行程的擁有者名稱。　
get_magic_quotes_gpc:　取得　PHP　環境變數　magic_quotes_gpc　的值。　
get_magic_quotes_runtime:　取得　PHP　環境變數　magic_quotes_runtime　的值。　
getlastmod:　傳回該網頁的最修改時間。　
getmyinode:　傳回該網頁的　inode　值。　
getmypid:　傳回　PHP　的行程代號。　
getmyuid:　傳回　PHP　的使用者代碼。　
getrusage:　傳回系統資源使用率。　
phpinfo:　傳回　PHP　所有相關資訊。　
phpversion:　傳回　PHP　版本訊息。　
putenv:　設定系統環境變數。　
set_magic_quotes_runtime:　設定　magic_quotes_runtime　值。　
set_time_limit:　設定該頁最久執行時間。　

--------------------------------------------------------------------------------
　函式:error_log()　
--------------------------------------------------------------------------------
　

PHP　選項及相關資訊函式庫

error_log
送出一個錯誤訊息。

語法:　int　error_log(string　message,　int　message_type,　string　[destination],　string　[extra_headers]);

傳回值:　整數

函式種類:　PHP　系統功能

　
　
內容說明　

此函式會送出錯誤訊息到　Web　伺服器的錯誤　log　檔，TCP　Port，或到指定檔案。第一個參數　message　即為要送出的錯誤訊息。第二個參數　message_type　為整數值：0　表示送到作業系統的　log　(UNIX　在　syslog、Windows　NT　記錄到事件記錄)；1　則使用　PHP　的　Mail()　函式，送訊息到某　E-Mail　處，第四個參數　extra_headers　亦會用到；2　則將錯誤訊息送到　TCP　埠，此時第三個參數　destination　表示目的地　IP　及　Port；3　則將訊息存到檔案　destination　中。

　
　
使用范例　

本例為登入　Oracle　資料庫出現問題的處理。

if　(!Ora_Logon($username,　$password))　{
　　error_log("Oracle　資料庫不可用!",　0);
}
if　(!($foo　=　allocate_new_foo())　{
　　error_log("出現大麻煩了!",　1,　"webmaster@www.mydomain.com.tw");
}
error_log("搞砸了!",　2,　"127.0.0.1:7000");
error_log("搞砸了!",　2,　"loghost");
error_log("搞砸了!",　3,　"/var/tmp/my-errors.log");
?>　

--------------------------------------------------------------------------------
　函式:error_reporting()　
--------------------------------------------------------------------------------
　

PHP　選項及相關資訊函式庫

error_reporting
設定錯誤訊息回報的等級。

語法:　int　error_reporting(int　[level]);

傳回值:　整數

函式種類:　PHP　系統功能

　
　
內容說明　

本函式用來設定錯誤訊息回報的等級，參數　level　是一個整數的位元遮罩　(bitmask)，見下表。

遮罩值　表示名稱　
1　E_ERROR　
2　E_WARNING　
4　E_PARSE　
8　E_NOTICE　
16　E_CORE_ERROR　
32　E_CORE_WARNING　

E_NOTICE　表示一般情形不記錄，只有程式有錯誤情形時才用到，例如企圖存取一個不存在的變數，或是呼叫　stat()　函式檢視不存在的檔案。　
E_WARNING　通常都會顯示出來，但不會中斷程式的執行。這對除錯很有效。例如：用有問題的常規表示法呼叫　ereg()。　
E_ERROR　通常會顯示出來，亦會中斷程式執行。意即用這個遮罩無法追查到記憶體配置或其它的錯誤。　
E_PARSE　從語法中剖析錯誤。　
E_CORE_ERROR　類似　E_ERROR，但不包括　PHP　核心造成的錯誤。　
E_CORE_WARNING　類似　E_WARNING，但不包括　PHP　核心錯誤警告。　

--------------------------------------------------------------------------------
　函式:getenv()　
--------------------------------------------------------------------------------
　

PHP　選項及相關資訊函式庫

getenv
取得系統的環境變數

語法:　string　getenv(string　varname);

傳回值:　字串

函式種類:　PHP　系統功能

　
　
內容說明　

若正確取得環境變數　varname，則傳回變數值。失敗則傳回　false。

　
　
使用范例　

下例可以取得使用者瀏覽器所在機器的網址

$ip　=　getenv("REMOTE_ADDR");
?>　

　

--------------------------------------------------------------------------------
　函式:get_cfg_var()　
--------------------------------------------------------------------------------
　

PHP　選項及相關資訊函式庫

get_cfg_var
取得　PHP　的設定選項值。

語法:　string　get_cfg_var(string　varname);

傳回值:　字串

函式種類:　PHP　系統功能

　
　
內容說明　

若正確取得目前　PHP　設定選項　varname，則傳回變數值。失敗則傳回　false。

　

--------------------------------------------------------------------------------
　函式:get_current_user()　
--------------------------------------------------------------------------------
　

PHP　選項及相關資訊函式庫

get_current_user
取得　PHP　行程的擁有者名稱。

語法:　string　get_current_user(void);

傳回值:　字串

函式種類:　PHP　系統功能

　
　
內容說明　

本函式用來取得　PHP　程式行程的擁有者名稱。

　
　
參考　

getmyuid()　　getmypid()　　getmyinode()　　getlastmod()　　

　

--------------------------------------------------------------------------------
　函式:get_magic_quotes_gpc()　
--------------------------------------------------------------------------------
　

PHP　選項及相關資訊函式庫

get_magic_quotes_gpc
取得　PHP　環境變數　magic_quotes_gpc　的值。

語法:　long　get_magic_quotes_gpc(void);

傳回值:　長整數

函式種類:　PHP　系統功能

　
　
內容說明　

本函式取得　PHP　環境設定的變數　magic_quotes_gpc　(GPC,　Get/Post/Cookie)　值。傳回　0　表示關閉本功能；傳回　1　表示本功能開啟。當　magic_quotes_gpc　開啟時，所有的　'　(單引號),　"　(雙引號),　\　(反斜線)　and　空字元會自動轉為含有反斜線的溢出字元。

　
　
參考　

get_magic_quotes_runtime()　　set_magic_quotes_runtime()　　

　

--------------------------------------------------------------------------------
　函式:get_magic_quotes_runtime()　
--------------------------------------------------------------------------------
　

PHP　選項及相關資訊函式庫

get_magic_quotes_runtime
取得　PHP　環境變數　magic_quotes_runtime　的值。

語法:　long　get_magic_quotes_runtime(void);

傳回值:　長整數

函式種類:　PHP　系統功能

　
　
內容說明　

本函式取得　PHP　環境設定的變數　magic_quotes_runtime　值。傳回　0　表示關閉本功能；傳回　1　表示本功能開啟。若　magic_quotes_runtime　開啟時，所有外部引入的資料庫資料或者檔案等等都會自動轉為含有反斜線溢出字元的資料。

　
　
參考　

get_magic_quotes_gpc()　　set_magic_quotes_runtime()　　

　

--------------------------------------------------------------------------------
　函式:getlastmod()　
--------------------------------------------------------------------------------
　

PHP　選項及相關資訊函式庫

getlastmod
傳回該網頁的最修改時間。

語法:　int　getlastmod(void);

傳回值:　整數

函式種類:　PHP　系統功能

　
　
內容說明　

本函式傳回讓該函式所網頁的最修改時間，傳回的是　UNIX　的時間戳記　(timestamp)　格式，可用　4.7.2　date()　函式將傳回值格式化。若執行失敗則傳回　false　值。

　
　
使用范例　

下例傳回值類似　'本頁最修改時間:　June　19　1999　20:43:59.'

echo　"本頁最修改時間:　".date("F　d　Y　H:i:s.",　getlastmod());
?>

　
　
參考　

date()　　getmyuid()　　get_current_user()　　getmyinode()　　getmypid()　　

　

--------------------------------------------------------------------------------
　函式:getmyinode()　
--------------------------------------------------------------------------------
　

PHP　選項及相關資訊函式庫

getmyinode
傳回該網頁的　inode　值。

語法:　int　getmyinode(void);

傳回值:　整數

函式種類:　PHP　系統功能

　
　
內容說明　

本函式傳回該網頁的　inode　值。若執行失敗則傳回　false　值。

　
　
參考　

getmyuid()　　get_current_user()　　getmypid()　　getlastmod()　　

　

--------------------------------------------------------------------------------
　函式:getmypid()　
--------------------------------------------------------------------------------
　

PHP　選項及相關資訊函式庫

getmypid
傳回　PHP　的行程代號。

語法:　int　getmypid(void);

傳回值:　整數

函式種類:　PHP　系統功能

　
　
內容說明　

本函式傳回　PHP　的行程代號值　(PID)。若執行失敗則傳回　false　值。當　PHP　以　Apache　模組存在時，傳回的　PID　值不見得是正確的。

　
　
參考　

getmyuid()　　get_current_user()　　getmyinode()　　getlastmod()　　

　

--------------------------------------------------------------------------------
　函式:getmyuid()　
--------------------------------------------------------------------------------
　

PHP　選項及相關資訊函式庫

getmyuid
傳回　PHP　的使用者代碼。

語法:　int　getmyuid(void);

傳回值:　整數

函式種類:　PHP　系統功能

　
　
內容說明　

本函式傳回　PHP　的使用者代碼　(UID)。若執行失敗則傳回　false　值。

　
　
參考　

getmypid()　　get_current_user()　　getmyinode()　　getlastmod()　　

　

--------------------------------------------------------------------------------
　函式:getrusage()　
--------------------------------------------------------------------------------
　

PHP　選項及相關資訊函式庫

getrusage
傳回系統資源使用率。

語法:　array　getrusage(int　[who]);

傳回值:　陣列

函式種類:　PHP　系統功能

　
　
內容說明　

本函式使用　UNIX　的系統呼叫　getrusage(2)。傳回的資訊以陣列的方式傳回。若參數　who　為　1，本函式會呼叫　RUSAGE_CHILDREN。更進一步的資訊可以參考　UNIX　函式庫方面的文件。

　
　
使用范例　

$dat　=　getrusage();
echo　$dat["ru_nswap"];　　　　　　　　　//　Swaps　數
echo　$dat["ru_majflt"];　　　　　　　　//　分頁數
echo　$dat["ru_utime.tv_sec"];　　//　使用時間　(秒)
echo　$dat["ru_utime.tv_usec"];　//　使用時間　(毫秒)
?>　
　

--------------------------------------------------------------------------------
　函式:phpinfo()　
--------------------------------------------------------------------------------
　

PHP　選項及相關資訊函式庫

phpinfo
傳回　PHP　所有相關資訊。

語法:　int　phpinfo(void);

傳回值:　整數

函式種類:　PHP　系統功能

　
　
內容說明　

本函式傳回　PHP　的所有資訊。包括了　PHP　的編譯選項及擴充設定、PHP　版本、伺服器資訊及環境變數、PHP　環境變數、作業系統版本資訊、路徑及環境變數設定、HTTP　標頭、及版權宣告。

　
　
參考　

phpversion()　　

　

--------------------------------------------------------------------------------
　函式:phpversion()　
--------------------------------------------------------------------------------
　

PHP　選項及相關資訊函式庫

phpversion
傳回　PHP　版本訊息。

語法:　string　phpversion(void);

傳回值:　字串

函式種類:　PHP　系統功能

　
　
內容說明　

本函式傳回　PHP　的版本資訊。

　
　
使用范例　

下例傳回值類似　'本站使用　PHP　版本為:　3.0.11'

echo　"本站使用　PHP　版本為:　".phpversion();
?>　

　
　
參考　

phpinfo()　　
　

--------------------------------------------------------------------------------
　函式:putenv()　
--------------------------------------------------------------------------------
　

PHP　選項及相關資訊函式庫

putenv
設定系統環境變數。

語法:　void　putenv(string　setting);

傳回值:　無

函式種類:　PHP　系統功能

　
　
內容說明　

本函式用來設定系統環境變數。

　
　
使用范例　

設定　Oracle　資料庫需使用的環境變數　NLS_LANG，傳回資料含中文　BIG5　碼。

putenv("NLS_LANG=american_taiwan.zht16big5");
?>　

　

--------------------------------------------------------------------------------
　函式:set_magic_quotes_runtime()　
--------------------------------------------------------------------------------
　

PHP　選項及相關資訊函式庫

set_magic_quotes_runtime
設定　magic_quotes_runtime　值。

語法:　long　set_magic_quotes_runtime(int　new_setting);

傳回值:　長整數

函式種類:　PHP　系統功能

　
　
內容說明　

本函式用來設定　magic_quotes_runtime　值。

　
　
參考　

get_magic_quotes_gpc()　　get_magic_quotes_runtime()　　

　

--------------------------------------------------------------------------------
　函式:set_time_limit()　
--------------------------------------------------------------------------------
　

PHP　選項及相關資訊函式庫

set_time_limit
設定該頁最久執行時間。

語法:　void　set_time_limit(int　seconds);

傳回值:　無

函式種類:　PHP　系統功能

　
　
內容說明　

本函式用來設定該頁最久執行時間。內定值是　30　秒，在　php.ini　中的　max_execution_time　變數設定，若設定為　0　則不限定最久時間。當執行到該函數時，才開始計算。例如，若內定是　30　秒，而在執行到該函數前已執行了　25　秒，而用本函式改為　20　秒，則該頁面最長執行時間為　45　秒。 (http://www.fanqiang.com) 進入【UNIX論壇】

===更多相關===

★ 樊強制作歡迎分享 ★