PHP 选项及相关信息函数库

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)，见下表

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 秒。

查看本文来源