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

Дивіться також

  • apache_note() - Повертає та встановлює повідомлення до запиту Apache