virtual
(PHP 4, PHP 5, PHP 7, PHP 8)
virtual — Realiza uma sub-requisição Apache
Descrição
virtual() é uma função específica do Apache
equivalente a <!--#include virtual...-->
no mod_include.
Realiza uma sub-requisição do Apache. Útil na inclusão de
scripts CGI ou arquivos .shtml, ou qualquer outra coisa que possa ser interceptada
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 cabeçalho Content-Type.
Para executar a sub-requisição, todos os buffers são finalizados e enviados para o navegador. Cabeçalhos pendentes também serão enviados.
Esta função é suportada quando o PHP é instalado como um módulo do servidor web Apache.
Parâmetros
uri-
A URL no qual o comando virtual será realizado.
Valor Retornado
Realizado o comando virtual em caso de sucesso, retorna false em caso de erros.
Exemplos
Veja apache_note() para um exemplo.
Notas
Uma string de consulta pode ser passada para o arquivo incluído, mas $_GET será copiada do script anterior somente se $_SERVER['QUERY_STRING'] for preenchida com o valor da string de consulta. A string de consulta pode ser passada somente no Apache 2. A página requisitada não será listada nos registros do Apache.
Note:
Variáveis de ambiente configuradas no arquivo requisitado não estarão visíveis no script incluído.
Note:
Essa função pode ser utilizada em scripts PHP. Entretanto, é geralmente melhor utilizar as funções include ou require para arquivos PHP.