<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <HTML ><HEAD ><TITLE >Descrição das diretivas do principais do arquivo php.ini</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="Diretivas do arquivo php.ini" HREF="ini.html"><LINK REL="PREVIOUS" TITLE="Diretivas do arquivo php.ini" HREF="ini.html"><LINK REL="NEXT" TITLE="List of Supported Timezones" HREF="timezones.html"><META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=UTF-8"></HEAD ><BODY CLASS="section" 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="ini.html" ACCESSKEY="P" >Anterior</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" >Apêndice H. Diretivas do arquivo <TT CLASS="filename" >php.ini</TT ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="timezones.html" ACCESSKEY="N" >Próxima</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="ini.core" >Descrição das diretivas do principais do arquivo <TT CLASS="filename" >php.ini</TT ></A ></H1 ><P > Essa lista inclue as diretivas principais do arquivo <TT CLASS="filename" >php.ini</TT > que você pode modificar para configurar o PHP. Diretivas manipuladas por extensões são listadas e detalhadas nas páginas de documentação de suas respectivas extensões; Informação sobre diretivas de sessão, por exemplo, podem ser encontradas nas <A HREF="ref.session.html" >páginas de sessão</A >. </P ><DIV CLASS="section" ><H2 CLASS="section" ><A NAME="ini.sect.httpd-options" >Opções do servidor HTTP</A ></H2 ><P > <DIV CLASS="table" ><A NAME="AEN279389" ></A ><P ><B >Tabela H-3. Opções do servidor HTTP</B ></P ><TABLE BORDER="1" CLASS="CALSTABLE" ><COL><COL><COL><COL><THEAD ><TR ><TH >Nome</TH ><TH >Valor padrão</TH ><TH >Alterável</TH ><TH >Changelog</TH ></TR ></THEAD ><TBODY ><TR ><TD >async_send</TD ><TD >"0"</TD ><TD >PHP_INI_ALL</TD ><TD > </TD ></TR ></TBODY ></TABLE ></DIV > </P ><P > </P ></DIV ><DIV CLASS="section" ><H2 CLASS="section" ><A NAME="ini.sect.language-options" >Opções da Linguagem</A ></H2 ><P > <DIV CLASS="table" ><A NAME="AEN279408" ></A ><P ><B >Tabela H-4. Opções e Configurações Mistas da Linguagem</B ></P ><TABLE BORDER="1" CLASS="CALSTABLE" ><COL><COL><COL><COL><THEAD ><TR ><TH >Name</TH ><TH >Valor padrão</TH ><TH >Changeable</TH ><TH >Changelog</TH ></TR ></THEAD ><TBODY ><TR ><TD >short_open_tag</TD ><TD >"1"</TD ><TD >PHP_INI_PERDIR</TD ><TD >PHP_INI_ALL no PHP <= 4.0.0.</TD ></TR ><TR ><TD >asp_tags</TD ><TD >"0"</TD ><TD >PHP_INI_PERDIR</TD ><TD >PHP_INI_ALL no PHP <= 4.0.0.</TD ></TR ><TR ><TD >precision</TD ><TD >"14"</TD ><TD >PHP_INI_ALL</TD ><TD > </TD ></TR ><TR ><TD >y2k_compliance</TD ><TD >"1"</TD ><TD >PHP_INI_ALL</TD ><TD > </TD ></TR ><TR ><TD >allow_call_time_pass_reference</TD ><TD >"1"</TD ><TD >PHP_INI_PERDIR</TD ><TD >PHP_INI_ALL no PHP <= 4.0.0.</TD ></TR ><TR ><TD >expose_php</TD ><TD >"1"</TD ><TD ><TT CLASS="filename" >php.ini</TT > only</TD ><TD > </TD ></TR ><TR ><TD >zend.ze1_compatibility_mode</TD ><TD >"0"</TD ><TD >PHP_INI_ALL</TD ><TD >DisponÃvel desde o PHP 5.0.0.</TD ></TR ></TBODY ></TABLE ></DIV > </P ><P >Breve descrição das diretivas de configuração.</P ><P > <P ></P ><DIV CLASS="variablelist" ><DL ><DT ><A NAME="ini.short-open-tag" ></A ><CODE CLASS="parameter" >short_open_tag</CODE > <A HREF="language.types.boolean.html" ><B CLASS="type" >boolean</B ></A ></DT ><DD ><P > Determina se a forma abreviada das tags de abertura do PHP (<KBD CLASS="userinput" ><? ?></KBD >) serão permitidas. Se você usar o PHP junto com XML, você pode desabilitar essa opção para usar <KBD CLASS="userinput" ><?xml ?></KBD > inline. Caso contrário, você pode imprimir o XML com o PHP, por exemplo: <KBD CLASS="userinput" ><?php echo '<?xml version="1.0"'; ?></KBD >. E, se desabilitado, você deve usar a forma extensa das tags de abertura do PHP (<KBD CLASS="userinput" ><?php ?></KBD >). </P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Nota: </B > Essa diretiva também afeta o atalho <KBD CLASS="userinput" ><?=</KBD >, que é idêntico à <KBD CLASS="userinput" ><? echo</KBD >. Uso desse atalho requer que <SPAN CLASS="systemitem" >short_open_tag</SPAN > esteja ativada. </P ></BLOCKQUOTE ></DIV ></DD ><DT ><A NAME="ini.asp-tags" ></A ><CODE CLASS="parameter" >asp_tags</CODE > <A HREF="language.types.boolean.html" ><B CLASS="type" >boolean</B ></A ></DT ><DD ><P > Habilita o uso de tag no estilo ASP <% %> além das tags comuns <?php ?>. Isso inclui o atalho para impressão do valor de variável <%= $value %>. Para mais informação, veja <A HREF="language.basic-syntax.html#language.basic-syntax.phpmode" >Imprimindo HTML</A >. </P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Nota: </B > Suport para tags no estilo ASP foi adicionado na versão 3.0.4. </P ></BLOCKQUOTE ></DIV ></DD ><DT ><A NAME="ini.precision" ></A ><CODE CLASS="parameter" >precision</CODE > <A HREF="language.types.integer.html" ><B CLASS="type" >integer</B ></A ></DT ><DD ><P > O número de digitos de significância mostrado em números decimais (ponto flutuante). </P ></DD ><DT ><A NAME="ini.y2k-compliance" ></A ><CODE CLASS="parameter" >y2k_compliance</CODE > <A HREF="language.types.boolean.html" ><B CLASS="type" >boolean</B ></A ></DT ><DD ><P > Reforça compatibilidade com ano 2000 (causará problemas com navegadores não compatÃveis) </P ></DD ><DT ><A NAME="ini.allow-call-time-pass-reference" ></A ><CODE CLASS="parameter" >allow_call_time_pass_reference</CODE > <A HREF="language.types.boolean.html" ><B CLASS="type" >boolean</B ></A ></DT ><DD ><P > Se deve lançar um aviso quando argumentos são passados por referência durante a chamada de uma função. Esse método é depreciado e provavelmente deixará de ser suportado em versões futuras do PHP/Zend. O método encorajado para especificar quais argumentos devem ser passados por referência é na declaração da função. Você é encorajado a tentar deligar essa opção e assegurar-se que seus script funcionam corretamente para garantir que eles funcionarão em versões futuras da linguagem (você receberá um aviso cada vez que você usar essa funcionalidade). </P ><P > Passar argumentos por referência durante a chamade de uma função foi depreciado por razões de clareza de código. A função pode modificar seus argumentos de maneira não documentada se não for declarado que o argumento foi passado por referência. Para previnir efeitos-colaterais é melhor especificar quais argumentos são passados por referência apenas na declaração da função. </P ><P > Veja também <A HREF="language.references.html" >Entendendo Referências</A >. </P ></DD ><DT ><A NAME="ini.expose-php" ></A ><CODE CLASS="parameter" >expose_php</CODE > <A HREF="language.types.boolean.html" ><B CLASS="type" >boolean</B ></A ></DT ><DD ><P > Decide se o PHP deve ou não expor o fato de que está instalado no servidor (ex.: adicionando sua assinatura ao cabeçalho do servidor Web). Não é nenhuma falha de segurança, mas torna possÃvel determinar se você usar o PHP no seu servidor ou não. </P ></DD ><DT ><A NAME="ini.zend.ze1-compatibility-mode" ></A ><CODE CLASS="parameter" >zend.ze1_compatibility_mode</CODE > <A HREF="language.types.boolean.html" ><B CLASS="type" >boolean</B ></A ></DT ><DD ><P > Habilita modo de compatibilidade com o Engine do Zend 1 (PHP 4). Isso afeta a clonagem, conversão (objetos sem propriedades são convertidos para 0), e <A HREF="language.oop5.object-comparison.html" >comparação de objetos</A >. Desse modo, objetos são passados, por padrão, por valor ao invés de referência. </P ><P > Veja também a seção entitulada <A HREF="migration5.html" >Migrando do PHP 4 para o PHP 5</A >. </P ></DD ></DL ></DIV > </P ></DIV ><DIV CLASS="section" ><H2 CLASS="section" ><A NAME="ini.sect.resource-limits" >Limites de Recursos</A ></H2 ><P > <DIV CLASS="table" ><A NAME="AEN279520" ></A ><P ><B >Tabela H-5. Limites de Recursos</B ></P ><TABLE BORDER="1" CLASS="CALSTABLE" ><COL><COL><COL><COL><THEAD ><TR ><TH >Name</TH ><TH >Valor padrão</TH ><TH >Alterável</TH ><TH >Changelog</TH ></TR ></THEAD ><TBODY ><TR ><TD >memory_limit</TD ><TD >"8M"</TD ><TD >PHP_INI_ALL</TD ><TD > </TD ></TR ></TBODY ></TABLE ></DIV > </P ><P >Breve descrição das diretivas de configuração.</P ><P > <P ></P ><DIV CLASS="variablelist" ><DL ><DT ><A NAME="ini.memory-limit" ></A ><CODE CLASS="parameter" >memory_limit</CODE > <A HREF="language.types.integer.html" ><B CLASS="type" >integer</B ></A ></DT ><DD ><P > Essa diretiva configura a quantidade máxima de memória (bytes) que o script pode alocar. Isso ajuda a previnir que scripts mal feitos consumam toda a memória disponÃvel em um servidor. Para usar essa diretiva, você deve habilitá-la na hora de compilar o PHP. Portanto, sua linha de configure teria que incluir: <CODE CLASS="option" >--enable-memory-limit</CODE >. Note que você deve configurá-la para -1 se você não quiser qualquer limite de memória. </P ><P > A partir do PHP 4.3.2, e quando memory_limit está habilitada, a PHP função <A HREF="function.memory-get-usage.html" ><B CLASS="function" >memory_get_usage()</B ></A > torna-se disponÃvel. </P ><P >Quando um <A HREF="language.types.integer.html" ><B CLASS="type" >integer</B ></A > é utilizado, o valor é medido em bytes. Você também pode utilizar a notação resumida como descrito <A HREF="faq.using.html#faq.using.shorthandbytes" >neste FAQ</A >.</P ></DD ></DL ></DIV > </P ><P > Veja também: <A HREF="ref.info.html#ini.max-execution-time" >max_execution_time</A >. </P ></DIV ><DIV CLASS="section" ><H2 CLASS="section" ><A NAME="ini.sect.data-handling" >Manuseio de Dados</A ></H2 ><P > <DIV CLASS="table" ><A NAME="AEN279555" ></A ><P ><B >Tabela H-6. Opções de Configuração do Manuseio de Dados</B ></P ><TABLE BORDER="1" CLASS="CALSTABLE" ><COL><COL><COL><COL><THEAD ><TR ><TH >Name</TH ><TH >Valor padrão</TH ><TH >Changeable</TH ><TH >Changelog</TH ></TR ></THEAD ><TBODY ><TR ><TD >track_vars</TD ><TD >"On"</TD ><TD >PHP_INI_??</TD ><TD > </TD ></TR ><TR ><TD >arg_separator.output</TD ><TD >"&"</TD ><TD >PHP_INI_ALL</TD ><TD >DisponÃvel desde o PHP 4.0.5.</TD ></TR ><TR ><TD >arg_separator.input</TD ><TD >"&"</TD ><TD >PHP_INI_PERDIR</TD ><TD >DisponÃvel desde o PHP 4.0.5.</TD ></TR ><TR ><TD >variables_order</TD ><TD >"EGPCS"</TD ><TD >PHP_INI_PERDIR</TD ><TD >PHP_INI_ALL no PHP <= 5.0.5.</TD ></TR ><TR ><TD >auto_globals_jit</TD ><TD >"1"</TD ><TD >PHP_INI_PERDIR</TD ><TD >DisponÃvel desde o PHP 5.0.0.</TD ></TR ><TR ><TD >register_globals</TD ><TD >"0"</TD ><TD >PHP_INI_PERDIR</TD ><TD >PHP_INI_ALL no PHP <= 4.2.3.</TD ></TR ><TR ><TD >register_argc_argv</TD ><TD >"1"</TD ><TD >PHP_INI_PERDIR</TD ><TD >PHP_INI_ALL no PHP <= 4.2.3.</TD ></TR ><TR ><TD >register_long_arrays</TD ><TD >"1"</TD ><TD >PHP_INI_PERDIR</TD ><TD >DisponÃvel desde o PHP 5.0.0.</TD ></TR ><TR ><TD >post_max_size</TD ><TD >"8M"</TD ><TD >PHP_INI_PERDIR</TD ><TD >PHP_INI_SYSTEM no PHP <= 4.2.3. DisponÃvel desde o PHP 4.0.3.</TD ></TR ><TR ><TD >gpc_order</TD ><TD >"GPC"</TD ><TD >PHP_INI_ALL</TD ><TD > </TD ></TR ><TR ><TD >auto_prepend_file</TD ><TD >NULL</TD ><TD >PHP_INI_PERDIR</TD ><TD >PHP_INI_ALL no PHP <= 4.2.3.</TD ></TR ><TR ><TD >auto_append_file</TD ><TD >NULL</TD ><TD >PHP_INI_PERDIR</TD ><TD >PHP_INI_ALL no PHP <= 4.2.3.</TD ></TR ><TR ><TD >default_mimetype</TD ><TD >"text/html"</TD ><TD >PHP_INI_ALL</TD ><TD > </TD ></TR ><TR ><TD >default_charset</TD ><TD >""</TD ><TD >PHP_INI_ALL</TD ><TD > </TD ></TR ><TR ><TD >always_populate_raw_post_data</TD ><TD >"0"</TD ><TD >PHP_INI_PERDIR</TD ><TD >PHP_INI_ALL no PHP <= 4.2.3. DisponÃvel desde o PHP 4.1.0.</TD ></TR ><TR ><TD >allow_webdav_methods</TD ><TD >"0"</TD ><TD >PHP_INI_PERDIR</TD ><TD > </TD ></TR ></TBODY ></TABLE ></DIV > </P ><P >Breve descrição das diretivas de configuração.</P ><P > <P ></P ><DIV CLASS="variablelist" ><DL ><DT ><A NAME="ini.track-vars" ></A ><CODE CLASS="parameter" >track_vars</CODE > <A HREF="language.types.boolean.html" ><B CLASS="type" >boolean</B ></A ></DT ><DD ><P > Se disponÃvel, então variáveis de Ambiente, do Servidor, enviadas via GET, POST ou Cookie podem ser encontradas no arrays associativos globais <CODE CLASS="varname" >$_ENV</CODE >, <CODE CLASS="varname" >$_SERVER</CODE >, <CODE CLASS="varname" >$_GET</CODE >, <CODE CLASS="varname" >$_POST</CODE > e <CODE CLASS="varname" >$_COOKIE</CODE >. </P ><P > Preste atenção que a partir do PHP 4.0.3, a diretiva <SPAN CLASS="systemitem" >track_vars</SPAN > está sempre ligada. </P ></DD ><DT ><A NAME="ini.arg-separator.output" ></A ><CODE CLASS="parameter" >arg_separator.output</CODE > <A HREF="language.types.string.html" ><B CLASS="type" >string</B ></A ></DT ><DD ><P > O separador usado para separar argumentos em URLs geradas pelo PHP. </P ></DD ><DT ><A NAME="ini.arg-separator.input" ></A ><CODE CLASS="parameter" >arg_separator.input</CODE > <A HREF="language.types.string.html" ><B CLASS="type" >string</B ></A ></DT ><DD ><P > Lista de separador(es) usados pelo PHP para converter URLs em variáveis. </P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Nota: </B > Cada caracter nessa diretiva é considerado um separador! </P ></BLOCKQUOTE ></DIV ></DD ><DT ><A NAME="ini.variables-order" ></A ><CODE CLASS="parameter" >variables_order</CODE > <A HREF="language.types.string.html" ><B CLASS="type" >string</B ></A ></DT ><DD ><P > Configura a ordem de avaliação das variáveis EGPCS (Environment (Ambiente), GET, POST, Cookie, Server (Servidor)). A configuração padrão dessa diretiva é "EGPCS". Usar o valor "GP" para a diretiva, por examplo, fará com que o PHP ignore completamente variáveis de ambiente, cookies e de servidor, e sobrescreva qualquer variável recebida via GET pela variável recebida por método POST que tenha o mesmo nome. </P ><P > Veja também <A HREF="ini.core.html#ini.register-globals" >register_globals</A >. </P ></DD ><DT ><A NAME="ini.auto-globals-jit" ></A ><CODE CLASS="parameter" >auto_globals_jit</CODE > <A HREF="language.types.boolean.html" ><B CLASS="type" >boolean</B ></A ></DT ><DD ><P > Quando habilitada, as variáveis de ambiente e de servidor são criadas quando são usadas (Just In Time) ao invés de quando o script começa. Se essas variáveis não forem usadas no script, ligar essa diretiva resultará em ganho de performance. </P ><P > As diretivas do PHP <A HREF="ini.core.html#ini.register-globals" >register_globals</A >, <A HREF="ini.core.html#ini.register-long-arrays" >register_long_arrays</A >, e <A HREF="ini.core.html#ini.register-argc-argv" >register_argc_argv</A > devem estar desabilitadas para essa diretiva ter algum efeito. </P ></DD ><DT ><A NAME="ini.register-globals" ></A ><CODE CLASS="parameter" >register_globals</CODE > <A HREF="language.types.boolean.html" ><B CLASS="type" >boolean</B ></A ></DT ><DD ><P > Configura se deve ou não registrar variáveis EGPCS (Environment, GET, POST, Cookie, Server) como globais. </P ><P > A partir da versão do <A HREF="http://www.php.net/releases/4_2_0.php" TARGET="_top" >PHP 4.2.0</A >, essa diretiva é <SPAN CLASS="emphasis" ><I CLASS="emphasis" >desabilitada</I ></SPAN > por padrão. </P ><P > Por favor, leia o capÃtulo de segurança em <A HREF="security.globals.html" >Usando register_globals</A > para informações relacionadas. </P ><P > Por favor, perceba que <SPAN CLASS="systemitem" >register_globals</SPAN > não pode ser configurada em tempo de execução (usando <A HREF="function.ini-set.html" ><B CLASS="function" >ini_set()</B ></A >). Embora você possa usar o arquivo <TT CLASS="filename" >.htaccess</TT > se seu servidor permitir, como descrito acima. Exemplo de entrada no arquivo <TT CLASS="filename" >.htaccess</TT >: <KBD CLASS="userinput" >php_flag register_globals off</KBD >. </P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Nota: </B > <SPAN CLASS="systemitem" >register_globals</SPAN > é afetada pela diretiva <A HREF="ini.core.html#ini.variables-order" >variables_order</A >. </P ></BLOCKQUOTE ></DIV ></DD ><DT ><A NAME="ini.register-argc-argv" ></A ><CODE CLASS="parameter" >register_argc_argv</CODE > <A HREF="language.types.boolean.html" ><B CLASS="type" >boolean</B ></A ></DT ><DD ><P > Diz ao PHP se deve declarar as variáveis argv & argc (que contêm informação recebida via GET). </P ><P > Veja também <A HREF="features.commandline.html" >linha de comando</A >. Além disso, essa diretiva está disponÃvel no PHP 4.0.0 e estava sempre ligada antes disso. </P ></DD ><DT ><A NAME="ini.register-long-arrays" ></A ><CODE CLASS="parameter" >register_long_arrays</CODE > <A HREF="language.types.boolean.html" ><B CLASS="type" >boolean</B ></A ></DT ><DD ><P > Diz ao PHP se deve ou não criar as variáveis do tipo <CODE CLASS="varname" >$HTTP_*_VARS</CODE > <A HREF="language.variables.predefined.html" > que são depreciadas</A >. Quando ligada (padrão), variáveis predefinidas com nomes longos como <CODE CLASS="varname" >$HTTP_GET_VARS</CODE > serão criadas. Se você não estiver usando elas, é recomendado desligá-la, por razões de performance. Ao invés, use os arrays superglobais, como <CODE CLASS="varname" >$_GET</CODE >. </P ><P > Essa diretiva se tornou disponÃvel no PHP 5.0.0. </P ></DD ><DT ><A NAME="ini.post-max-size" ></A ><CODE CLASS="parameter" >post_max_size</CODE > <A HREF="language.types.integer.html" ><B CLASS="type" >integer</B ></A ></DT ><DD ><P > Configura o tamanho máximo dos dados enviados via POST. Essa configuração também afeta o envio (upload) de arquivos. Para enviar arquivos grandes, esse valor deve ser maior que <A HREF="ini.core.html#ini.upload-max-filesize" >upload_max_filesize</A >. </P ><P > Se um limite de memória for imposto pelo seu script configure, <A HREF="ini.core.html#ini.memory-limit" >memory_limit</A > também afeta envio de arquivos. De maneira geral, <A HREF="ini.core.html#ini.memory-limit" >memory_limit</A > deve ser maior que <CODE CLASS="parameter" >post_max_size</CODE >. </P ><P >Quando um <A HREF="language.types.integer.html" ><B CLASS="type" >integer</B ></A > é utilizado, o valor é medido em bytes. Você também pode utilizar a notação resumida como descrito <A HREF="faq.using.html#faq.using.shorthandbytes" >neste FAQ</A >.</P ><P > Se o tamanho de dados for maior que o valor de post_max_size, os arrays <CODE CLASS="varname" >$_POST</CODE > e <CODE CLASS="varname" >$_FILES</CODE > <A HREF="language.variables.predefined.html#language.variables.superglobals" >superglobais</A > estarão vazios. Isso pode ser verificado de várias maneiras, por exemplo, passando uma variável via <CODE CLASS="varname" >$_GET</CODE > ao script que vai processar os dados, ex.: <TT CLASS="literal" ><form action="edit.php?processed=1"></TT >, e checar se <CODE CLASS="varname" >$_GET['processed']</CODE > está configurada. </P ></DD ><DT ><A NAME="ini.gpc-order" ></A ><CODE CLASS="parameter" >gpc_order</CODE > <A HREF="language.types.string.html" ><B CLASS="type" >string</B ></A ></DT ><DD ><P > Configura a ordem de avaliação das variáveis GET/POST/COOKIE. A configuração padrão dessa diretiva é "GPC". Configurá-la para "GP", por exemplo, causará que o PHP ignore os cookies complementamente e sobrescreva qualquer variável recebida via GET com a variável recebida via POST de mesmo nome. </P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Nota: </B > Essa opção não está disponÃvel no PHP 4. Use <A HREF="ini.core.html#ini.variables-order" >variables_order</A > ao invés. </P ></BLOCKQUOTE ></DIV ></DD ><DT ><A NAME="ini.auto-prepend-file" ></A ><CODE CLASS="parameter" >auto_prepend_file</CODE > <A HREF="language.types.string.html" ><B CLASS="type" >string</B ></A ></DT ><DD ><P > Especifica o nome do arquivo que é automaticamente avaliado antes do arquivo principal. O arquivo é incluÃdo como em uma chamada à função <A HREF="function.include.html" ><B CLASS="function" >include()</B ></A >, então <A HREF="ini.core.html#ini.include-path" >include_path</A > é usada.</P ><P > O valor especial <SPAN CLASS="systemitem" >none</SPAN > desabilita a inclusão automática antes do script rodar. </P ></DD ><DT ><A NAME="ini.auto-append-file" ></A ><CODE CLASS="parameter" >auto_append_file</CODE > <A HREF="language.types.string.html" ><B CLASS="type" >string</B ></A ></DT ><DD ><P > Especifica o nome do arquivo que é automaticamente avaliado depois do arquivo principal. O arquivo é incluÃdo como em uma chamada à função <A HREF="function.include.html" ><B CLASS="function" >include()</B ></A >, então <A HREF="ini.core.html#ini.include-path" >include_path</A > é usada.</P ><P > O valor especial <SPAN CLASS="systemitem" >none</SPAN > desabilita a inclusão automática depois do script rodar. <DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Nota: </B > Se o arquivo for terminado com <A HREF="function.exit.html" ><B CLASS="function" >exit()</B ></A >, a inclusão automática <SPAN CLASS="emphasis" ><I CLASS="emphasis" >não</I ></SPAN > ocorrerá.</P ></BLOCKQUOTE ></DIV > </P ></DD ><DT ><A NAME="ini.default-mimetype" ></A ><CODE CLASS="parameter" >default_mimetype</CODE > <A HREF="language.types.string.html" ><B CLASS="type" >string</B ></A ></DT ><DD ><P > </P ></DD ><DT ><A NAME="ini.default-charset" ></A ><CODE CLASS="parameter" >default_charset</CODE > <A HREF="language.types.string.html" ><B CLASS="type" >string</B ></A ></DT ><DD ><P > A partir da versão 4.0b4, PHP sempre envia um tipo de codificação de caracteres no cabeçalho Content-type:. Para desabilitar o envio de um conjunto de caracteres, simplesmente deixe essa diretiva vazia. </P ></DD ><DT ><A NAME="ini.always-populate-raw-post-data" ></A ><CODE CLASS="parameter" >always_populate_raw_post_data</CODE > <A HREF="language.types.boolean.html" ><B CLASS="type" >boolean</B ></A ></DT ><DD ><P > Sempre popular o array <CODE CLASS="varname" >$HTTP_RAW_POST_DATA</CODE > contendo os dados raw enviados via POST. Caso contrário, a variável é populada somente com o tipo MIME não reconhecido dos dados. No entanto, o método preferido para acessar dados raw enviados via POSTé <A HREF="wrappers.php.html" >php://input</A >. <CODE CLASS="varname" >$HTTP_RAW_POST_DATA</CODE > não está disponÃvel com <TT CLASS="literal" >enctype="multipart/form-data"</TT >. </P ></DD ><DT ><A NAME="ini.allow-webdav-methods" ></A ><CODE CLASS="parameter" >allow_webdav_methods</CODE > <A HREF="language.types.boolean.html" ><B CLASS="type" >boolean</B ></A ></DT ><DD ><P > Permite lidar com requisiçõs http WebDAV dentro de scripts (ex.: PROPFIND, PROPPATCH, MOVE, COPY, etc.). Essa diretiva não existe nas versões inferiores à 4.3.2. Se você quiser receber os dados dessas requisições, você tem que ligar <A HREF="ini.core.html#ini.always-populate-raw-post-data" > always_populate_raw_post_data</A > também. </P ></DD ></DL ></DIV > </P ><P > Veja também: <A HREF="ref.info.html#ini.magic-quotes-gpc" >magic_quotes_gpc</A >, <A HREF="ref.info.html#ini.magic-quotes-runtime" >magic_quotes_runtime</A >, e <A HREF="ref.sybase.html#ini.magic-quotes-sybase" >magic_quotes_sybase</A >. </P ></DIV ><DIV CLASS="section" ><H2 CLASS="section" ><A NAME="ini.sect.path-directory" >Caminhos e Diretórios</A ></H2 ><P > <DIV CLASS="table" ><A NAME="AEN279823" ></A ><P ><B >Tabela H-7. Opções de Configurações de Caminhos e Diretórios</B ></P ><TABLE BORDER="1" CLASS="CALSTABLE" ><COL><COL><COL><COL><THEAD ><TR ><TH >Name</TH ><TH >Valor padrão</TH ><TH >Alterável</TH ><TH >Changelog</TH ></TR ></THEAD ><TBODY ><TR ><TD >include_path</TD ><TD >".;/path/to/php/pear"</TD ><TD >PHP_INI_ALL</TD ><TD > </TD ></TR ><TR ><TD >doc_root</TD ><TD >NULL</TD ><TD >PHP_INI_SYSTEM</TD ><TD > </TD ></TR ><TR ><TD >user_dir</TD ><TD >NULL</TD ><TD >PHP_INI_SYSTEM</TD ><TD > </TD ></TR ><TR ><TD >extension_dir</TD ><TD >"/path/to/php"</TD ><TD >PHP_INI_SYSTEM</TD ><TD > </TD ></TR ><TR ><TD >extension</TD ><TD >NULL</TD ><TD ><TT CLASS="filename" >php.ini</TT > only</TD ><TD > </TD ></TR ><TR ><TD >cgi.fix_pathinfo</TD ><TD >"1"</TD ><TD >PHP_INI_ALL</TD ><TD >DisponÃvel desde o PHP 4.3.0.</TD ></TR ><TR ><TD >cgi.force_redirect</TD ><TD >"1"</TD ><TD >PHP_INI_ALL</TD ><TD >DisponÃvel desde o PHP 4.2.0.</TD ></TR ><TR ><TD >cgi.redirect_status_env</TD ><TD >NULL</TD ><TD >PHP_INI_ALL</TD ><TD >DisponÃvel desde o PHP 4.2.0.</TD ></TR ><TR ><TD >fastcgi.impersonate</TD ><TD >"0"</TD ><TD >PHP_INI_ALL</TD ><TD >DisponÃvel desde o PHP 4.3.0.</TD ></TR ><TR ><TD >cgi.rfc2616_headers</TD ><TD >"0"</TD ><TD >PHP_INI_ALL</TD ><TD >DisponÃvel desde o PHP 4.3.0.</TD ></TR ></TBODY ></TABLE ></DIV > </P ><P >Breve descrição das diretivas de configuração.</P ><P > <P ></P ><DIV CLASS="variablelist" ><DL ><DT ><A NAME="ini.include-path" ></A ><CODE CLASS="parameter" >include_path</CODE > <A HREF="language.types.string.html" ><B CLASS="type" >string</B ></A ></DT ><DD ><P > Especifica a lista de diretórios onde as funções <A HREF="function.require.html" ><B CLASS="function" >require()</B ></A >, <A HREF="function.include.html" ><B CLASS="function" >include()</B ></A > e <B CLASS="function" >fopen_with_path()</B > procurem arquivo. O formato é como a variável de ambiente <CODE CLASS="envar" >PATH</CODE > do sistema: uma lista de diretórios separadas com dois-pontos no Unix e ponto-e-vÃrgula no Windows. </P ><P > <TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" CLASS="EXAMPLE" ><TR ><TD ><DIV CLASS="example" ><A NAME="AEN279898" ></A ><P ><B >Exemplo H-1. Unix include_path</B ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><PRE CLASS="php.ini" >include_path=".:/php/includes"</PRE ></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE > </P ><P > <TABLE WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" CLASS="EXAMPLE" ><TR ><TD ><DIV CLASS="example" ><A NAME="AEN279902" ></A ><P ><B >Exemplo H-2. Windows include_path</B ></P ><TABLE BORDER="0" BGCOLOR="#E0E0E0" CELLPADDING="5" ><TR ><TD ><PRE CLASS="php.ini" >include_path=".;c:\php\includes"</PRE ></TD ></TR ></TABLE ></DIV ></TD ></TR ></TABLE > </P ><P > Usando um <TT CLASS="literal" >.</TT > no caminho de inclusão permite includes usando caminho relativo, já que significa o diretório atual. </P ></DD ><DT ><A NAME="ini.doc-root" ></A ><CODE CLASS="parameter" >doc_root</CODE > <A HREF="language.types.string.html" ><B CLASS="type" >string</B ></A ></DT ><DD ><P > O "diretório raiz" do PHP no servidor. Só usada se não estiver vazia. Se o PHP é configurado com <A HREF="features.safe-mode.html#ini.safe-mode" >safe mode</A >, nenhum arquivo fora desse diretório pode ser acessado. Se o PHP não foi compilado com FORCE_REDIRECT, você <SPAN CLASS="emphasis" ><I CLASS="emphasis" >deve </I ></SPAN > configurar doc_root se você estivar usando o PHP como CGI em qualquer servidor web (fora o IIS). A alternativa é usar a diretiva <A HREF="ini.core.html#ini.cgi.force-redirect" > cgi.force_redirect</A > abaixo. </P ></DD ><DT ><A NAME="ini.user-dir" ></A ><CODE CLASS="parameter" >user_dir</CODE > <A HREF="language.types.string.html" ><B CLASS="type" >string</B ></A ></DT ><DD ><P > O nome base do diretório usado na home do usuário para arquivos PHP, por examplo, <TT CLASS="filename" >public_html </TT >. </P ></DD ><DT ><A NAME="ini.extension-dir" ></A ><CODE CLASS="parameter" >extension_dir</CODE > <A HREF="language.types.string.html" ><B CLASS="type" >string</B ></A ></DT ><DD ><P > Em qual diretório o PHP deve procurar por extensões carregadas dinamicamente. Veja também: <A HREF="ref.info.html#ini.enable-dl" >enable_dl</A >, e <A HREF="function.dl.html" ><B CLASS="function" >dl()</B ></A >. </P ></DD ><DT ><A NAME="ini.extension" ></A ><CODE CLASS="parameter" >extension</CODE > <A HREF="language.types.string.html" ><B CLASS="type" >string</B ></A ></DT ><DD ><P > Quais extensões carregáveis dinamicamente devem ser carregadas quando o PHP iniciar. </P ></DD ><DT ><A NAME="ini.cgi.fix-pathinfo" ></A ><CODE CLASS="parameter" >cgi.fix_pathinfo</CODE > <A HREF="language.types.boolean.html" ><B CLASS="type" >boolean</B ></A ></DT ><DD ><P > Prove suporte <SPAN CLASS="emphasis" ><I CLASS="emphasis" >real</I ></SPAN > para PATH_INFO/PATH_TRANSLATED no CGI. O comportamento anterior do PHP era configurar PATH_TRANSLATED como SCRIPT_FILENAME, e não configurar PATH_INFO. Para mais informações sobre PATH_INFO, veja as especificações do CGI. Configurar essa diretiva para 1 causará o PHP CGI para consertar os seus paths para se adaptar as especificações. O valor zero faz com que o PHP se comporte como antes. O valor padrão é zero. Você deve modificar seus scripts para usar SCRIPT_FILENAME ao invés de PATH_TRANSLATED. </P ></DD ><DT ><A NAME="ini.cgi.force-redirect" ></A ><CODE CLASS="parameter" >cgi.force_redirect</CODE > <A HREF="language.types.boolean.html" ><B CLASS="type" >boolean</B ></A ></DT ><DD ><P > cgi.force_redirect é necessário para prover segurança no PHP rodando como CGI na maioria dos servidores web. Se deixar indefinido, PHP liga essa diretiva por padrão. Você pode desligar <SPAN CLASS="emphasis" ><I CLASS="emphasis" >mas o risco é seu!</I ></SPAN >. </P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Nota: </B > Usuários Windows: Vocês <SPAN CLASS="emphasis" ><I CLASS="emphasis" >podem</I ></SPAN > desligar essa diretiva com segurança para o IIS, de fato, vocês <SPAN CLASS="emphasis" ><I CLASS="emphasis" >devem</I ></SPAN >. Para fazer o OmniHTTPD ou o Xitami funcionar, você <SPAN CLASS="emphasis" ><I CLASS="emphasis" >deve</I ></SPAN > desligar essa diretiva. </P ></BLOCKQUOTE ></DIV ></DD ><DT ><A NAME="ini.cgi.redirect-status-env" ></A ><CODE CLASS="parameter" >cgi.redirect_status_env</CODE > <A HREF="language.types.string.html" ><B CLASS="type" >string</B ></A ></DT ><DD ><P > Se cgi.force_redirect estiver ligado, e você não estiver usando os servidores Apache or Netscape (iPlanet), você <SPAN CLASS="emphasis" ><I CLASS="emphasis" >pode</I ></SPAN > precisar configurar um nome de variável de ambiente que o PHP procurará para saber se pode continuar a execução. </P ><DIV CLASS="note" ><BLOCKQUOTE CLASS="note" ><P ><B >Nota: </B > Configurar essa variável <SPAN CLASS="emphasis" ><I CLASS="emphasis" >pode</I ></SPAN > causar problemas de segurança, <SPAN CLASS="emphasis" ><I CLASS="emphasis" >saiba o que está fazendo antes</I ></SPAN >. </P ></BLOCKQUOTE ></DIV ></DD ><DT ><A NAME="ini.fastcgi.impersonate" ></A ><CODE CLASS="parameter" >fastcgi.impersonate</CODE > <A HREF="language.types.string.html" ><B CLASS="type" >string</B ></A ></DT ><DD ><P > FastCGI no IIS (em SOs baseados no WINNT) suporta a habilidade de fingir tokens de segurança do cliente. Isso permite que o IIS defina o contexto de segurança que a requisição deve rodar. mod_fastcgi no Apache não atualmente não suporta essa caracterÃstica. (03/17/2002) Configure para 1 se estiver rodando no IIS. O valor padrão é zero. </P ></DD ><DT ><A NAME="ini.cgi.rfc2616-headers" ></A ><CODE CLASS="parameter" >cgi.rfc2616_headers</CODE > <A HREF="language.types.integer.html" ><B CLASS="type" >int</B ></A ></DT ><DD ><P > Diz ao PHP qual tipo de cabeçalho de usar quando enviar o código de resposta HTTP. Se o valor for 0, o PHP envia um Status: cabeçalho suportado pelo Apache e outros servidores web. Quando essa opção tiver o valor 1, o PHP enviará um cabeçalho compatÃvel com o <A HREF="http://www.faqs.org/rfcs/rfc2616" TARGET="_top" >RFC 2616</A >. Deixe essa opção como 0 a não ser que você saiba o que está fazendo. </P ></DD ></DL ></DIV > </P ></DIV ><DIV CLASS="section" ><H2 CLASS="section" ><A NAME="ini.sect.file-uploads" >Envio de Arquivos</A ></H2 ><P > <DIV CLASS="table" ><A NAME="AEN279983" ></A ><P ><B >Tabela H-8. Opções de Configuração de Envio de Arquivos</B ></P ><TABLE BORDER="1" CLASS="CALSTABLE" ><COL><COL><COL><COL><THEAD ><TR ><TH >Name</TH ><TH >Valor padrão</TH ><TH >Changeable</TH ><TH >Changelog</TH ></TR ></THEAD ><TBODY ><TR ><TD >file_uploads</TD ><TD >"1"</TD ><TD >PHP_INI_SYSTEM</TD ><TD >PHP_INI_ALL no PHP <= 4.2.3. DisponÃvel desde o PHP 4.0.3.</TD ></TR ><TR ><TD >upload_tmp_dir</TD ><TD >NULL</TD ><TD >PHP_INI_SYSTEM</TD ><TD > </TD ></TR ><TR ><TD >upload_max_filesize</TD ><TD >"2M"</TD ><TD >PHP_INI_PERDIR</TD ><TD >PHP_INI_ALL no PHP <= 4.2.3.</TD ></TR ></TBODY ></TABLE ></DIV > </P ><P >Breve descrição das diretivas de configuração.</P ><P > <P ></P ><DIV CLASS="variablelist" ><DL ><DT ><A NAME="ini.file-uploads" ></A ><CODE CLASS="parameter" >file_uploads</CODE > <A HREF="language.types.boolean.html" ><B CLASS="type" >boolean</B ></A ></DT ><DD ><P > Se deve ou não permitir <A HREF="features.file-upload.html" >envio de arquivos</A > via HTTP. Veja também as diretivas <A HREF="ini.core.html#ini.upload-max-filesize" >upload_max_filesize</A >, <A HREF="ini.core.html#ini.upload-tmp-dir" >upload_tmp_dir</A >, e <A HREF="ini.core.html#ini.post-max-size" >post_max_size</A >. </P ><P >Quando um <A HREF="language.types.integer.html" ><B CLASS="type" >integer</B ></A > é utilizado, o valor é medido em bytes. Você também pode utilizar a notação resumida como descrito <A HREF="faq.using.html#faq.using.shorthandbytes" >neste FAQ</A >.</P ></DD ><DT ><A NAME="ini.upload-tmp-dir" ></A ><CODE CLASS="parameter" >upload_tmp_dir</CODE > <A HREF="language.types.string.html" ><B CLASS="type" >string</B ></A ></DT ><DD ><P > O diretório temporário usado para guardar arquivos quando arquivos forem enviados. O usuário do PHP deve ter permissão de escrita nesse diretório. Se não for especificado, o PHP usuará o padrão do sistema. </P ></DD ><DT ><A NAME="ini.upload-max-filesize" ></A ><CODE CLASS="parameter" >upload_max_filesize</CODE > <A HREF="language.types.integer.html" ><B CLASS="type" >integer</B ></A ></DT ><DD ><P > O tamanho máximo de um arquivo enviado. </P ><P >Quando um <A HREF="language.types.integer.html" ><B CLASS="type" >integer</B ></A > é utilizado, o valor é medido em bytes. Você também pode utilizar a notação resumida como descrito <A HREF="faq.using.html#faq.using.shorthandbytes" >neste FAQ</A >.</P ></DD ></DL ></DIV > </P ></DIV ><DIV CLASS="section" ><H2 CLASS="section" ><A NAME="ini.sql-general" >Opções Gerais de SQL</A ></H2 ><P > <DIV CLASS="table" ><A NAME="AEN280042" ></A ><P ><B >Tabela H-9. Opções de Configuração Geral de SQL</B ></P ><TABLE BORDER="1" CLASS="CALSTABLE" ><COL><COL><COL><COL><THEAD ><TR ><TH >Name</TH ><TH >Valor padrão</TH ><TH >Alterável</TH ><TH >Changelog</TH ></TR ></THEAD ><TBODY ><TR ><TD >sql.safe_mode</TD ><TD >"0"</TD ><TD >PHP_INI_SYSTEM</TD ><TD > </TD ></TR ></TBODY ></TABLE ></DIV > </P ><P >Breve descrição das diretivas de configuração.</P ><P > <P ></P ><DIV CLASS="variablelist" ><DL ><DT ><A NAME="ini.sql.safe-mode" ></A ><CODE CLASS="parameter" >sql.safe_mode</CODE > <A HREF="language.types.boolean.html" ><B CLASS="type" >boolean</B ></A ></DT ><DD ><P > </P ></DD ></DL ></DIV > </P ></DIV ><DIV CLASS="section" ><H2 CLASS="section" ><A NAME="ini.sect.debugger" >Diretivas de Configuração do Depurador (Debugger)</A ></H2 ><DIV CLASS="caution" ><P ></P ><TABLE CLASS="caution" BORDER="1" WIDTH="100%" ><TR ><TD ALIGN="CENTER" ><B >Cuidado</B ></TD ></TR ><TR ><TD ALIGN="LEFT" ><P > Apenas o PHP 3 implementa um depurador padrão, para mais informação veja <A HREF="debugger.html" >Apêndice F</A >. </P ></TD ></TR ></TABLE ></DIV ><P ></P ><DIV CLASS="variablelist" ><DL ><DT ><A NAME="ini.debugger.host" ></A ><CODE CLASS="parameter" >debugger.host</CODE > <A HREF="language.types.string.html" ><B CLASS="type" >string</B ></A ></DT ><DD ><P > Nome de DNS ou endereço IP do servidor usado pelo depurador. </P ></DD ><DT ><A NAME="ini.debugger.port" ></A ><CODE CLASS="parameter" >debugger.port</CODE > <A HREF="language.types.string.html" ><B CLASS="type" >string</B ></A ></DT ><DD ><P > Número da porta usado pelo depurador. </P ></DD ><DT ><A NAME="ini.debugger.enabled" ></A ><CODE CLASS="parameter" >debugger.enabled</CODE > <A HREF="language.types.boolean.html" ><B CLASS="type" >boolean</B ></A ></DT ><DD ><P > Determina se o depurador estará ativado. </P ></DD ></DL ></DIV ></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="ini.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="timezones.html" ACCESSKEY="N" >Próxima</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >Diretivas do arquivo <TT CLASS="filename" >php.ini</TT ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="ini.html" ACCESSKEY="U" >Acima</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >List of Supported Timezones</TD ></TR ></TABLE ></DIV ></BODY ></HTML >