apache_lookup_uri()

(PHP 4, PHP 5, PHP 7)

对指定的 URI 执行部分请求并返回所有有关信息

说明

apache_lookup_uri(string $filename): object

本函数对一个 URL 执行部分请求。取得所有有关给定资源的重要信息后就停手。

、仅在将 PHP 安装为 Apache 模块时，支持此函数。

参数

$filename

被请求的文件名（URI）。

返回值

一个有关 URI 信息的object。此object的属性有：

• 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_lookup_uri()例子

<?php
$info = apache_lookup_uri('index.php?var=value');
print_r($info);
if (file_exists($info->filename)) {
    echo 'file exists!';
}
?>

以上例程的输出类似于：

stdClass Object
(
    [status] => 200
    [the_request] => GET /dir/file.php HTTP/1.1
    [method] => GET
    [mtime] => 0
    [clength] => 0
    [chunked] => 0
    [content_type] => application/x-httpd-php
    [no_cache] => 0
    [no_local_copy] => 1
    [unparsed_uri] => /dir/index.php?var=value
    [uri] => /dir/index.php
    [filename] => /home/htdocs/dir/index.php
    [args] => var=value
    [allowed] => 0
    [sent_bodyct] => 0
    [bytes_sent] => 0
    [request_time] => 1074282764
)
file exists!

It's a very usefull function but it doesn't show all outputs. For example I only see:
[status]
[the_request]
[method]
[mtime]
[clength]
[chunked] 
[content_type] 
[no_cache] 
[no_local_copy]
[unparsed_uri] 
[uri] 
[filename] 
[path_info] 
[allowed] 
[sent_bodyct] 
[bytes_sent] 
[request_time]

A useful feature is that if you have content negotiation on (Options MultiViews) Apache will resolve the negotiation for you if possible. Thus www.example.com/blah will resolve to /base/blah.php or /base/blah.html or even /base/blah.en.html as appropriate.

bug: with apache 2, apache_lookup_uri("/directory") spits out a warning and fails to return anything. apache_lookup_uri("/directory/") works.
another bug: virtual("something") forces a header flush. I know it's documented, but it would be rather wonderful if it didn't do this. You never ever want to flush headers when you're using virtual() to include a dynamic file such as a PHP or Perl file, which excludes virtual() from being used on most of any website's contents :-(.