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 : 配置該頁最久執行時間。
int 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 數據庫出現問題的處理。
<?php
if (!Ora_Logon($username, $password)) {
error_log("Oracle 數據庫不可用!", 0);
}
if (!($foo = allocate_new_foo()) {
error_log("出現大麻煩了!", 1, "[email protected]");
}
error_log("搞砸了!", 2, "127.0.0.1:7000");
error_log("搞砸了!", 2, "loghost");
error_log("搞砸了!", 3, "/var/tmp/my-errors.log");
?>
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
取得系統的環境變量
語法: string getenv(string varname);
返回值: 字符串
函數種類: PHP 系統功能
內容說明: 若正確取得環境變量 varname,則返回變量值。失敗則返回 false。
使用范例
下例可以取得用戶浏覽器所在機器的網址
<?
$ip = getenv("REMOTE_ADDR");
?>
get_cfg_var
取得 PHP 的配置選項值。
語法: string get_cfg_var(string varname);
返回值: 字符串
函數種類: PHP 系統功能
內容說明: 若正確取得目前 PHP 配置選項 varname,則返回變量值。失敗則返回 false。
get_current_user
取得 PHP 行程的擁有者名稱。
語法: string get_current_user(void);
返回值: 字符串
函數種類: PHP 系統功能
內容說明: 本函數用來取得 PHP 程序行程的擁有者名稱。
參考: getmyuid() getmypid() getmyinode() getlastmod()
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 環境變量 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
返回該網頁的最後修改時間。
語法: int getlastmod(void);
返回值: 整數
函數種類: PHP 系統功能
內容說明: 本函數返回讓該函數所網頁的最後修改時間,返回的是 UNIX 的時間戳記 (timestamp) 格式,可用 4.7.2 date() 函數將返回值格式化。若執行失敗則返回 false 值。
使用范例: 下例返回值類似 '本頁最後修改時間: June 19 1999 20:43:59.'
<?php
echo "本頁最後修改時間: ".date("F d Y H:i:s.", getlastmod());
?>
參考: date() getmyuid() get_current_user() getmyinode() getmypid()
getmyinode
返回該網頁的 inode 值。
語法: int getmyinode(void);
返回值: 整數
函數種類: PHP 系統功能
內容說明: 本函數返回該網頁的 inode 值。若執行失敗則返回 false 值。
參考: getmyuid() get_current_user() getmypid() getlastmod()
getmypid
返回 PHP 的行程代號。
語法: int getmypid(void);
返回值: 整數
函數種類: PHP 系統功能
內容說明: 本函數返回 PHP 的行程代號值 (PID)。若執行失敗則返回 false 值。當 PHP 以 Apache 模塊存在時,返回的 PID 值不見得是正確的。
參考: getmyuid() get_current_user() getmyinode() getlastmod()
getmyuid
返回 PHP 的用戶代碼。
語法: int getmyuid(void);
返回值: 整數
函數種類: PHP 系統功能
內容說明: 本函數返回 PHP 的用戶代碼 (UID)。若執行失敗則返回 false 值。
參考: getmypid() get_current_user() getmyinode() getlastmod()
getrusage
返回系統資源使用率。
語法: array getrusage(int [who]);
返回值: 數組
函數種類: PHP 系統功能
內容說明: 本函數使用 UNIX 的系統呼叫 getrusage(2)。返回的信息以數組的方式返回。若參數 who 為 1,本函數會呼叫 RUSAGE_CHILDREN。更進一步的信息可以參考 UNIX 函數庫方面的文件。
使用范例
<?php
$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 所有相關信息。
語法: int phpinfo(void);
返回值: 整數
函數種類: PHP 系統功能
內容說明: 本函數返回 PHP 的所有信息。包括了 PHP 的編譯選項及擴充配置、PHP 版本、服務器信息及環境變量、PHP 環境變量、操作系統版本信息、路徑及環境變量配置、HTTP 標頭、及版權宣告。
參考: phpversion()
phpversion
返回 PHP 版本信息。
語法: string phpversion(void);
返回值: 字符串
函數種類: PHP 系統功能
內容說明: 本函數返回 PHP 的版本信息。
使用范例
下例返回值類似 '本站使用 PHP 版本為: 3.0.11'
<?php
echo "本站使用 PHP 版本為: ".phpversion();
?>
參考: phpinfo()
putenv
配置系統環境變量。
語法: void putenv(string setting);
返回值: 無
函數種類: PHP 系統功能
內容說明: 本函數用來配置系統環境變量。
使用范例
配置 Oracle 數據庫需使用的環境變量 NLS_LANG,返回資料含中文 BIG5 碼。<?
putenv("NLS_LANG=american_taiwan.zht16big5");
?>
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
配置該頁最久執行時間。
語法: void set_time_limit(int seconds);
返回值: 無
函數種類: PHP 系統功能
內容說明: 本函數用來配置該頁最久執行時間。默認值是 30 秒,在 php.ini 中的 max_execution_time 變量配置,若配置為 0 則不限定最久時間。當執行到該函數時,才開始計算。例如,若默認是 30 秒,而在執行到該函數前已執行了 25 秒,而用本函數改為 20 秒,則該頁面最長執行時間為 45 秒。