PHP4手册:函数库及函数(二十一) PHP 选项及相关资讯函式库
December 21th,2008 22:39:58 Category :
PHP+Mysql
Click (569)--------------------------------------------------------------------------------
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 秒。
