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 通常都会显示出来，但不会中断程序的执行。这对除错很有效。例如：用有问题的正则表达式呼叫 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 秒。