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:配置该页最久执行时间。

interror_log
语法:interror_log(stringmessage,intmessage_type,string[destination],string[extra_headers]);
返回值:整数
函数种类:PHP系统功能
内容说明:此函数会送出错误信息到Web服务器的错误log文件，TCPPort，或到指定文件。第一个参数message即为要送出的错误信息。第二个参数message_type为整数值：0表示送到操作系统的log(UNIX在syslog、WindowsNT记录到事件记录)；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@
}
error_log(搞砸了!,2,127.0.0.1:7000);
error_log(搞砸了!,2,loghost);
error_log(搞砸了!,3,/var/tmp/my-errors.log);
?>

error_reporting
配置错误信息回报的等级。
语法:interror_reporting(int[level]);
返回值:整数
函数种类:PHP系统功能
内容说明:本函数用来配置错误信息回报的等级，参数level是一个整数的位遮罩(bitmask)，见下表
遮罩值表示名称
1E_ERROR
2E_WARNING
4E_PARSE
8E_NOTICE
16E_CORE_ERROR
32E_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
取得系统的环境变量
语法:stringgetenv(stringvarname);
返回值:字符串
函数种类:PHP系统功能
内容说明:若正确取得环境变量varname，则返回变量值。失败则返回false。
使用范例
下例可以取得用户浏览器所在机器的网址
<?
$ip=getenv(REMOTE_ADDR);
?>

get_cfg_var
取得PHP的配置选项值。
语法:stringget_cfg_var(stringvarname);
返回值:字符串
函数种类:PHP系统功能
内容说明:若正确取得目前PHP配置选项varname，则返回变量值。失败则返回false。

get_current_user
取得PHP行程的拥有者名称。
语法:stringget_current_user(void);
返回值:字符串
函数种类:PHP系统功能
内容说明:本函数用来取得PHP程序行程的拥有者名称。
参考:getmyuid()getmypid()getmyinode()getlastmod()

get_magic_quotes_gpc
取得PHP环境变量magic_quotes_gpc的值。
语法:longget_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的值。
语法:longget_magic_quotes_runtime(void);
返回值:长整数
函数种类:PHP系统功能
内容说明:本函数取得PHP环境配置的变量magic_quotes_runtime值。返回0表示关闭本功能；返回1表示本功能打开。若magic_quotes_runtime打开时，所有外部引入的数据库资料或者文件等等都会自动转为含有反斜线溢出字符的资料。
参考:get_magic_quotes_gpc()set_magic_quotes_runtime()

getlastmod
返回该网页的最后修改时间。
语法:intgetlastmod(void);
返回值:整数
函数种类:PHP系统功能
内容说明:本函数返回让该函数所网页的最后修改时间，返回的是UNIX的时间戳记(timestamp)格式，可用4.7.2date()函数将返回值格式化。若执行失败则返回false值。

使用范例:下例返回值类似本页最后修改时间:June19199920:43:59.
<?php
echo本页最后修改时间:.date(FdYH:i:s.,getlastmod());
?>
参考:date()getmyuid()get_current_user()getmyinode()getmypid()

getmyinode
返回该网页的inode值。
语法:intgetmyinode(void);
返回值:整数
函数种类:PHP系统功能
内容说明:本函数返回该网页的inode值。若执行失败则返回false值。
参考:getmyuid()get_current_user()getmypid()getlastmod()

getmypid
返回PHP的行程代号。
语法:intgetmypid(void);
返回值:整数
函数种类:PHP系统功能
内容说明:本函数返回PHP的行程代号值(PID)。若执行失败则返回false值。当PHP以Apache模块存在时，返回的PID值不见得是正确的。
参考:getmyuid()get_current_user()getmyinode()getlastmod()

getmyuid
返回PHP的用户代码。
语法:intgetmyuid(void);
返回值:整数
函数种类:PHP系统功能
内容说明:本函数返回PHP的用户代码(UID)。若执行失败则返回false值。
参考:getmypid()get_current_user()getmyinode()getlastmod()

getrusage
返回系统资源使用率。
语法:arraygetrusage(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_usec];//使用时间(毫秒)
?>

phpinfo
返回PHP所有相关信息。
语法:intphpinfo(void);
返回值:整数
函数种类:PHP系统功能
内容说明:本函数返回PHP的所有信息。包括了PHP的编译选项及扩充配置、PHP版本、服务器信息及环境变量、PHP环境变量、操作系统版本信息、路径及环境变量配置、HTTP标头、及版权宣告。
参考:phpversion()

phpversion
返回PHP版本信息。
语法:stringphpversion(void);
返回值:字符串
函数种类:PHP系统功能
内容说明:本函数返回PHP的版本信息。
使用范例
下例返回值类似本站使用PHP版本为:3.0.11
<?php
echo本站使用PHP版本为:.phpversion();
?>
参考:phpinfo()

putenv
配置系统环境变量。
语法:voidputenv(stringsetting);
返回值:无
函数种类:PHP系统功能
内容说明:本函数用来配置系统环境变量。
使用范例
配置Oracle数据库需使用的环境变量NLS_LANG，返回资料含中文BIG5码。<?
putenv(NLS_LANG=american_taiwan.zht16big5);
?>
set_magic_quotes_runtime
配置magic_quotes_runtime值。
语法:longset_magic_quotes_runtime(intnew_setting);
返回值:长整数
函数种类:PHP系统功能
内容说明
本函数用来配置magic_quotes_runtime值。
参考:get_magic_quotes_gpc()get_magic_quotes_runtime()

set_time_limit
配置该页最久执行时间。
语法:voidset_time_limit(intseconds);
返回值:无
函数种类:PHP系统功能
内容说明:本函数用来配置该页最久执行时间。默认值是30秒，在中的max_execution_time变量配置，若配置为0则不限定最久时间。当执行到该函数时，才开始计算。例如，若默认是30秒，而在执行到该函数前已执行了25秒，而用本函数改为20秒，则该页面最长执行时间为45秒。