PHP4手册:函数库及函数(二) 阿帕契伺服器专用函式库

--------------------------------------------------------------------------------
 阿帕契伺服器专用函式库 
--------------------------------------------------------------------------------
 

本函式库共有 4 个函式
顾名思义，若 WEB 伺服器不是使用 Apache 伺服器，则本函式库就派不上用场了。  

apache_lookup_uri: 获得所有的 URI 相关资讯。 
apache_note: 获得及设定阿帕契伺服器的请求纪录。 
getallheaders: 获得所有 HTTP 变数值。 
virtual: 完成阿帕契伺服器的子请求 (sub-request)。 

--------------------------------------------------------------------------------
 函式:apache_lookup_uri() 
--------------------------------------------------------------------------------

apache_lookup_uri
获得所有的 URI 相关资讯。

语法: class apache_lookup_uri(string filename);

传回值: 类别

函式种类: PHP 系统功能

 
 
内容说明 

这个函式将 URI 的相关讯息传回到类别变数中。传回的类别变数包括下列的属性:

status
the_request
status_line
method
content_type
handler
uri
filename
path_info
args
boundary
no_cache
no_local_copy
allowed
send_bodyct
bytes_sent
byterange
clength
unparsed_uri
mtime
request_time

--------------------------------------------------------------------------------
 函式:apache_note() 
--------------------------------------------------------------------------------
 
apache_note
获得及设定阿帕契伺服器的请求纪录。

语法: string apache_note(string note_name, string [note_value]);

传回值: 字串

函式种类: PHP 系统功能

 
 
内容说明 

这个阿帕契伺服器特有的函式能设定及取得请求纪录表的值。若只代入一个参数，则传回目前纪录的 note_name 值。若代入二个参数，则传回先前的 note_name 值，并将 note_name 设为新的 note_value 值。

--------------------------------------------------------------------------------
 函式:getallheaders() 
--------------------------------------------------------------------------------

getallheaders
获得所有 HTTP 变数值。

语法: array getallheaders(void);

传回值: 阵列

函式种类: PHP 系统功能

 
 
内容说明 

使用本项功能时不需代入任何参数值，传回的是所有 HTTP 变数值，并使用组合的阵列传回。

 
 
使用范例 

下例列出所有的 HTTP 变数

$headers = getallheaders();
while (list($header, $value) = each($headers)) {
  echo "$header: $value
\n";
}
?>

备注:  这个函式只有 PHP 以阿帕契伺服器的模组 (module) 方式执行时方有效。 

--------------------------------------------------------------------------------
 函式:virtual() 
--------------------------------------------------------------------------------
 
virtual
完成阿帕契伺服器的子请求 (sub-request)。

语法: int virtual(string filename);

传回值: 整数

函式种类: PHP 系统功能

 
 
内容说明 

这个函式就等于使用伺服器端剖析 (SSI) 的 shtml 功能。值得注意的是 virtual 所引入的程式必须要产生有效的 HTTP 档头，最少要加入 Content-type 档头、或者是 Location 档头、或者 Status 档头。并且根据 HTTP 协定，在档头结束后尚必须空一行。在 PHP 的程式实作时，可使用 include() 或 require() 这二个函式。