array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.virtual.php', 1 => 'virtual', 2 => 'Выполняет подзапрос Apache', ), 'up' => array ( 0 => 'ref.apache.php', 1 => 'Функции Apache', ), 'prev' => array ( 0 => 'function.getallheaders.php', 1 => 'getallheaders', ), 'next' => array ( 0 => 'book.fpm.php', 1 => 'Менеджер процессов FastCGI', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/apache/functions/virtual.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

virtual

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

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

Описание

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.

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