array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.virtual.php', 1 => 'virtual', ), '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 => 'FastCGI Process Manager', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/apache/functions/virtual.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(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.
uri
A 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.