Выполняет подзапрос Apache

# virtual

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

virtual — Выполняет подзапрос Apache

### Описание

function virtual(string `$uri`): bool

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

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

Эта функция поддерживается только если PHP установлен в качестве модуля Apache в веб-серверах.

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

`uri`

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

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

Результат выполнения подзапроса в случае успешного выполнения или `false` в случае возникновения ошибки.

### Примеры

Пример использования смотрите в функции apache_note().

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

Внимание

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

> Замечание:

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

> Замечание:

> Эта функция может быть использована в PHP-скрипте, но, обычно, более правильным будет выбрать include или require.

### Смотрите также

- apache_note() - Возвращает и устанавливает уведомления к запросу Apache

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open