ini.core.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: fccc7eb7010120c17732c57f93df1f321245376c Maintainer: ae Status: ready --><!-- CREDITS: ae,fibbarth,fabioluciano,rogeriopradoj,adiel,geekcom,rafaelbernard -->

 <section xml:id="ini.core" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Descrição das principais diretivas do &php.ini;</title>
  <para>
   Esta lista inclui as principais diretivas do &php.ini; que podemos definir para
   configurar o PHP. Diretivas manipuladas por extensões são listadas
   e detalhadas nas respectivas páginas de documentação da extensão;
   Informações sobre diretivas de sessão, por exemplo, podem ser encontradas na
   <link linkend="session.configuration">página de sessões</link>.
  </para>
  <note>
   <para>
    Os padrões listados aqui são utilizados quando o &php.ini; não é carregado; os valores do &php.ini; de produção e desenvolvimento podem variar.
   </para>
  </note>
  <section xml:id="ini.sect.language-options">
   <title>Opções de Linguagem</title>
   <para>
    <table>
     <title>Opções de Linguagem e Configurações Diversas</title>
     <tgroup cols="4">
      <thead>
       <row>
        <entry>&Name;</entry>
        <entry>&Default;</entry>
        <entry>&Changeable;</entry>
        <entry>&Changelog;</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry><link linkend="ini.short-open-tag">short_open_tag</link></entry>
        <entry>"1"</entry>
        <entry><constant>INI_PERDIR</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.precision">precision</link></entry>
        <entry>"14"</entry>
        <entry><constant>INI_ALL</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.serialize-precision">serialize_precision</link></entry>
        <entry>"-1"</entry>
        <entry><constant>INI_ALL</constant></entry>
        <entry>
         Antes do PHP 7.1.0 o valor padrão era 17.
        </entry>
       </row>
       <row>
        <entry><link linkend="ini.disable-functions">disable_functions</link></entry>
        <entry>""</entry>
        <entry><constant>INI_SYSTEM</constant> apenas</entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.disable-classes">disable_classes</link></entry>
        <entry>""</entry>
        <entry>&php.ini; apenas</entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.exit-on-timeout">exit_on_timeout</link></entry>
        <entry>""</entry>
        <entry><constant>INI_ALL</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.expose-php">expose_php</link></entry>
        <entry>"1"</entry>
        <entry>&php.ini; apenas</entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.hard-timeout">hard_timeout</link></entry>
        <entry>"2"</entry>
        <entry><constant>INI_SYSTEM</constant></entry>
        <entry>Disponível a partir do PHP 7.1.0.</entry>
       </row>
       <row>
        <entry><link linkend="ini.zend.exception-ignore-args">zend.exception_ignore_args</link></entry>
        <entry>"0"</entry>
        <entry><constant>INI_ALL</constant></entry>
        <entry>Disponível a partir do PHP 7.4.0</entry>
       </row>
       <row>
        <entry><link linkend="ini.zend.multibyte">zend.multibyte</link></entry>
        <entry>"0"</entry>
        <entry><constant>INI_ALL</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.zend.script-encoding">zend.script_encoding</link></entry>
        <entry>NULL</entry>
        <entry><constant>INI_ALL</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.zend.detect-unicode">zend.detect-unicode</link></entry>
        <entry>NULL</entry>
        <entry><constant>INI_ALL</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.zend.signal-check">zend.signal_check</link></entry>
        <entry>"0"</entry>
        <entry><constant>INI_SYSTEM</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.zend.assertions">zend.assertions</link></entry>
        <entry>"1"</entry>
        <entry><constant>INI_ALL</constant> com restrições</entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.zend.exception-string-param-max-len">zend.exception_string_param_max_len</link></entry>
        <entry>"15"</entry>
        <entry><constant>INI_ALL</constant></entry>
        <entry>Disponível desde o PHP 8.0.0.</entry>
       </row>
      </tbody>
     </tgroup>
    </table>
   </para>

   &ini.descriptions.title;

   <para>
    <variablelist>
     <varlistentry xml:id="ini.short-open-tag">
      <term>
       <parameter>short_open_tag</parameter>
       <type>bool</type>
      </term>
      <listitem>
       <para>
        Informa ao PHP se a forma abreviada (<userinput>&lt;? ?&gt;</userinput>)
        da tag de abertura do PHP é permitida. Se quiser usar o PHP em
        conjunto com XML, esta opção pode ser desabilitada a fim de
        usar <userinput>&lt;?xml ?&gt;</userinput> em linha. Caso contrário,
        pode-se imprimir isto com o PHP, por exemplo <userinput>&lt;?php echo '&lt;?xml
        version="1.0"?&gt;'; ?&gt;</userinput>. Além disso, se desabilitada, deve ser usada
        a forma extensa da tag de abertura do PHP (<userinput>&lt;?php ?&gt;</userinput>).
       </para>
       <note>
        <para>
         Esta diretiva não afeta o equivalente
         <userinput>&lt;?=</userinput>, que está sempre disponível.
        </para>
       </note>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.precision">
      <term>
       <parameter>precision</parameter>
       <type>int</type>
      </term>
      <listitem>
       <simpara>
        O número de dígitos significativos exibidos em números de ponto flutuante.
        <literal>-1</literal> significa que um algoritmo avançado para arredondar
        estes números será utilizado.
       </simpara>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.serialize-precision">
      <term>
       <parameter>serialize_precision</parameter>
       <type>int</type>
      </term>
      <listitem>
       <simpara>
        O número de dígitos significativos armazenados durante a serialização de números de pontos flutuantes.
        <literal>-1</literal> significa que um algoritmo avançado para arredondar
        estes números será utilizado.
      </simpara>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.expose-php">
      <term>
       <parameter>expose_php</parameter>
       <type>bool</type>
      </term>
      <listitem>
       <para>
        Expõe para o mundo que o PHP está instalado no servidor, o que inclui a
        versão do PHP dentro do header HTTP (por exemplo, X-Powered-By: PHP/5.3.7).
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.disable-functions">
      <term>
       <parameter>disable_functions</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
        Esta diretiva permite desabilitar certas funções. Ela recebe
        uma lista de nomes de funções separadas por vírgula.
       </para>
       <para>
        Apenas <link linkend="functions.internal">funções internas</link> podem
        ser desabilitadas usando esta diretiva. <link linkend="functions.user-defined">Funções definidas pelo usuário</link>
        não são afetadas.
       </para>
       <para>
        Esta diretiva deve ser configurada no &php.ini;. Por exemplo, ela
        não pode ser configurada no &httpd.conf;.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.disable-classes">
      <term>
       <parameter>disable_classes</parameter>
       <type>string</type>
      </term>
      <listitem>
       <simpara>
        Esta diretiva permite desabilitar certas classes. Ela recebe
        uma lista de nomes de classes separadas por vírgula.
       </simpara>
       <simpara>
        Esta diretiva deve ser configurada no &php.ini;. Por exemplo, ela
        não pode ser configurada no &httpd.conf;.
       </simpara>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.zend.assertions">
      <term>
       <parameter>zend.assertions</parameter>
       <type>int</type>
      </term>
      <listitem>
       <simpara>
        Quando configurada para <literal>1</literal>, código assertivo será gerado e
        executado (modo de desenvolvimento). Quando configurada para <literal>0</literal>
        então código assertivo será gerado mas ignorado (não executado)
        em tempo de execução. Quando configurada para <literal>-1</literal> código assertivo não
        será gerado, tornando as asserções sem custo (modo de produção).
       </simpara>
       <note>
        <para>
         Se um processo é iniciado em modo de produção, <link linkend="ini.zend.assertions">zend.assertions</link>
         não poderá ser modificada em tempo de execução, já que o código para as asserções não foi gerado.
        </para>
        <para>
         Se um processo é iniciado em modo de desenvolvimento, <link linkend="ini.zend.assertions">zend.assertions</link>
         não poderá ser configurada para <literal>-1</literal> em tempo de execução.
        </para>
       </note>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.zend.exception-string-param-max-len">
      <term>
       <parameter>zend.exception_string_param_max_len</parameter>
       <type>int</type>
      </term>
      <listitem>
       <simpara>
        O tamanho máximo das strings na serialização string dos stack traces.
        Deve ser entre <literal>"0"</literal> e <literal>"1000000"</literal>.
       </simpara>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.hard-timeout">
      <term>
       <parameter>hard_timeout</parameter>
       <type>int</type>
      </term>
      <listitem>
       <para>
        Quando o timeout é configurado em <link linkend="ini.max-execution-time">max_execution_time</link>
        é alcançado, o runtime PHP irá descarregar os recursos de maneira organizada. Se
        algo travar nesse processo, o hard_timeout irá começar a contar
        os segundos configurados. Se o hard_timeout for atingido, o PHP irá
        descarregar de maneira desorganizada. Quando configurado para zero, o hard_timeout está desconfigurado.
       </para>
       <para>
        Quando o PHP atinge o hard_timeout, vai ocorrer algo parecido com isso::
        <screen>
<![CDATA[
Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unknown on line 0
]]>
        </screen>
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.zend.exception-ignore-args">
      <term>
       <parameter>zend.exception_ignore_args</parameter>
       <type>bool</type>
      </term>
      <listitem>
       <para>
        Exclui argumentos de rastreamentos de pilha (stack traces), gerados a partir de exceções.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.zend.multibyte">
      <term>
       <parameter>zend.multibyte</parameter>
       <type>bool</type>
      </term>
      <listitem>
       <para>
        Permite a análise de arquivos fontes em codificações multibyte. Habilitar zend.multibyte
        é necessário para utilizar character sets como SJIS, BIG5, etc., que contém caracteres
        especiais em dados de strings multibyte. Codificações compatíveis com ISO-8859-1 como UTF-8,
        EUC, etc. não requerem esta opção.
       </para>
       <para>
        Habilitar o zend.multibyte requer que a extensão mbstring esteja disponível.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.zend.script-encoding">
      <term>
       <parameter>zend.script_encoding</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
        Este valor será usado a menos que uma diretiva
        <link linkend="control-structures.declare.encoding">declare(encoding=...)</link>
        apareça no início do script. Quando uma codificação incompatível com ISO-8859-1
        é usada, ambas zend.multibyte e zend.script_encoding devem ser usadas.
       </para>
       <para>
        Strings literais serão transliteradas de zend.script_encoding para
        mbstring.internal_encoding, como se a função
        <function>mb_convert_encoding</function> tivesse sido chamada.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.zend.detect-unicode">
      <term>
       <parameter>zend.detect_unicode</parameter>
       <type>bool</type>
      </term>
      <listitem>
       <para>
        Verifica o BOM (Byte Order Mark) e determina se o arquivo contém caracteres
        multibyte válidos.
        Essa detecção é realizada antes do processamento de
        <function>__halt_compiler</function>.
        Disponível apenas no modo Zend Multibyte.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.zend.signal-check">
      <term>
       <parameter>zend.signal_check</parameter>
       <type>bool</type>
      </term>
      <listitem>
       <para>
        Verifica se há manipuladores de sinais substituídos no encerramento.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.exit-on-timeout">
      <term>
       <parameter>exit_on_timeout</parameter>
       <type>bool</type>
      </term>
      <listitem>
       <para>
        Esta é uma diretiva unicamente do módulo mod_php do Apache1 que força um subprocesso do Apache a sair se ocorrer o timeout de execução do PHP.
        Esse timeout causa uma chamada interna a longjmp() no Apache1 que pode deixar algumas extensões em um estado
        inconsistente. Ao terminar o processo, quaisquer bloqueios ou memória pendentes serão liberados.
       </para>
      </listitem>
     </varlistentry>

    </variablelist>
   </para>
  </section>

  <section xml:id="ini.sect.resource-limits">
   <title>Limites de Recursos</title>
   <para>
    <table>
     <title>Limites de Recursos</title>
     <tgroup cols="4">
      <thead>
       <row>
        <entry>&Name;</entry>
        <entry>&Default;</entry>
        <entry>&Changeable;</entry>
        <entry>&Changelog;</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry><link linkend="ini.memory-limit">memory_limit</link></entry>
        <entry>"128M"</entry>
        <entry><constant>INI_ALL</constant></entry>
        <entry></entry>
       </row>
      </tbody>
     </tgroup>
    </table>
   </para>

   &ini.descriptions.title;

   <para>
    <variablelist>
     <varlistentry xml:id="ini.memory-limit">
      <term>
       <parameter>memory_limit</parameter>
       <type>int</type>
      </term>
      <listitem>
       <para>
        Define a quantidade máxima de memória em bytes que um script
        pode alocar. Isto ajuda a prevenir que scripts mal escritos
        consumam toda a memória disponível no servidor. Note que
        para que não haja limite de memória, esta diretiva deve ser configurada para <literal>-1</literal>.
       </para>

       &ini.shorthandbytes;

      </listitem>
     </varlistentry>
    </variablelist>
   </para>
   <para>
    Veja também: <link linkend="ini.max-execution-time">max_execution_time</link>.
   </para>
  </section>

  <section xml:id="ini.sect.performance">
   <title>Ajustes de Desempenho</title>
   <para>
    <table>
     <title>Ajustes de Desempenho</title>
     <tgroup cols="4">
      <thead>
       <row>
        <entry>&Name;</entry>
        <entry>&Default;</entry>
        <entry>&Changeable;</entry>
        <entry>&Changelog;</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry><link linkend="ini.realpath-cache-size">realpath_cache_size</link></entry>
        <entry>"4M"</entry>
        <entry><constant>INI_SYSTEM</constant></entry>
        <entry>Antes do PHP 7.0.16 e 7.1.2, o padrão era <literal>"16K"</literal></entry>
       </row>
       <row>
        <entry><link linkend="ini.realpath-cache-ttl">realpath_cache_ttl</link></entry>
        <entry>"120"</entry>
        <entry><constant>INI_SYSTEM</constant></entry>
        <entry></entry>
       </row>
      </tbody>
     </tgroup>
    </table>
    <note>
     <para>
      O uso da diretiva <link linkend="ini.open-basedir">open_basedir</link> irá
      <emphasis>desativar</emphasis> o cache do caminho real.
     </para>
    </note>
   </para>
   &ini.descriptions.title;
   <para>
    <variablelist>
     <varlistentry xml:id="ini.realpath-cache-size">
      <term>
       <parameter>realpath_cache_size</parameter>
       <type>int</type>
      </term>
      <listitem>
       <para>
        Determina o tamanho do cache do realpath a ser usado pelo PHP. Este
        valor deve ser aumentado em sistemas onde o PHP abre muitos arquivos, para
        refletir a quantidade das operações de arquivo realizadas.
       </para>
       <para>
        O tamanho representa o número total de bytes nas strings de caminhos
        armazenadas, mais o tamanho dos dados associados à entrada de cache. Isto
        significa que para armazenar caminhos mais longos no cache, o tamanho de cache
        deve ser maior. Esse valor não controla diretamente o número de
        caminhos distintos que podem ser armazenados em cache.
       </para>
       <para>
        O tamanho necessário para os dados da entrada de cache depende do sistema operacional.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry xml:id="ini.realpath-cache-ttl">
      <term>
       <parameter>realpath_cache_ttl</parameter>
       <type>int</type>
      </term>
      <listitem>
       <para>
        Duração do tempo (em segundos) pela qual armazenar em cache as informações do realpath
        para um dado arquivo ou diretório. Para sistemas com arquivos que raramente mudam,
        considere aumentar o valor.
       </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </section>

  <section xml:id="ini.sect.data-handling">
   <title>Manipulação de Dados</title>
   <para>
    <table>
     <title>Opções de Configuração de Manipulação de Dados</title>
     <tgroup cols="4">
      <thead>
       <row>
        <entry>&Name;</entry>
        <entry>&Default;</entry>
        <entry>&Changeable;</entry>
        <entry>&Changelog;</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry><link linkend="ini.arg-separator.output">arg_separator.output</link></entry>
        <entry>"&amp;"</entry>
        <entry><constant>INI_ALL</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.arg-separator.input">arg_separator.input</link></entry>
        <entry>"&amp;"</entry>
        <entry><constant>INI_PERDIR</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.variables-order">variables_order</link></entry>
        <entry>"EGPCS"</entry>
        <entry><constant>INI_PERDIR</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.request-order">request_order</link></entry>
        <entry>""</entry>
        <entry><constant>INI_PERDIR</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.auto-globals-jit">auto_globals_jit</link></entry>
        <entry>"1"</entry>
        <entry><constant>INI_PERDIR</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.register-argc-argv">register_argc_argv</link></entry>
        <entry>"1"</entry>
        <entry><constant>INI_PERDIR</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.enable-post-data-reading">enable_post_data_reading</link></entry>
        <entry>"1"</entry>
        <entry><constant>INI_PERDIR</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.post-max-size">post_max_size</link></entry>
        <entry>"8M"</entry>
        <entry><constant>INI_PERDIR</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.auto-prepend-file">auto_prepend_file</link></entry>
        <entry>NULL</entry>
        <entry><constant>INI_PERDIR</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.auto-append-file">auto_append_file</link></entry>
        <entry>NULL</entry>
        <entry><constant>INI_PERDIR</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.default-mimetype">default_mimetype</link></entry>
        <entry>"text/html"</entry>
        <entry><constant>INI_ALL</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.default-charset">default_charset</link></entry>
        <entry>"UTF-8"</entry>
        <entry><constant>INI_ALL</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.input-encoding">input_encoding</link></entry>
        <entry>""</entry>
        <entry><constant>INI_ALL</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.output-encoding">output_encoding</link></entry>
        <entry>""</entry>
        <entry><constant>INI_ALL</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.internal-encoding">internal_encoding</link></entry>
        <entry>""</entry>
        <entry><constant>INI_ALL</constant></entry>
        <entry></entry>
       </row>
      </tbody>
     </tgroup>
    </table>
   </para>

   &ini.descriptions.title;

   <para>
    <variablelist>
     <varlistentry xml:id="ini.arg-separator.output">
      <term>
       <parameter>arg_separator.output</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
        O separador usado em URLs gerados pelo PHP para separar argumentos.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.arg-separator.input">
      <term>
       <parameter>arg_separator.input</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
        Lista de separadores usados pelo PHP para analisar URLs de entrada em variáveis.
       </para>
       <note>
        <para>
         Cada caractere nesta diretiva é considerado como separador!
        </para>
       </note>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.variables-order">
      <term>
       <parameter>variables_order</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
        Configura a ordem de análise das variáveis EGPCS (<literal>E</literal>nvironment,
        <literal>G</literal>et, <literal>P</literal>ost,
        <literal>C</literal>ookie e <literal>S</literal>erver).
        Por exemplo, se variables_order estiver configurada
        como <literal>"SP"</literal> então o PHP irá criar as variáveis
        &link.superglobals; <varname>$_SERVER</varname> e
        <varname>$_POST</varname>, mas não irá criar
        <varname>$_ENV</varname>, <varname>$_GET</varname> e
        <varname>$_COOKIE</varname>. Configurar como "" significa que nenhuma
        &link.superglobals; será definida.
       </para>
       <warning>
        <para>
         Em ambas as SAPIs CGI e FastCGI,
         <varname>$_SERVER</varname> também
         é preenchida por valores do ambiente; <literal>S</literal>
         é sempre equivalente a <literal>ES</literal> independentemente da
         inclusão de <literal>E</literal> em outra parte desta diretiva.
        </para>
       </warning>
       <note>
        <para>
         O conteúdo e a ordem de
         <varname>$_REQUEST</varname> também são
         afetados por esta diretiva.
        </para>
       </note>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.request-order">
      <term>
       <parameter>request_order</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
        Esta diretiva descreve a ordem na qual o PHP registra as variáves GET, POST
        e Cookie no array _REQUEST. O registro é feito
        da esquerda para direita, valores mais recentes sobrescrevem os valores mais antigos.
       </para>
       <para>
        Se esta diretiva não está definida <link
        linkend="ini.variables-order">variables_order</link> é usada para o conteúdo de
        <varname>$_REQUEST</varname>.
       </para>
       <para>
        Note que os arquivos <filename>php.ini</filename> da distribuição padrão não contêm
        o <literal>'C'</literal> para cookies, por motivos de segurança.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.auto-globals-jit">
      <term>
       <parameter>auto_globals_jit</parameter>
       <type>bool</type>
      </term>
      <listitem>
       <para>
        Quando ativada, as variáveis SERVER, REQUEST e ENV são criadas quando elas são
        usadas pela primeira vez ("Just In Time") ao invés de quando o script inicia. Se estas
        variáveis não são usadas dentro de um script, habilitar esta diretiva resultará
        em um ganho de desempenho.
       </para>
       <warning>
        <para>
         O uso das variáveis SERVER, REQUEST e ENV é verificado durante o tempo de compilação
         então usá-las, por exemplo, em <link
         linkend="language.variables.variable">variáveis variáveis</link> não
         causará sua inicialização.
        </para>
       </warning>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.register-argc-argv">
      <term>
       <parameter>register_argc_argv</parameter>
       <type>bool</type>
      </term>
      <listitem>
       <simpara>
        Informa ao PHP se deve declarar variáveis argv &amp; argc
        (que podem conter as informações das requisições GET).
       </simpara>
       <simpara>
        Veja também <link linkend="features.commandline">PHP em linha de comando</link>.
       </simpara>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.enable-post-data-reading">
      <term>
       <parameter>enable_post_data_reading</parameter>
       <type>bool</type>
      </term>
      <listitem>
       <simpara>
        Desabilitar esta opção faz com que <varname>$_POST</varname> e
        <varname>$_FILES</varname> <emphasis>não</emphasis> sejam preenchidos.
        A única forma de ler dados postados será através do stream wrapper
        <link linkend="wrappers.php">php://input</link>.
        Isto pode ser útil para intermediar requisições ou para processar
        dados POST de uma maneira eficiente em termos de memória alocada.
       </simpara>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.post-max-size">
      <term>
       <parameter>post_max_size</parameter>
       <type>int</type>
      </term>
      <listitem>
       <simpara>
        Configura o tamanho máximo dos dados postados. Esta configuração também afeta
        o upload de arquivos. Para carregar arquivos grandes este valor deve ser maior
        que <link linkend="ini.upload-max-filesize">upload_max_filesize</link>.
       </simpara>
       <simpara>
        De maneira geral
        <link linkend="ini.memory-limit">memory_limit</link> deve ser
        maior que <parameter>post_max_size</parameter>.
       </simpara>

       &ini.shorthandbytes;

       <simpara>
        Se o tamanho dos dados postados for maior que post_max_size então as variáveis
        <link linkend="language.variables.superglobals">superglobals</link>
        <varname>$_POST</varname> e <varname>$_FILES</varname>
        ficarão vazias. Isto pode ser observado de várias maneiras, por exemplo, passando uma
        variável <varname>$_GET</varname> ao script que processará os dados,
        por exemplo, <literal>&lt;form action="edit.php?processed=1"&gt;</literal>,
        e então verificando se <varname>$_GET['processed']</varname> está preenchida.
       </simpara>
       <para>
        <note>
         <para>
          O PHP permite sufixos para valores em bytes, incluindo K (kilo), M (mega)
          e G (giga). O PHP fará as conversões automaticamente se você
          utilizar qualquer um destes. Cuidado para não exceder o limite de inteiros sinalizados de 32 bit
          (ao usar versões de 32 bit) uma vez que isso fará o script
          falhar.
         </para>
        </note>
       </para>
       <para>
        <table>
         <title>Changelog de <literal>post_max_size</literal></title>
         <tgroup cols="2">
          <thead>
           <row>
            <entry>&Version;</entry>
            <entry>&Description;</entry>
           </row>
          </thead>
          <tbody>
           <row>
            <entry>5.3.4</entry>
            <entry>
             <parameter>post_max_size</parameter> = 0 não irá desabilitar o limite quando o conteúdo
             for do tipo application/x-www-form-urlencoded ou não esteja registrado no PHP.
            </entry>
           </row>
           <row>
            <entry>5.3.2 , 5.2.12</entry>
            <entry>
             Permite tamanho ilimitado de dados postados ao configurar <parameter>post_max_size</parameter> como 0.
            </entry>
           </row>
          </tbody>
         </tgroup>
        </table>
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.auto-prepend-file">
      <term>
       <parameter>auto_prepend_file</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
        Especifica o nome de um arquivo que é automaticamente analisado
        antes do arquivo principal. O arquivo é incluído como se tivesse sido
        chamado com <function>require</function>, então
        <link linkend="ini.include-path">include_path</link> é utilizado.</para>
       <para>
        O valor especial <literal>none</literal>
        desativa a auto-inclusão.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.auto-append-file">
      <term>
       <parameter>auto_append_file</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
        Especifica o nome de um arquivo que é automaticamente analisado
        depois do arquivo principal. O arquivo é incluído como se tivesse sido
        chamado com <function>require</function>, então
        <link linkend="ini.include-path">include_path</link> é utilizado.</para>
       <para>
        O valor especial <literal>none</literal>
        desativa a auto-inclusão.
        <note>
         <simpara>
          Se o script for terminado com <function>exit</function>,
          então a auto-inclusão <emphasis>não</emphasis> ocorrerá.</simpara>
        </note>
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.default-mimetype">
      <term>
       <parameter>default_mimetype</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
        Por padrão o PHP irá imprimir um media type utilizando o header
        Content-Type. Para desabilitar o envio da codificação configure esta opção como vazio.
       </para>
       <para>
        O padrão interno do PHP é o media type text/html.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.default-charset">
      <term>
       <parameter>default_charset</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
        "UTF-8" é o valor padrão e o valor desta diretiva é utilizado
        como o character set padrão para
        <function>htmlentities</function>,
        <function>html_entity_decode</function> e
        <function>htmlspecialchars</function> se o parâmetro
        <parameter>encoding</parameter> for omitido. O valor de
        <parameter>default_charset</parameter> também será utilizado para configurar o
        character set padrão para as funções <link linkend="book.iconv">iconv</link>
        se as opções de configuração
        <link linkend="ini.iconv.input-encoding"><parameter>iconv.input_encoding</parameter></link>,
        <link linkend="ini.iconv.output-encoding"><parameter>iconv.output_encoding</parameter></link> e
        <link linkend="ini.iconv.internal-encoding"><parameter>iconv.internal_encoding</parameter></link>
        não estiverem definidas, e também para as funções
        <link linkend="book.mbstring">mbstring</link> se as opções de configuração
        <link linkend="ini.mbstring.http-input"><parameter>mbstring.http_input</parameter></link>,
        <link linkend="ini.mbstring.http-output"><parameter>mbstring.http_output</parameter></link> e
        <link linkend="ini.mbstring.internal-encoding"><parameter>mbstring.internal_encoding</parameter></link>
        não estiverem definidas.
       </para>
       <para>
        Todas as versões do PHP usarão este valor como o charset no
        header padrão Content-Type enviado pelo PHP caso o header não seja sobrescrito
        por uma chamada à função <function>header</function>.
       </para>
       <para>
        Configurar <parameter>default_charset</parameter> para um valor vazio
        não é recomendado.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.input-encoding">
      <term>
       <parameter>input_encoding</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
        Esta configuração é utilizada por módulos multibyte
        como mbstring e iconv. O padrão é vazio.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.output-encoding">
      <term>
       <parameter>output_encoding</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
        Esta configuração é utilizada por módulos multibyte
        como mbstring e iconv. O padrão é vazio.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.internal-encoding">
      <term>
       <parameter>internal_encoding</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
        Esta configuração é utilizada por módulos multibyte
        como mbstring e iconv. O padrão é vazio. Se vazio,
        <link linkend="ini.default-charset">default_charset</link> é utilizado.
       </para>
      </listitem>
     </varlistentry>

    </variablelist>
   </para>
  </section>

  <section xml:id="ini.sect.path-directory">
   <title>Caminhos e Diretórios</title>
   <para>
    <table>
     <title>Caminhos e Opções de Configuração de Diretórios</title>
     <tgroup cols="4">
      <thead>
       <row>
        <entry>&Name;</entry>
        <entry>&Default;</entry>
        <entry>&Changeable;</entry>
        <entry>&Changelog;</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry><link linkend="ini.include-path">include_path</link></entry>
        <entry>".;/path/to/php/pear"</entry>
        <entry><constant>INI_ALL</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.open-basedir">open_basedir</link></entry>
        <entry>NULL</entry>
        <entry><constant>INI_ALL</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.doc-root">doc_root</link></entry>
        <entry>NULL</entry>
        <entry><constant>INI_SYSTEM</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.user-dir">user_dir</link></entry>
        <entry>NULL</entry>
        <entry><constant>INI_SYSTEM</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.user-ini.cache-ttl">user_ini.cache_ttl</link></entry>
        <entry>"300"</entry>
        <entry><constant>INI_SYSTEM</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.user-ini.filename">user_ini.filename</link></entry>
        <entry>".user.ini"</entry>
        <entry><constant>INI_SYSTEM</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.extension-dir">extension_dir</link></entry>
        <entry>"/path/to/php"</entry>
        <entry><constant>INI_SYSTEM</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.extension">extension</link></entry>
        <entry>NULL</entry>
        <entry>Apenas no &php.ini;</entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.zend-extension">zend_extension</link></entry>
        <entry>NULL</entry>
        <entry>Apenas no &php.ini;</entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.cgi.check-shebang-line">cgi.check_shebang_line</link></entry>
        <entry>"1"</entry>
        <entry><constant>INI_SYSTEM</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.cgi.discard-path">cgi.discard_path</link></entry>
        <entry>"0"</entry>
        <entry><constant>INI_SYSTEM</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.cgi.fix-pathinfo">cgi.fix_pathinfo</link></entry>
        <entry>"1"</entry>
        <entry><constant>INI_SYSTEM</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.cgi.force-redirect">cgi.force_redirect</link></entry>
        <entry>"1"</entry>
        <entry><constant>INI_SYSTEM</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.cgi.nph">cgi.nph</link></entry>
        <entry>"0"</entry>
        <entry><constant>INI_SYSTEM</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.cgi.redirect-status-env">cgi.redirect_status_env</link></entry>
        <entry>NULL</entry>
        <entry><constant>INI_SYSTEM</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.cgi.rfc2616-headers">cgi.rfc2616_headers</link></entry>
        <entry>"0"</entry>
        <entry><constant>INI_ALL</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.fastcgi.impersonate">fastcgi.impersonate</link></entry>
        <entry>"0"</entry>
        <entry><constant>INI_SYSTEM</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.fastcgi.logging">fastcgi.logging</link></entry>
        <entry>"1"</entry>
        <entry><constant>INI_SYSTEM</constant></entry>
        <entry></entry>
       </row>
      </tbody>
     </tgroup>
    </table>
   </para>

   &ini.descriptions.title;

   <para>
    <variablelist>
     <varlistentry xml:id="ini.include-path">
      <term>
       <parameter>include_path</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
        Especifica uma lista de diretórios onde as funções
        <function>require</function>, <function>include</function>,
        <function>fopen</function>, <function>file</function>,
        <function>readfile</function> e <function>file_get_contents</function>
        procuram por arquivos. O formato é como a variável de ambiente
        <envar>PATH</envar>: uma lista de diretórios
        separados por dois pontos no Unix ou ponto e vírgula no Windows.
       </para>
       <para>
        O PHP considera cada item no include_path separadamente ao procurar por
        arquivos para incluir. Ele irá verificar o primeiro caminho, e se não o encontrar,
        verificar o próximo caminho, até que encontre o arquivo incluído ou
        retorne com um
        <constant>E_WARNING</constant>
        ou um <constant>E_ERROR</constant>.
        Você pode modificar ou configurar o include_path em tempo de execução usando
        <function>set_include_path</function>.
       </para>
       <para>
        <example>
         <title>include_path no Unix</title>
         <programlisting role="php.ini">
<![CDATA[
include_path=".:/php/includes"
]]>
         </programlisting>
        </example>
       </para>
       <para>
        <example>
         <title>include_path no Windows</title>
         <programlisting role="php.ini">
<![CDATA[
include_path=".;c:\php\includes"
]]>
         </programlisting>
        </example>
       </para>
       <para>
        Utilizar um <literal>.</literal> no include_path permite
        inclusões relativas ao diretório atual. Entretanto
        é mais eficiente utilizar explicitamente <literal>include
        './file'</literal> em vez de fazer o PHP sempre procurar no diretório
        atual a cada inclusão.
       </para>
       <note>
        <para>
         Variáveis <literal>ENV</literal> também estão acessíveis em arquivos .ini.
         Assim é possível referenciar o diretório home utilizando
         <literal>${LOGIN}</literal> e <literal>${USER}</literal>.
        </para>
        <para>
         Variáveis de ambiente podem variar entre APIs de servidor já que esses ambientes
         podem ser diferentes.
        </para>
       </note>
       <para>
        <example>
         <title>include_path do Unix utilizando a variável de ambiente ${USER}</title>
         <programlisting role="php.ini">
<![CDATA[
include_path = ".:${USER}/pear/php"
]]>
         </programlisting>
        </example>
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.open-basedir">
      <term>
       <parameter>open_basedir</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
        Limita os arquivos que podem ser acessados pelo PHP à árvore de diretório
        especificada, incluindo o próprio arquivo.
       </para>
       <para>
        Quando um script tenta acessar o sistema de arquivos, por exemplo utilizando
        <function>include</function> ou <function>fopen</function>, a localização do arquivo
        é verificada.
        Quando o arquivo está fora da árvore de diretório especificada, o PHP se recusará a acessá-lo.
        Todos os links simbólicos são resolvidos, então não é possível evitar esta restrição
        com um link simbólico. Se o arquivo não existe então o link simbólico não pode ser
        resolvido e o nome do arquivo é comparado a um <option>open_basedir</option> (resolvido).
       </para>
       <para>
        <option>open_basedir</option> pode afetar mais que apenas as funções de sistema de arquivos; por exemplo,
        se o <literal>MySQL</literal> está configurado para utilizar os drivers <literal>mysqlnd</literal>,
        <literal>LOAD DATA INFILE</literal> será afetado por <option>open_basedir</option>.
        Grande parte da funcionalidade extendida do PHP utiliza <literal>open_basedir</literal> desta maneira.
       </para>
       <para>
        O valor especial <systemitem class="filesystem">.</systemitem>
        indica que o diretório atual do script será utilizado como o
        diretório base. Isto é, no entanto, perigoso pois o diretório atual
        do script pode ser facilmente alterado com <function>chdir</function>.
       </para>
       <para>
        No <filename>httpd.conf</filename> <option>open_basedir</option> pode ser desabilitada
        (por exemplo, em alguns hosts virtuais)
        <link linkend="configuration.changes.apache">da mesma forma</link> que
        quaisquer outras diretivas de configuração com "<literal>php_admin_value open_basedir
        none</literal>".
       </para>
       <para>
        No Windows os diretórios são separados com um ponto e vírgula. Em todos
        os outros sistemas os diretórios são separados com dois pontos. Como um
        módulo Apache os caminhos de <option>open_basedir</option> de diretórios pai agora são
        automaticamente herdados.
       </para>
       <para>
        A restrição especificada com <option>open_basedir</option> é um
        nome de diretório, não um prefixo.
       </para>
       <para>
        O padrão é permitir que todos os arquivos sejam abertos.
       </para>
       <note>
        <para>
         open_basedir pode ser restringido em tempo de execução. Isto significa
         que se open_basedir é configurado para <literal>/www/</literal> no &php.ini;
         então um script pode restringir a configuração para
         <literal>/www/tmp/</literal> em tempo de execução com
         <function>ini_set</function>. Ao listar vários diretórios é
         possível utilizar a constante <constant>PATH_SEPARATOR</constant> como um separador
         independentemente do sistema operacional.
        </para>
       </note>
       <note>
        <para>
         O uso da diretiva open_basedir definirá <link linkend="ini.realpath-cache-size">realpath_cache_size</link>
         como <literal>0</literal> e assim <emphasis>desabilitará</emphasis> o cache do caminho real.
        </para>
       </note>
       <caution>
        <para>
         <literal>open_basedir</literal> é rede de segurança extra, mas não é uma proteção
         total, e portanto não deve-se depender para garantir a segurança.
        </para>
       </caution>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.doc-root">
      <term>
       <parameter>doc_root</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
        O "diretório raiz" do PHP no servidor. Utilizado apenas
        se estiver informado.
        Se o PHP não foi compilado com FORCE_REDIRECT, você <emphasis>deve
        </emphasis> configurar doc_root se estiver rodando o PHP em modo CGI em qualquer
        servidor web (diferente do IIS). A alternativa é utilizar a configuração
        <link linkend="ini.cgi.force-redirect">
         cgi.force_redirect</link> abaixo.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.user-ini.cache-ttl">
      <term>
       <parameter>user_ini.cache_ttl</parameter>
       <type>int</type>
      </term>
      <listitem>
       <para>
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.user-ini.filename">
      <term>
       <parameter>user_ini.filename</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.user-dir">
      <term>
       <parameter>user_dir</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
        O nome base do diretório utilizado como diretório home do usuário pelos
        arquivos do PHP, por exemplo <filename class="directory">public_html
        </filename>.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.extension-dir">
      <term>
       <parameter>extension_dir</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
        O diretório no qual o PHP deve procurar por extensões carregadas
        dinamicamente. É recomendado especificar um caminho absoluto. Veja também: <link linkend="ini.enable-dl">enable_dl</link>
        e <function>dl</function>.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.extension">
      <term>
       <parameter>extension</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
        Quais extensões carregáveis dinamicamente carregar quando o PHP inicia.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.zend-extension">
      <term>
       <parameter>zend_extension</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
        Nome da extensão Zend carregável dinamicamente (por exemplo,
        XDebug) a carregar quando o PHP inicia.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.cgi.check-shebang-line">
      <term>
       <parameter>cgi.check_shebang_line</parameter>
       <type>bool</type>
      </term>
      <listitem>
       <para>
        Controla se o PHP <acronym>CGI</acronym> verifica linhas iniciando
        com <literal>#!</literal> (shebang) no início do script em execução.
        Esta linha pode ser necessária se o script suporta execução tanto como
        script autônomo e via PHP <acronym>CGI</acronym>. O PHP em modo
        <acronym>CGI</acronym> pula esta linha e ignora seu conteúdo se
        esta diretiva estiver habilitada.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.cgi.discard-path">
      <term>
       <parameter>cgi.discard_path</parameter>
       <type>bool</type>
      </term>
      <listitem>
       <para>
        Se habilitada, o binário PHP CGI pode ser colocado com segurança fora
        da árvore de diretório web e não será possível contornar a segurança .htaccess.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.cgi.fix-pathinfo">
      <term>
       <parameter>cgi.fix_pathinfo</parameter>
       <type>bool</type>
      </term>
      <listitem>
       <para>
        Fornece suporte <emphasis>real</emphasis> a <literal>PATH_INFO</literal>/
        <literal>PATH_TRANSLATED</literal> para <acronym>CGI</acronym>.
        O comportamento anterior do PHP era definir <literal>PATH_TRANSLATED</literal>
        como <literal>SCRIPT_FILENAME</literal> e não perceber o que <literal>
        PATH_INFO</literal> é. Para mais informações sobre
        <literal>PATH_INFO</literal>, veja as especificações do modo <acronym>CGI</acronym>.
        Configurar esta diretiva para <literal>1</literal> fará o modo
        <acronym>CGI</acronym> corrigir seus caminhos para obedecer à especificação.
        Configurar com zero faz o PHP se comportar como antes. Ela é habilitada por
        padrão. Você deve corrigir seus scripts de forma a usar
        <literal>SCRIPT_FILENAME</literal> ao invés de
        <literal>PATH_TRANSLATED</literal>.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.cgi.force-redirect">
      <term>
       <parameter>cgi.force_redirect</parameter>
       <type>bool</type>
      </term>
      <listitem>
       <para>
        cgi.force_redirect é necessário para prover segurança ao rodar o PHP em modo
        <acronym>CGI</acronym> na maioria dos servidores web. Se deixada indefinida, o PHP
        irá habilitá-la por padrão. Você pode desabilitá-la <emphasis>por sua conta e
        risco</emphasis>.
       </para>
       <note>
        <para>
         Usuários do Windows: Ao utilizar o IIS esta opção <emphasis>deve</emphasis>
         ser desabilitada. O mesmo vale para servidores OmniHTTPD e Xitami.
        </para>
       </note>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.cgi.nph">
      <term>
       <parameter>cgi.nph</parameter>
       <type>bool</type>
      </term>
      <listitem>
       <para>
        Se cgi.nph estiver habilitada, forçará o CGI a enviar sempre Status: 200 em
        todas as requisições.
        </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.cgi.redirect-status-env">
      <term>
       <parameter>cgi.redirect_status_env</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
        Se cgi.force_redirect estiver habilitada e você não está rodando sob
        servidores web Apache ou Netscape (iPlanet), você <emphasis>pode</emphasis>
        precisar configurar um nome de variável de ambiente que o PHP irá procurar
        para saber que é correto continuar a execução.
       </para>
       <note>
        <para>
         Configurar esta variável <emphasis>pode</emphasis> causar problemas de segurança,
         <emphasis>tenha certeza do que está fazendo antes de alterar</emphasis>.
        </para>
       </note>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.cgi.rfc2616-headers">
      <term>
       <parameter>cgi.rfc2616_headers</parameter>
       <type>int</type>
      </term>
      <listitem>
      <para>
        Indica ao PHP qual o tipo de headers usar ao enviar o código de resposta
        HTTP. Se configurada para 0, o PHP envia um header "Status:" da <link xlink:href="&url.rfc;3875">RFC 3875</link>
        que é suportado pelo Apache e outros servidores web. Quando esta opção
        é configurada para 1, o PHP enviará headers em conformidade com a
        <link xlink:href="&url.rfc;2616">RFC 2616</link>.
       </para>
       <para>
        Se esta opção estiver habilitada e o PHP estiver rodando em um ambiente CGI (por exemplo, PHP-FPM)
        não devem ser utilizados headers de resposta de status HTTP no padrão RFC 2616. Em vez disso,
        deve ser usado o seu equivalente RFC 3875, por exemplo, em vez de header("HTTP/1.0 404 Not found");
        deve ser usado header("Status: 404 Not Found");.
       </para>
       <para>
        Deixe-a configurada para 0 a não ser que saiba exatamente o que está fazendo.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.fastcgi.impersonate">
      <term>
       <parameter>fastcgi.impersonate</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
        O FastCGI rodando no IIS (em sistemas baseados em WINNT) suporta a habilidade de representar
        os tokens de segurança do cliente que faz a requisição. Isso permite ao IIS definir o
        contexto de segurança no qual a requisição executa. O mod_fastcgi rodando no Apache
        atualmente não suporta esta funcionalidade (17/03/2002)
        Configure para 1 ao rodar no ISS. O padrão é zero.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.fastcgi.logging">
      <term>
       <parameter>fastcgi.logging</parameter>
       <type>bool</type>
      </term>
      <listitem>
       <para>
        Ativa o logging do SAPI ao utilizar o FastCGI. O padrão é
        habilitar o logging.
       </para>
      </listitem>
     </varlistentry>

    </variablelist>
   </para>
  </section>

  <section xml:id="ini.sect.file-uploads">
   <title>Upload de Arquivos</title>
   <para>
    <table>
     <title>Opções de Configurações de Upload de Arquivos</title>
     <tgroup cols="4">
      <thead>
       <row>
        <entry>&Name;</entry>
        <entry>&Default;</entry>
        <entry>&Changeable;</entry>
        <entry>&Changelog;</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry><link linkend="ini.file-uploads">file_uploads</link></entry>
        <entry>"1"</entry>
        <entry><constant>INI_SYSTEM</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.upload-tmp-dir">upload_tmp_dir</link></entry>
        <entry>NULL</entry>
        <entry><constant>INI_SYSTEM</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.max-input-nesting-level">max_input_nesting_level</link></entry>
        <entry>64</entry>
        <entry><constant>INI_PERDIR</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.max-input-vars">max_input_vars</link></entry>
        <entry>1000</entry>
        <entry><constant>INI_PERDIR</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.upload-max-filesize">upload_max_filesize</link></entry>
        <entry>"2M"</entry>
        <entry><constant>INI_PERDIR</constant></entry>
        <entry></entry>
       </row>
       <row>
        <entry><link linkend="ini.max-file-uploads">max_file_uploads</link></entry>
        <entry>20</entry>
        <entry><constant>INI_PERDIR</constant></entry>
        <entry></entry>
       </row>
      </tbody>
     </tgroup>
    </table>
   </para>

   &ini.descriptions.title;

   <para>
    <variablelist>
     <varlistentry xml:id="ini.file-uploads">
      <term>
       <parameter>file_uploads</parameter>
       <type>bool</type>
      </term>
      <listitem>
       <para>
        Permite ou não
        <link linkend="features.file-upload">upload de arquivos</link> através do HTTP. Veja também as diretivas
        <link linkend="ini.upload-max-filesize">upload_max_filesize</link>,
        <link linkend="ini.upload-tmp-dir">upload_tmp_dir</link> e
        <link linkend="ini.post-max-size">post_max_size</link>.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.upload-tmp-dir">
      <term>
       <parameter>upload_tmp_dir</parameter>
       <type>string</type>
      </term>
      <listitem>
       <para>
        O diretório temporário utilizado para armazenar arquivos durante o
        upload. Precisa ter permissão de escrita para qualquer usuário que o PHP
        esteja usando para rodar. Se não especificado o PHP usará o padrão do sistema.
       </para>
       <para>
        Se o diretório especificado aqui não tiver permissão de escrita, o PHP tenta o
        diretório temporário padrão do sistema. Se
        <link linkend="ini.open-basedir">open_basedir</link> estiver habilitado, então
        o diretório padrão do sistema deve ser permitido para que o upload
        tenha sucesso.
       </para>
      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.upload-max-filesize">
      <term>
       <parameter>upload_max_filesize</parameter>
       <type>int</type>
      </term>
      <listitem>
       <para>
        O tamanho máximo de um arquivo enviado.
       </para>
       <para>
        <link linkend="ini.post-max-size">post_max_size</link> precisa ser maior que esse valor.
       </para>

       &ini.shorthandbytes;

      </listitem>
     </varlistentry>

     <varlistentry xml:id="ini.max-file-uploads">
      <term>
       <parameter>max_file_uploads</parameter>
       <type>int</type>
      </term>
      <listitem>
       <para>
        O número máximo de arquivos permitidos simultaneamente durante um upload.
        Campos de upload deixados em branco no envio não
        contam para este limite.
       </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </section>

  <section xml:id="ini.sect.sql-general">
   <title>SQL Geral</title>
   <para>
    <table>
     <title>Opções de Configurações Gerais de SQL</title>
     <tgroup cols="4">
      <thead>
       <row>
        <entry>&Name;</entry>
        <entry>&Default;</entry>
        <entry>&Changeable;</entry>
        <entry>&Changelog;</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry><link linkend="ini.sql.safe-mode">sql.safe_mode</link></entry>
        <entry>"0"</entry>
        <entry><constant>INI_SYSTEM</constant></entry>
        <entry>Removido no PHP 7.2.0.</entry>
       </row>
      </tbody>
     </tgroup>
    </table>
   </para>

   &ini.descriptions.title;

   <para>
    <variablelist>
     <varlistentry xml:id="ini.sql.safe-mode">
      <term>
       <parameter>sql.safe_mode</parameter>
       <type>bool</type>
      </term>
      <listitem>
       <para>
        Se habilitada as funções de conexão de bancos de dados que especifiquem valores padrão
        usarão esses valores no lugar de quaisquer argumentos passados pelo usuário. Para detalhes
        sobre os valores padrão, veja a documentação das funções
        de conexão relevantes.
       </para>
       <warning>
        <simpara>
         Este recurso foi <emphasis>REMOVIDO</emphasis> a partir do PHP 7.2.0.
        </simpara>
       </warning>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </section>

  <section xml:id="ini.sect.windows">
   <title>Windows</title>
   <para>
    <table>
     <title>Opções de Configurações Específicas do Windows</title>
     <tgroup cols="4">
      <thead>
       <row>
        <entry>&Name;</entry>
        <entry>&Default;</entry>
        <entry>&Changeable;</entry>
        <entry>&Changelog;</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry><link linkend="ini.windows-show-crt-warning">windows.show_crt_warning</link></entry>
        <entry>"0"</entry>
        <entry><constant>INI_ALL</constant></entry>
        <entry></entry>
       </row>
      </tbody>
     </tgroup>
    </table>
   </para>

   &ini.descriptions.title;

   <para>
    <variablelist>
     <varlistentry xml:id="ini.windows-show-crt-warning">
      <term>
       <parameter>windows.show_crt_warning</parameter>
       <type>bool</type>
      </term>
      <listitem>
       <para>
        Esta diretiva exibe os alertas do CRT do Windows quando habilitada.
       </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </section>

 </section>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->