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

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

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

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

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

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

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

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

Версия	Описание
4.3.3	Начиная с PHP 4.3.3 вы также можете использовать эти функции с модулем NSAPI в серверах Netscape/iPlanet/SunONE.
4.0.6	Данную функцию стало возможно использовать для файлов PHP. Тем не менее, для файлов PHP лучше использовать функции include или require.

Примеры

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

Примечания

Внимание

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

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

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

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

Вернуться к: Apache