Tabela H-5. Opções de Configuração de Caminhos e Diretórios
Nome | Padrão | Alterável para |
---|---|---|
include_path | PHP_INCLUDE_PATH | PHP_INI_ALL |
doc_root | PHP_INCLUDE_PATH | PHP_INI_SYSTEM |
user_dir | NULL | PHP_INI_SYSTEM |
extension_dir | PHP_EXTENSION_DIR | PHP_INI_SYSTEM |
cgi.fix_pathinfo | "0" | PHP_INI_SYSTEM |
cgi.force_redirect | "1" | PHP_INI_SYSTEM |
cgi.redirect_status_env | "" | PHP_INI_SYSTEM |
fastcgi.impersonate | "0" | PHP_INI_SYSTEM |
cgi.rfc2616_headers | "0" | PHP_INI_SYSTEM |
Breve descrição das diretivas de configuração.
Especifica a lista de diretórios onde as funções require(), include() e fopen_with_path() procuram por arquivos. O formato deve ser igual ao da variável PATH do sistema: uma lista de diretórios separados por vírgula no Unix e ponto-e-vírgula no Windows.
Uso de . no caminho de inclusão (include path) permite que includes usando caminho relativo em relação ao diretório atual.
Diretório raiz do PHP no servidor. Só usado se o valor da diretiva não estiver vazio. Se o PHP for configurado com safe mode, nenhum arquivo fora desse diretório estão disponíveis para os scripts. Se o PHP não foi compilado com FORCE_REDIRECT, você deve configurar doc_root se você estiver rodando o PHP como um CGI em qualquer servidor web (a não ser o IIS). A alternativa é usar a configuração cgi.force_redirect abaixo.
O nome base do diretório usado no diretório home de um usuário para os arquivos PHP, por exemplo, public_html .
Em qual diretório o PHP deve procurar por extensões carregáveis dinâmicamente. Veja também enable_dl, e dl().
Quais extensões carregáveis dinâmicamente o PHP deve carregar quando iniciar.
Provê suporte real à PATH_INFO/PATH_TRANSLATED para CGI. O comportamento anterior do PHP era configurar PATH_TRANSLATED com o valor de SCRIPT_FILENAME, e não definia o que é PATH_INFO. Para mais informações sobre PATH_INFO, veja as especificações de CGI. Editar essa diretiva para 1 fará o CGI do PHP consertar os seus caminhos para se adequar a essas especificações. Valor zero causa o PHP a se comportar como antes. O padrão é zero. Se usar como 0, você deve modificar seus scripts para usar SCRIPT_FILENAME ao invés de PATH_TRANSLATED.
cgi.force_redirect é necessária para prover segurança quando usando o PHP como um CGI sob a maioria dos servidores web. Se não for definida, o PHP habilita essa diretiva por padrão. Você pode desligar, mas os riscos são altos e a responsabilidade é sua.
Nota: Usuários do Windows: Você pode desligar essa diretiva com segurança para o IIS, de fato, você deve. Para fazer o OmniHTTPD ou Xitami funcionar, você deve desligar essa diretiva.
Se a diretiva cgi.force_redirect estiver ligada, e você não estiver rodando sob o servidor Apache ou o Netscape (iPlanet), você pode precisar configurar um nome de variável de ambiente que o PHP procurará para saber se ele pode continuar a execução.
Nota: Configurar essa viariável pode causar falhas de segurança, saiba o que está fazendo primeiro.
FastCGI sob o IIS (em SOs baseados no WINNT) suporta a habilidade de fingir tokens de segurança do cliente requerinte. Isso permite que o IIS defina o contexto de segurança que a requisição rodará. mod_fastcgi sob o Apache ainda não suporta essa opção. (03/17/2002) Defina para 1 se estiver rodando sob o IIS. Padrão é zero.
Fala para o PHP que tipo de cabeçalhos usar quando enviar o código de resposta HTTP. Se estiver configurado para 0, o PHP manda um Status: cabeçalho que é suportado pelo Apache e outros servidores web. Quando essa opção tem o valor 1, o PHP enviará cabeçalhos que condizem com o padrão RFC 2616. A não ser que saiba o que está fazendo, deixe o valor dessa diretiva em 0.