virtual
(PHP 4, PHP 5, PHP 7)
virtual — Выполняет подзапрос Apache
Описание
$uri
) : bool
Функция virtual() специфична для сервера Apache
и является эквивалентом конструкции <!--#include virtual...-->,
используемой в mod_include.
Данная функция выполняет подзапрос Apache. Это бывает полезным
в тех случаях, когда необходимо включить в свой скрипт результат
выполнения других CGI-скриптов или файлов .shtml, а также
добавления всего, что должно быть обработано Apache.
Обратите внимание, что CGI-скрипты должны отдавать корректные CGI-заголовки.
Как минимум, CGI-скрипт должен создавать заголовок Content-Type.
Перед тем, как осуществится выполнение подзапроса, все буферы сбрасываются и выдаются в браузер, при этом отсылаются заголовки, помещенные в буфер.
Эта функция поддерживается только если PHP установлен в качестве модуля Apache или как серверный модуль NSAPI в веб-серверах Netscape/iPlanet/SunONE.
Список параметров
-
uri -
Имя файла, для которого будет выполнен подзапрос.
Возвращаемые значения
Результат выполнения подзапроса в случае успеха или false в случае ошибки.
Примеры
Пример использования смотрите в функции apache_note().
Примечания
Строка запроса может быть передана вызываемому файлу, однако значение переменной $_GET будет скопировано из родительского скрипта, лишь $_SERVER['QUERY_STRING'] будет содержать переданную строку запроса. Строка запроса может быть передана только при использовании Apache 2. Запрошенный файл не будет отражен в журнале доступа (access log) Apache.
Замечание:
Переменные окружения, установленные в запрошенном файле, не видимы из вызвавшего его скрипта.
Замечание:
Эта функция может быть использована в PHP-скрипте, но, обычно, более правильным будет выбрать include или require.