<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>Configuração em tempo de execução</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="Manual do PHP"
HREF="index.html"><LINK
REL="UP"
TITLE="Instalação e Configuração"
HREF="install.html"><LINK
REL="PREVIOUS"
TITLE="Relatos de Bug"
HREF="install.problems.bugs.html"><LINK
REL="NEXT"
TITLE="Como mudar as configurações"
HREF="configuration.changes.html"><META
HTTP-EQUIV="Content-type"
CONTENT="text/html; charset=UTF-8"></HEAD
><BODY
CLASS="chapter"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>Manual do PHP</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="install.problems.bugs.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="configuration.changes.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="chapter"
><H1
><A
NAME="configuration"
>Capítulo 9. Configuração em tempo de execução</A
></H1
><DIV
CLASS="TOC"
><DL
><DT
><B
>Índice</B
></DT
><DT
><A
HREF="configuration.html#configuration.file"
>O arquivo de configuração</A
></DT
><DT
><A
HREF="configuration.changes.html"
>Como mudar as configurações</A
></DT
></DL
></DIV
><DIV
CLASS="sect1"
><H1
CLASS="sect1"
><A
NAME="configuration.file"
>O arquivo de configuração</A
></H1
><P
> O arquivo de configuração (chamado <TT
CLASS="filename"
>php3.ini</TT
> no
PHP 3, e simplesmente <TT
CLASS="filename"
>php.ini</TT
> a partir do PHP 4)
é lido quando o PHP inicia. Para as versões de módulo de servidor,
isso acontece apenas quando o servidor web for inicializado. Para as
versões <ACRONYM
CLASS="acronym"
>CGI</ACRONYM
> e <ACRONYM
CLASS="acronym"
>CLI</ACRONYM
>, isso acontece
à cada invocação.
</P
><P
> <TT
CLASS="filename"
>php.ini</TT
> é procurado nesses lugares (na ordem):
<P
></P
><UL
><LI
><P
> Local específico do módulo SAPI (diretiva <TT
CLASS="literal"
>PHPIniDir</TT
>
no Apache 2, <TT
CLASS="literal"
>-c</TT
> opção de linha de comando quando CGI e CLI,
parâmetro <TT
CLASS="literal"
>php_ini</TT
> no NSAPI,
variável de ambiente <TT
CLASS="literal"
>PHP_INI_PATH</TT
> no THTTPD)
</P
></LI
><LI
><P
> A variável de ambiênte <CODE
CLASS="varname"
>PHPRC</CODE
>. Antes do PHP 5.2.0
isto era conferido depois da chave de registro mencionada abaixo.
</P
></LI
><LI
><P
> A partir do PHP 5.2.0, os seguintes locais do registro são procurados
em ordem:
<TT
CLASS="literal"
>HKEY_LOCAL_MACHINE\SOFTWARE\PHP\x.y.z\IniFilePath</TT
>,
<TT
CLASS="literal"
>HKEY_LOCAL_MACHINE\SOFTWARE\PHP\x.y\IniFilePath</TT
> and
<TT
CLASS="literal"
>HKEY_LOCAL_MACHINE\SOFTWARE\PHP\x\IniFilePath</TT
>, where
x, y e z significam as versôes do PHP maior, menor e release.
</P
></LI
><LI
><P
> <TT
CLASS="literal"
>HKEY_LOCAL_MACHINE\SOFTWARE\PHP\IniFilePath</TT
>
(Local no registro do Windows)
</P
></LI
><LI
><P
> Diretório de trabalho atual (exceto CLI)
</P
></LI
><LI
><P
> O diretório do servidor web (para módulo SAPI), ou diretório do PHP
(caso contrário, no Windows)
</P
></LI
><LI
><P
> Diretório do Windows (<TT
CLASS="filename"
>C:\windows</TT
>
ou <TT
CLASS="filename"
>C:\winnt</TT
>) (para o Windows), ou
ou a opção de tempo de compilação <TT
CLASS="literal"
>--with-config-file-path</TT
>
</P
></LI
></UL
>
</P
><P
> Se <TT
CLASS="filename"
>php-SAPI.ini</TT
> existe (onde SAPI é o SAPI usado, então o
nome de arquivo é, por exemplo, <TT
CLASS="filename"
>php-cli.ini</TT
> ou
<TT
CLASS="filename"
>php-apache.ini</TT
>), é usado ao invés do arquivo <TT
CLASS="filename"
>php.ini</TT
>.
nome SAPI pode ser determinado pela função <A
HREF="function.php-sapi-name.html"
><B
CLASS="function"
>php_sapi_name()</B
></A
>.
</P
><DIV
CLASS="note"
><BLOCKQUOTE
CLASS="note"
><P
><B
>Nota: </B
>
O servidor web Apache muda o diretório para raiz durante a inicialização, causando com
que o PHP tente ler o arquivo <TT
CLASS="filename"
>php.ini</TT
> da raiz do arquivo de sistema, se ele existir.
</P
></BLOCKQUOTE
></DIV
><P
> As diretivas do arquivo <TT
CLASS="filename"
>php.ini</TT
> tratadas por extensões são documentadas respectivamente
nas páginas das próprias extensões. A <A
HREF="ini.html"
>lista de
diretivas principais</A
> está disponível no apêdice. No entanto, provavelmente nem todas
as diretivas do PHP estão documentadas no manual. Para uma lista completa
das diretivas disponíveis na sua versão do PHP, por favor leia seu arquivo
<TT
CLASS="filename"
>php.ini</TT
>. Também há alternativa de baixar a
<A
HREF="http://cvs.php.net/viewvc.cgi/php-src/php.ini-dist?view=co"
TARGET="_top"
>última versão do arquivo <TT
CLASS="filename"
>php.ini</TT
></A
> dos
repositórios do CVS, que pode ser de ajuda também.
</P
><P
> <TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
CLASS="EXAMPLE"
><TR
><TD
><DIV
CLASS="example"
><A
NAME="AEN2594"
></A
><P
><B
>Exemplo 9-1. <TT
CLASS="filename"
>php.ini</TT
> example</B
></P
><TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
CELLPADDING="5"
><TR
><TD
><PRE
CLASS="ini"
>; any text on a line after an unquoted semicolon (;) is ignored
[php] ; section markers (text within square brackets) are also ignored
; Boolean values can be set to either:
; true, on, yes
; or false, off, no, none
register_globals = off
track_errors = yes
; you can enclose strings in double-quotes
include_path = ".:/usr/local/lib/php"
; backslashes are treated the same as any other character
include_path = ".;c:\php\lib"</PRE
></TD
></TR
></TABLE
></DIV
></TD
></TR
></TABLE
>
</P
><P
> A partir do PHP 5.1.0, é possível acessar as variáveis .ini
dentro dos arquivos .ini. Exemplo:<TT
CLASS="literal"
>open_basedir = ${open_basedir}
":/new/dir"</TT
>.
</P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="install.problems.bugs.html"
ACCESSKEY="P"
>Anterior</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Principal</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="configuration.changes.html"
ACCESSKEY="N"
>Próxima</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Relatos de Bug</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="install.html"
ACCESSKEY="U"
>Acima</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Como mudar as configurações</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
