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