Manual do PHP
Anterior | Apêndice H. Lista de diretivas principais do arquivo `php.ini` | Próxima

# Caminhos e Diretórios

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.

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.

Anterior | Principal | Próxima
Manuseio de dados | Acima | Uploads de Arquivos