php预定义变量使用帮助(带实例)
自 php 4.1.0 起,取得外部变量的首选方法是用下面提及的超全局变量。在此之前,人们要么依赖 register_globals,要么就是长长的预定义 php 数组($http_*_vars)。自 php 5.0.0 起,长格式的 php 预定义变量可以通过设置 register_long_arrays 来屏蔽。
服务器变量:$_server
注: 在 php 4.1.0 及以后版本使用。之前的版本,使用 $http_server_vars。
$_server 是一个包含诸如头信息(header)、路径(path)和脚本位置(script locations)的数组。数组的实体由 web 服务器创建。不能保证所有的服务器都能产生所有的信息;服务器可能忽略了一些信息,或者产生了一些未在下面列出的新的信息。这意味着,大量的这些变量在 cgi 1.1 规范中说明,所以应该仔细研究一下。
这是一个“superglobal”,或者可以描述为自动全局变量。这只不过意味这它在所有的脚本中都有效。在函数或方法中不需要使用 global $_server; 访问它,就如同使用 $http_server_vars 一样。
$http_server_vars 包含着同样的信息,但是不是一个自动全局变量(注意:$http_server_vars 和 $_server 是不同的变量,php 处理它们的方式不同)。
如果设置了 register_globals 指令,这些变量也在所有脚本中可用;也就是,分离了 $_server 和 $http_server_vars 数组。相关信息,请参阅安全的相关章节使用 register globals。这些单独的全局变量不是自动全局变量。
或许会发现下面列出的某些 $_server 元素并不可用。注意,如果以命令行方式运行 php,下面列出的元素几乎没有有效的(或是没有任何实际意义的)。
“php_self”
当前正在执行脚本的文件名,与 document root 相关。举例来说,在 url 地址为 http://example.com/test.php/foo.bar 的脚本中使用 $_server['php_self'] 将会得到 /test.php/foo.bar 这个结果。__file__ 常量包含当前(例如包含)文件的绝对路径和文件名。
如果 php 以命令行方式运行,该变量在 php 4.3.0 之前无效。
“argv”
传递给该脚本的参数。当脚本运行在命令行方式时,argv 变量传递给程序 c 语言样式的命令行参数。当调用 get 方法时,该变量包含请求的数据。
“argc”
包含传递给程序的命令行参数的个数(如果运行在命令行模式)。
“gateway_interface”
服务器使用的 cgi 规范的版本。例如,“cgi/1.1”。
“server_name”
当前运行脚本所在服务器主机的名称。如果该脚本运行在一个虚拟主机上,该名称是由那个虚拟主机所设置的值决定。
“server_software”
服务器标识的字串,在响应请求时的头信息中给出。
“server_protocol”
请求页面时通信协议的名称和版本。例如,“http/1.0”。
“request_method”
访问页面时的请求方法。例如:“get”、“head”,“post”,“put”。
注: 如果请求的方式是 head,php 脚本将在送出头信息后中止(这意味着在产生任何输出后,不再有输出缓冲)。
“request_time”
请求开始时的时间戳。从 php 5.1.0 起有效。
“query_string”
查询(query)的字符串(url 中第一个问号 ? 之后的内容)。
“document_root”
当前运行脚本所在的文档根目录。在服务器配置文件中定义。
“http_accept”
当前请求的 accept: 头信息的内容。
“http_accept_charset”
当前请求的 accept-charset: 头信息的内容。例如:“iso-8859-1,*,utf-8”。
“http_accept_encoding”
当前请求的 accept-encoding: 头信息的内容。例如:“gzip”。
“http_accept_language”
当前请求的 accept-language: 头信息的内容。例如:“en”。
“http_connection”
当前请求的 connection: 头信息的内容。例如:“keep-alive”。
“http_host”
当前请求的 host: 头信息的内容。
“http_referer”
链接到当前页面的前一页面的 url 地址。不是所有的用户代理(浏览器)都会设置这个变量,而且有的还可以手工修改 http_referer。因此,这个变量不总是真实正确的。
“http_user_agent”
当前请求的 user-agent: 头信息的内容。该字符串表明了访问该页面的用户代理的信息。一个典型的例子是:mozilla/4.5 [en] (x11; u; linux 2.2.9 i586)。也可以使用 get_browser() 得到此信息。
“https”
如果脚本是通过 https 协议被访问,则被设为一个非空的值。
“remote_addr”
正在浏览当前页面用户的 ip 地址。
“remote_host”
正在浏览当前页面用户的主机名。反向域名解析基于该用户的 remote_addr。
注: 必须配置 web 服务器来建立此变量。例如 apache 需要在 httpd.conf 中有 hostnamelookups on。参见 gethostbyaddr()。
“remote_port”
用户连接到服务器时所使用的端口。
“script_filename”
当前执行脚本的绝对路径名。
注: 如果脚本在 cli 中被执行,作为相对路径,例如 file.php 或 ../file.php,$_server['script_filename'] 将包含用户指定的相对路径。
“server_admin”
该值指明了 apache 服务器配置文件中的 server_admin 参数。如果脚本运行在一个虚拟主机上,则该值是那个虚拟主机的值。
“server_port”
服务器所使用的端口。默认为“80”。如果使用 ssl 安全连接,则这个值为用户设置的 http 端口。
“server_signature”
包含服务器版本和虚拟主机名的字符串。
“path_translated”
当前脚本所在文件系统(不是文档根目录)的基本路径。这是在服务器进行虚拟到真实路径的映像后的结果。
注: php 4.3.2 之后,path_translated 在 apache 2 sapi 模式下不再和 apache 1 一样隐含赋值,而是若 apache 不生成此值,php 便自己生成并将其值放入 script_filename 服务器常量中。这个修改遵守了 cgi 规范,path_translated 仅在 path_info 被定义的条件下才存在。
apache 2 用户可以使用 httpd.conf 中的 acceptpathinfo on 来定义 path_info。
“script_name”
包含当前脚本的路径。这在页面需要指向自己时非常有用。__file__ 包含当前文件的绝对路径和文件名(例如包含文件)。
“request_uri”
访问此页面所需的 uri。例如,“/index.html”。
“php_auth_digest”
当作为 apache 模块运行时,进行 http digest 认证的过程中,此变量被设置成客户端发送的“authorization”http 头内容(以便作进一步的认证操作)。
“php_auth_user”
当 php 运行在 apache 或 iis(php 5 是 isapi)模块方式下,并且正在使用 http 认证功能,这个变量便是用户输入的用户名。
“php_auth_pw”
当 php 运行在 apache 或 iis(php 5 是 isapi)模块方式下,并且正在使用 http 认证功能,这个变量便是用户输入的密码。
“auth_type”
当 php 运行在 apache 模块方式下,并且正在使用 http 认证功能,这个变量便是认证的类型。
环境变量:$_env
注: 在 php 4.1.0 及以后版本使用。之前的版本,使用 $http_env_vars。
在解析器运行时,这些变量从环境变量转变为 php 全局变量名称空间(namespace)。它们中的许多都是由 php 所运行的系统决定。完整的列表是不可能的。请查看系统的文档以确定其特定的环境变量。
其它环境变量(包括 cgi 变量),无论 php 是以服务器模块或是以 cgi 处理方式运行,都在这里列出了。
这是一个“superglobal”,或者可以描述为自动全局变量。这只不过意味这它在所有的脚本中都有效。在函数或方法中不需要使用 global $_env; 来访问它,就如同使用 $http_env_vars 一样。
$http_env_vars 包含着同样的信息,但是不是一个自动全局变量(注意:$http_env_vars 和 $_env 是不同的变量,php 处理它们的方式不同)。
如果设置了 register_globals 指令,这些变量也在所有脚本中可用;也就是,分离了 $_env 和 $http_env_vars 数组。相关信息,请参阅安全的相关章节使用 register globals。这些单独的全局变量不是自动全局变量。
http cookies:$_cookie
注: 在 php 4.1.0 及以后版本使用。之前的版本,使用 $http_cookie_vars。
通过 http cookies 传递的变量组成的数组。是自动全局变量。
这是一个“superglobal”,或者可以描述为自动全局变量。这只不过意味这它在所有的脚本中都有效。在函数或方法中不需要使用 global $_cookie; 来访问它,就如同使用 $http_cookie_vars 一样。
$http_cookie_vars 包含着同样的信息,但是不是一个自动全局变量(注意:$http_cookie_vars 和 $_cookie 是不同的变量,php 处理它们的方式不同)。
如果设置了 register_globals 指令,这些变量也在所有脚本中可用;也就是,分离了 $_cookie 和 $http_cookie_vars 数组。相关信息,请参阅安全的相关章节使用 register globals。这些单独的全局变量不是自动全局变量。
http get 变量:$_get
注: 在 php 4.1.0 及以后版本使用。之前的版本,使用 $http_get_vars。
通过 http get 方法传递的变量组成的数组。是自动全局变量。
这是一个“superglobal”,或者可以描述为自动全局变量。这只不过意味这它在所有的脚本中都有效。在函数或方法中不需要使用 global $_get; 来访问它,就如同使用 $http_get_vars 一样。
$http_get_vars 包含着同样的信息,但是不是一个自动全局变量(注意:$http_get_vars 和 $_get 是不同的变量,php 处理它们的方式不同)。
如果设置了 register_globals 指令,这些变量也在所有脚本中可用;也就是,分离了 $_get 和 $http_get_vars 数组。相关信息,请参阅安全的相关章节使用 register globals。这些单独的全局变量不是自动全局变量。
http post 变量:$_post
注: 在 php 4.1.0 及以后版本使用。之前的版本,使用 $http_post_vars。
通过 http post 方法传递的变量组成的数组。是自动全局变量。
这是一个“superglobal”,或者可以描述为自动全局变量。这只不过意味这它在所有的脚本中都有效。在函数或方法中不需要使用 global $_post; 来访问它,就如同使用 $http_post_vars 一样。
$http_post_vars 包含着同样的信息,但是不是一个自动全局变量(注意:$http_post_vars 和 $_post 是不同的变量,php 处理它们的方式不同)。
如果设置了 register_globals 指令,这些变量也在所有脚本中可用;也就是,分离了 $_post 和 $http_post_vars 数组。相关信息,请参阅安全的相关章节使用 register globals。这些单独的全局变量不是自动全局变量。
http 文件上传变量:$_files
注: 在 php 4.1.0 及以后版本使用。之前的版本,使用 $http_post_files。
通过 http post 方法传递的已上传文件项目组成的数组。是自动全局变量。
这是一个“superglobal”,或者可以描述为自动全局变量。这只不过意味这它在所有的脚本中都有效。在函数或方法中不需要使用 global $_files; 来访问它,就如同使用 $http_post_files 一样。
$http_post_files 包含着同样的信息,但是不是一个自动全局变量(请注意 php 是把 $http_post_files 和 $_files 这两个变量当作不同的变量来处理的)。
如果设置了 register_globals 指令,这些变量也在所有脚本中可用;也就是,分离了 $_files 和 $http_post_files 数组。相关信息,请参阅安全的相关章节使用 register globals。这些单独的全局变量不是自动全局变量。
request 变量:$_request
注: 在 php 4.1.0 及以后版本使用。之前的版本,没有等价的数组。
注: 在 php 4.3.0 之前,$_files 也被包括在 $_request 数组中。
此关联数组包含 $_get,$_post 和 $_cookie 中的全部内容。
这是一个“superglobal”,或者可以描述为自动全局变量。这只不过意味着它在所有的脚本中都有效。在函数或方法中不需要使用 global $_request; 来访问它。
如果设置了 register_globals 指令,这些变量也在所有脚本中可用;也就是,分离了 $_request 数组。相关信息,请参阅安全的相关章节使用 register globals。这些单独的全局变量不是自动全局变量。
session 变量:$_session
注: 在 php 4.1.0 及以后版本使用。之前的版本,使用 $http_session_vars。
包含当前脚本中 session 变量的数组。参阅 session 函数文档以获得更多信息。
这是一个“superglobal”,或者可以描述为自动全局变量。这只不过意味这它在所有的脚本中都有效。在函数或方法中不需要使用 global $_session; 来访问它,就如同使用 $http_session_vars 一样。
$http_session_vars 包含着同样的信息,但是不是一个自动全局变量(请注意 php 是把 $http_session_vars 和 $_session 这两个变量当作不同的变量来处理的)。
如果设置了 register_globals 指令,这些变量也在所有脚本中可用;也就是,分离了 $_session 和 $http_session_vars 数组。相关信息,请参阅安全的相关章节使用 register globals。这些单独的全局变量不是自动全局变量。
global 变量:$globals
注: $globals 在 php 3.0.0 及以后版本中适用。
由所有已定义全局变量组成的数组。变量名就是该数组的索引。
这是一个“superglobal”,或者可以描述为自动全局变量。这只不过意味这它在所有的脚本中都有效。在函数或方法中不需要使用 global $globals; 来访问它。
前一个错误消息:$php_errormsg
$php_errormsg 是包含 php 产生的上一错误消息内容的变量。该变量在发生错误并且 track_errors 选项打开(默认为关闭)后才有效。
<?php
function getserveraddress() {
if($_server['server_addr']) {
return $_server['server_addr'];
}
$ifconfig = shell_exec('/sbin/ifconfig eth0');
preg_match('/addr:([\d\.]+)/',$ifconfig,$match);
return $match[1];
}
?>
<?php
function getserveraddress() {
if($_server['server_addr']) {
return $_server['server_addr'];
}
$ifconfig = shell_exec('/sbin/ifconfig eth0');
preg_match('/addr:([\d\.]+)/',$ifconfig,$match);
return $match[1];
}
?>
上一篇: 水煮河虾怎么做,记住这几个要点
下一篇: 枚举类(Enum)的使用Demo