php8.5
Home/ Manual/ apache / functions/ apache_lookup_uri

apache_lookup_uri

PHP function Edit on GitHub ✎

(PHP 4, PHP 5, PHP 7, PHP 8)

Perform a partial request for the specified URI and return all info about it

Description

apache_lookup_uri(string $filename): object|false

This performs a partial request for a URI. It goes just far enough to obtain all the important information about the given resource.

Module

Parameters

filename

The filename (URI) that's being requested.

Return Values

An object of related URI information. The properties of this object are:

  • 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

Returns false on failure.

Examples

apache_lookup_uri() example

php
<?php
$info = apache_lookup_uri('index.php?var=value');
print_r($info);

if (file_exists($info->filename)) {
    echo 'file exists!';
}
?>

The above example will output something similar to:

output
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!

Source: reference/apache/functions/apache-lookup-uri.xml · from the official PHP manual (php/doc-en)