array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.virtual.php', 1 => 'virtual', 2 => 'Realiza uma sub-requisição Apache', ), 'up' => array ( 0 => 'ref.apache.php', 1 => 'Apache Funções', ), 'prev' => array ( 0 => 'function.getallheaders.php', 1 => 'getallheaders', ), 'next' => array ( 0 => 'book.fpm.php', 1 => 'Gerenciador de processos FastCGI', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/apache/functions/virtual.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

virtual

(PHP 4, PHP 5, PHP 7, PHP 8)

virtual — Realiza uma sub-requisição Apache

Descrição

virtual(string $uri): bool

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

Aviso

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.

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.

Veja Também