Руководство по PHP
Пред. |  | След.

# virtual

(PHP 3, PHP 4, PHP 5)

virtual -- Выполнить подзапрос Apache

## Описание

bool virtual ( string filename )

Функция virtual() специфична для сервера Apache и является эквивалентом конструкции `<!--#include virtual...-->`, используемой в mod_include. Эта функция выполняет подзапрос Apache. Она бывает полезной в тех случаях, когда вам нужно включить в свой скрипт результат выполнения других CGI программ или скриптов, обработки сервером Apache .shtml файлов или чего-либо иного, что должно быть обработано Apache. Имейте в виду, что CGI скрипты должны создавать корректные CGI заголовки. Как минимум, CGI скрипт должен создавать заголовок Content-type.

Перед тем, как осуществится выполнение подзапроса, все буферы сбрасываются и выдаются в броузер, также отсылаются заголовки, помещенные в буфер.

This function is only supported when PHP is installed as an Apache module.

## Список параметров

`filename`

  Имя файла, для которого будет выполнен подзапрос.

## Возвращаемые значения

Результат выполнения подзапроса в случае успеха, или `FALSE` при неудаче.

## Список изменений

Версия | Описание
--- | ---
4.0.6 | Эту функцию стало возможным использовать для файлов PHP. Тем не менее, чаще всего для файлов PHP лучше использовать функции include() или require().

## Примечания

Внимание
Строка запроса может быть передана вызываемому файлу, однако значение переменной `$_GET` будет скопирована из родительского скрипта. Лишь `$_SERVER['QUERY_STRING']` будет содержать переданную строку запроса. Строка запроса может быть передана только при использовании Apache 2. Запрошенный файл не будет отражен в журнале доступа (access log) Apache.

> Замечание: Переменные окружения, установленные в запрошенном файле, не видимы из вызвавшего его скрипта.

> Замечание: Начиная с PHP 4.3.3 вы также можете использовать эти функции с модулем NSAPI в серверах Netscape/iPlanet/SunONE.

Пред. | Начало | След.
getallheaders | Уровень выше | Alternative PHP Cache