(PHP 4, PHP 5, PHP 7, PHP 8)
virtual — Realiza uma sub-requisição Apache
virtual() é uma função específica do Apache equivalente a <!--#include virtual...--> no mod_include. Realiza uma sub-requisição do Apache. Util na inclusão de scripts CGI ou arquivos .shtml, ou qualquer outra coisa que você possa interpretar no Apache. Note que para um script CGI, o script precisa gerar um cabeçalho CGI válido. Isto significa que, no mínimo, ele precisa gerar um header Content-Type.
Para executar a sub-requisição, todos os buffers são finalizados e enviados para o browser. Cabeçalhos pendentes também serão enviados.
Esta função é suportada quando o PHP é instalado como um módulo do servidor web Apache.
uriA URL no qual o comando virtual será realizado.
Realizada o comando virtual em sucesso, retorna false em erros.
Veja apache_note() para um exemplo.
Uma query string pode ser passada para o arquivo incluído mas $_GET é copiado do script anterior somente se $_SERVER['QUERY_STRING'] é preenchido com o valor da query string. A query string pode ser passada somente no Apache 2. A página requisitada não será listada nos logs do Apache.
Nota:
Variáveis de ambiente configuradas no arquivo requisitado não estarão visíveis no script incluído.
Nota:
Essa função pode ser utilizada em scripts PHP. Entretanto é geralmente melhor utilizar as funções include ou require para arquivos PHP.