Caminhos e Diretórios

Tabela H-5. Opções de Configuração de Caminhos e Diretórios

NomePadrãoAlterável para
include_pathPHP_INCLUDE_PATHPHP_INI_ALL
doc_rootPHP_INCLUDE_PATHPHP_INI_SYSTEM
user_dirNULLPHP_INI_SYSTEM
extension_dirPHP_EXTENSION_DIRPHP_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.

include_path string

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.

Exemplo H-1. Unix include_path

include_path=".:/php/includes"

Exemplo H-2. Windows include_path

include_path=".;c:\php\includes"

Uso de . no caminho de inclusão (include path) permite que includes usando caminho relativo em relação ao diretório atual.

doc_root string

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.

user_dir string

O nome base do diretório usado no diretório home de um usuário para os arquivos PHP, por exemplo, public_html .

extension_dir string

Em qual diretório o PHP deve procurar por extensões carregáveis dinâmicamente. Veja também enable_dl, e dl().

extension string

Quais extensões carregáveis dinâmicamente o PHP deve carregar quando iniciar.

cgi.fix_pathinfo boolean

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 boolean

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.

cgi.redirect_status_env string

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.impersonate string

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.

cgi.rfc2616_headers int

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.