mirror of
https://github.com/php/doc-pt_br.git
synced 2026-03-23 22:52:12 +01:00
1810 lines
62 KiB
XML
1810 lines
62 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- EN-Revision: a1ab750f296de54d79fe3749d5c9164b0593d803 Maintainer: leonardolara Status: ready --><!-- CREDITS: ae,fibbarth,fabioluciano,rogeriopradoj,adiel,geekcom,rafaelbernard,leonardolara -->
|
|
|
|
<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 a partir do 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><? ?></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><?xml ?></userinput> em linha. Caso contrário,
|
|
pode-se imprimir isto com o PHP, por exemplo <userinput><?php echo '<?xml
|
|
version="1.0"?>'; ?></userinput>. Além disso, se desabilitada, deve ser usada
|
|
a forma extensa da tag de abertura do PHP (<userinput><?php ?></userinput>).
|
|
</para>
|
|
<note>
|
|
<para>
|
|
Esta diretiva não afeta o equivalente
|
|
<userinput><?=</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>
|
|
<simpara>
|
|
Esta diretiva permite que certas funções sejam desabilitadas.
|
|
Ela recebe uma lista de nomes de funções separadas por vírgula.
|
|
A partir do PHP 8.0.0, desabilitar uma função remove sua definição,
|
|
permitindo sua redefinição no nível do usuário.
|
|
Antes do PHP 8.0.0, desabilitar uma função apenas evitava que
|
|
a função fosse chamada.
|
|
</simpara>
|
|
<simpara>
|
|
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.
|
|
</simpara>
|
|
<simpara>
|
|
Esta diretiva deve ser configurada no &php.ini;.
|
|
Ela não pode ser configurada no &httpd.conf;.
|
|
</simpara>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry xml:id="ini.disable-classes">
|
|
<term>
|
|
<parameter>disable_classes</parameter>
|
|
<type>string</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Esta diretiva permite que certas classes sejam desabilitadas.
|
|
Ela recebe uma lista de nomes de classes separadas por vírgula.
|
|
Desabilitar uma classe apenas impede que ela seja instanciada.
|
|
</para>
|
|
<para>
|
|
Somente classes internas podem ser desabilitadas ao usar esta diretiva.
|
|
Classes definidas pelo usuário não são afetadas.
|
|
</para>
|
|
<simpara>
|
|
Esta diretiva deve ser configurada no &php.ini;.
|
|
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) em que as informações do realpath deve ser armazenadas em cache
|
|
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>"&"</entry>
|
|
<entry><constant>INI_ALL</constant></entry>
|
|
<entry></entry>
|
|
</row>
|
|
<row>
|
|
<entry><link linkend="ini.arg-separator.input">arg_separator.input</link></entry>
|
|
<entry>"&"</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 & 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 empacotador de fluxo
|
|
<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><form action="edit.php?processed=1"></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 forem
|
|
utilizados qualquer um destes. Cuidado para não exceder o limite de inteiros com sinal de 32 bits
|
|
(ao usar versões de 32 bits) uma vez que isso fará o script
|
|
falhar.
|
|
</para>
|
|
</note>
|
|
</para>
|
|
<para>
|
|
<table>
|
|
<title>Registro de alterações 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>.
|
|
Pode-se 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>
|
|
<simpara>
|
|
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.
|
|
</simpara>
|
|
<simpara>
|
|
A partir do PHP 8.3.0, <option>open_basedir</option> não aceita mais um
|
|
caminho contendo o diretório superior (<literal>..</literal>) quando
|
|
definido no momento da execução usando <function>ini_set</function>.
|
|
</simpara>
|
|
</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, o doc_root <emphasis>precisa
|
|
</emphasis> ser configurado quando o PHP estiver sendo executado 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. Os scripts devem ser corrigidos 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 executar o PHP em modo
|
|
<acronym>CGI</acronym> na maioria dos servidores web. Se deixada indefinida, o PHP
|
|
irá habilitá-la por padrão. Desabilitá-la é <emphasis>um risco de
|
|
segurança</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 não estiverem sendo executados
|
|
servidores web Apache ou Netscape (iPlanet), <emphasis>pode</emphasis> ser
|
|
necessário 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>deve-se ter certeza do que está sendo feito antes de realizar alterações</emphasis>.
|
|
</para>
|
|
</note>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry xml:id="ini.cgi.rfc2616-headers">
|
|
<term>
|
|
<parameter>cgi.rfc2616_headers</parameter>
|
|
<type>bool</type>
|
|
</term>
|
|
<listitem>
|
|
<para>
|
|
Indica ao PHP qual o tipo de headers usar ao enviar o código de resposta
|
|
HTTP. Se estiver desabilitada, 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
|
|
é habilitada, 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 desabilitada 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>bool</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)
|
|
Habilite ao rodar no ISS. O padrão é desabilitado.
|
|
</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
|
|
-->
|