PHP 選項及相關資訊函數庫

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, "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
配置錯誤資訊回報的等級。
文法: 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 通常都會顯示出來，但不會中斷程式的執行。這對除錯很有效。例如：用有問題的Regex呼叫 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 Null 字元會自動轉為含有反斜線的溢出字元。
參考: 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 秒。