language-snippets.ent

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9244ee3baa2dec4b68fde272c22f09a2b05a8fdd Maintainer: rafaelbernard Status: wip --><!-- CREDITS: felipe, ae, klaussilveira, fabioluciano, adiel, rafaelbernard, atomotavio -->
<!-- Grande revisão feita até a linha 60 -->
<!ENTITY installation.enabled.disable 'Esta extensão está habilitada por padrão. Ela pode ser desligada utilizando a seguinte opção de compilação: '>

<!-- Not used in EN anymore -->
<!ENTITY changelog.randomseed '<row xmlns="http://docbook.org/ns/docbook"><entry>4.2.0</entry><entry>The random
number generator is seeded automatically.</entry></row>'>

<!ENTITY warn.deprecated.feature-5-3-0.removed-6-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>This feature has been
<emphasis>DEPRECATED</emphasis> as of PHP 5.3.0. Relying on this feature is
highly discouraged.</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-3-0.removed-6-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>This function has been
<emphasis>DEPRECATED</emphasis> as of PHP 5.3.0. Relying on this feature is
highly discouraged.</simpara></warning>'>

<!-- Cautions -->
<!ENTITY caution.cryptographically-insecure '<caution xmlns="http://docbook.org/ns/docbook">
 <para>
  Esta função não gera valores criptograficamente seguros, e <emphasis>não deve</emphasis>
  ser usada para propósitos criptográficos, ou propósitos que exigem que os valores retornados sejam impossíveis de adivinhar.
 </para>
 <para>
  Se for necessária aleatoriedade criptograficamente segura, a classe <classname>Random\Randomizer</classname> deve ser
  usado com o motor <classname>Random\Engine\Secure</classname>. Para casos de uso simples, a função <function>random_int</function>
  e a função <function>random_bytes</function> fornecem uma conveniente e segura <acronym>API</acronym> que é apoiada pelo
  <acronym>CSPRNG</acronym> do sistema operacional.
 </para>
</caution>'>

<!-- Notes -->

<!ENTITY note.bin-safe '<note xmlns="http://docbook.org/ns/docbook"><simpara>Esta função é
binary-safe.</simpara></note>'>

<!ENTITY note.clearstatcache '<note xmlns="http://docbook.org/ns/docbook"><simpara>Os resultados desta
função são cacheados. Veja <function>clearstatcache</function> para
mais detalhes.</simpara></note>'>

<!ENTITY note.context-support '<note xmlns="http://docbook.org/ns/docbook"><simpara>O suporte ao contexto foi
adicionado no PHP 5.0.0. Para uma descrição de <literal>contextos</literal>,
veja <xref linkend="book.stream"/>.</simpara></note>'>

<!ENTITY note.exec-bg '<note xmlns="http://docbook.org/ns/docbook"><para>Se um programa é iniciado com esta função,
e deseja que ele continue rodando em background, a saída do programa precisa
ser redirecionada para um arquivo ou outro output stream. Se isso não é feito,
o que irá ocorrer é que o PHP ficará esperando até que a execução do programa termine.</para></note>'>

<!ENTITY note.exec-bypass-shell '<note xmlns="http://docbook.org/ns/docbook"><para>No Windows, <function>exec</function>
primeiro tentará iniciar o cmd.exe para lançar o comando. Se desejar iniciar o programa externo sem iniciar o cmd.exe então
utilize <function>proc_open</function> com o parâmetro <parameter>bypass_shell</parameter> informado.</para></note>'>

<!ENTITY note.extractto-windows '<note xmlns="http://docbook.org/ns/docbook"><para>O sistema de arquivos NTFS do Windows
não suporta alguns caracteres em arquivos, nomeadamente <literal>&lt;|&gt;*?":</literal>. Nomes de arquivos que terminem com ponto
também não são suportados. Ao contrário a algumas ferramentas de extração, este método não substitui estes caracteres com
sobrelinha, ao invés disso, falha ao extrair os arquivos.
</para></note>'>

<!ENTITY note.func-callback '<note xmlns="http://docbook.org/ns/docbook"><simpara>Ao invés de um nome de função, um
array contendo uma referência de objeto e ao nome de método também podem ser
fornecidos.</simpara></note>'>

<!ENTITY note.func-callback-exceptions '<note xmlns="http://docbook.org/ns/docbook"><para>Callbacks registrados
com funções como <function>call_user_func</function> e <function>call_user_func_array</function> não serão
chamados caso haja uma exceção não-pega lançada em um callback anterior.</para></note>'>

<!ENTITY note.funcbyref '<note xmlns="http://docbook.org/ns/docbook"><para>Se os argumentos forem passados por referência,
quaisquer alterações nos argumentos serão refletidas nos valores retornados por esta função. A partir do PHP 7
os valores atuais também serão retornados se os argumentos forem passados por valor.</para></note>'>

<!ENTITY note.funcnoparam '<note xmlns="http://docbook.org/ns/docbook"><para>Devido a esta função depender
do escopo atual para definir os detalhes dos parâmetros, ela não pode ser usada
como o parâmetro de uma função em versões anteriores a 5.3.0. Se este valor precisa ser passado, os resultados
devem ser atribuídos para uma variável, e esta variável deve ser re passada.</para></note>'>

<!ENTITY note.func-named-params '<note xmlns="http://docbook.org/ns/docbook"><para>A partir do PHP 8.0.0, a familia de funções func_*()
destina-se a ser mais transparente em relação aos argumentos nomeados,
tratando os argumentos como se fossem todos passados posicionalmente,
e os argumentos ausentes são substituídos por seus padrões.
Esta função ignora a coleção de argumentos variádicos nomeados desconhecidos.
Argumentos nomeados desconhecidos que são coletados só podem ser acessados por meio do parâmetro variádico.</para></note>'>

<!ENTITY note.line-endings '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Se PHP não está reconhecendo
apropriadamente o separador de linha quando lendo ou criando arquivos em
um computador Macintosh, habilitando a opção
<link linkend="ini.auto-detect-line-endings">auto_detect_line_endings</link>
pode ajudar a resolver o problema.</simpara></note>'>

<!ENTITY note.no-remote '<note xmlns="http://docbook.org/ns/docbook"><simpara>Esta função não funcionar com
<link linkend="features.remote-files">arquivos remotos</link>, de forma que o arquivo
a ser examinado precisa ser acessível pelo sistema de arquivos do servidor.</simpara></note>'>

<!ENTITY note.not-bin-safe '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Esta função
(ainda) não é compatível com dados binários!</simpara></warning>'>

<!ENTITY note.no-key-association '<note xmlns="http://docbook.org/ns/docbook"><simpara>Esta função
define novas chaves para os elementos no <parameter>array</parameter>.
Ela irá remover quaisquer chaves pré existentes, ao invés
de simplesmente reordenar as chaves.</simpara></note>'>

<!ENTITY note.no-windows '<note xmlns="http://docbook.org/ns/docbook"><simpara>esta função não é
implementada na plataforma Windows</simpara></note>'>

<!ENTITY note.no-windows.extension '<note xmlns="http://docbook.org/ns/docbook"><simpara>Esta extensão não está
disponível na plataforma Windows.</simpara></note>'>

<!ENTITY note.no-zts '<note xmlns="http://docbook.org/ns/docbook"><simpara>Esta função não está
disponível em interpretadores PHP compilados com ZTS (Zend Thread Safety) habilita. Para verificar se sua cópia do PHP está com o ZTS ativo, utilize <command>php -i</command> ou verifique a constante <constant>PHP_ZTS</constant>.</simpara></note>'>

<!ENTITY note.randomseed '<note xmlns="http://docbook.org/ns/docbook"><simpara>Não é necessário
semear o gerador de números aleatórios com <function>srand</function> ou
<function>mt_srand</function>, já que isso é realizado automaticamente.
</simpara></note>'>

<!ENTITY note.is-superglobal "<note xmlns='http://docbook.org/ns/docbook'><para>Esta é uma 'superglobal', ou
variável global automática. Isto significa que ela está disponível em
todos escopos pelo script. Não há necessidade de fazer
<command>global $variable;</command> para acessá-la dentro de uma função ou método.
</para></note>">

<!ENTITY note.uses-ob '<note xmlns="http://docbook.org/ns/docbook"><para>Quando o parâmetro <parameter>return</parameter>
é utilizado, esta função utiliza um buffer interno, de forma que ela não pode ser utilizada dentro de um callback
da função <function>ob_start</function>.</para></note>'>

<!ENTITY note.uses-ob-php70 '<note xmlns="http://docbook.org/ns/docbook"><para>Quando o parâmetro <parameter>return</parameter>
é utulizado, esta função utiliza um buffer interno, antes do PHP 7.1.0, de forma que ela não pode ser dentro de um callback
da função <function>ob_start</function>.</para></note>'>

<!ENTITY note.filesystem-time-res '<note xmlns="http://docbook.org/ns/docbook"><para>Note que a resolução de tempo
pode diferir de um sistema de arquivos para outro.</para></note>'>

<!ENTITY note.reset-index "<note xmlns='http://docbook.org/ns/docbook'>
 <para>
    Redefine o ponteiro interno do array para o primeiro elemento.
 </para>
</note>
">

<!ENTITY note.uses-autoload '<note xmlns="http://docbook.org/ns/docbook">
<para>Esta função vai utilizar qualquer
<link linkend="language.oop5.autoload">autoloader</link> registrado caso a classe não seja conhecida.</para></note>'>

<!ENTITY note.network.header.sapi '<note xmlns="http://docbook.org/ns/docbook">
   <para>
    Headers só serão acessíveis e retornados quando a SAPI que os suporta
    estiver em uso.
   </para>
  </note>
'>

<!ENTITY note.sigchild '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  Se o PHP foi compilado com --enable-sigchild, o retorno dessa função é indefinido.
 </para>
</note>
'>

<!ENTITY note.sort-unstable '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  Se dois itens são comparados como iguais, sua ordenação no array final é indefinidia.
 </para>
</note>
'>

<!-- Tips -->

<!ENTITY tip.fopen-wrapper '<tip xmlns="http://docbook.org/ns/docbook"><simpara>Uma URL pode ser utilizada como
um nome de arquivo se <link linkend="ini.allow-url-fopen"
>fopen wrappers</link> estiver ativo.
Veja <function>fopen</function> para mais detalhes em como especificar
o filename. Veja também the <xref linkend="wrappers"/> para informações sobre
que capacidades cada wrapper tem, notas de uso e
informações sobre variáveis predefinidas
fornecidas.</simpara></tip>'>

<!ENTITY tip.fopen-wrapper.stat '<tip xmlns="http://docbook.org/ns/docbook"><simpara>A partir do PHP 5.0.0, esta função
também pode ser utilizada com <emphasis>alguns</emphasis> wrappers URL. Veja
<xref linkend="wrappers"/> para uma lista de quais wrappers são suportados pela
família de funções <function>stat</function>.</simpara></tip>'>

<!ENTITY tip.ob-capture '<tip xmlns="http://docbook.org/ns/docbook"><simpara>Como toda saída é normalmente
enviada direto para o browser, as <link
linkend="ref.outcontrol">Funções de Controle de Output</link> podem ser utilizadas
para capturar o resultado e guardá-lo em uma
<type>string</type> (por exemplo).</simpara></tip>'>

<!ENTITY tip.userlandnaming '<tip xmlns="http://docbook.org/ns/docbook"><simpara>Veja também o
<xref linkend="userlandnaming" />.</simpara></tip>'>


<!-- Warnings -->

<!ENTITY warn.escapeshell '<warning xmlns="http://docbook.org/ns/docbook"><para>Quando permitindo dados fornecidos
por usuário para ser passado para esta função, utilize
<function>escapeshellarg</function> ou <function>escapeshellcmd</function>
para se certificar que os usuários não tentarão enganar o sistema com
comandos arbitrários.</para></warning>'>

<!ENTITY warn.experimental '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Esta extensão é
<emphasis>EXPERIMENTAL</emphasis>. O comportamento desta extensão — incluindo
o nome de suas funções e qualquer outra documentação sobre esta extensão —
poderá mudar sem aviso em futuras versões do PHP.
Esta extensão deve ser usada por sua própria conta e risco.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta funcionalidade tornou-se
<emphasis>OBSOLETA</emphasis> a partir do PHP 5.3.0. Confiar nesta funcionalidade
é altamente não recomendado.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-3-0.removed-5-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta funcionalidade tornou-se
<emphasis>OBSOLETA</emphasis> a partir do PHP 5.3.0 e foi <emphasis>REMOVIDA</emphasis>
a partir do PHP 5.4.0.</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-3-0.removed-5-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função tornou-se
<emphasis>OBSOLETA</emphasis> a partir do PHP 5.3.0 e foi <emphasis>REMOVIDA</emphasis> a partir do PHP 5.4.0.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-5-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Este recurso está
<emphasis>OBSOLETO</emphasis> a partir do PHP 5.5.0. Confiar nesta funcionalidade
é altamente não recomendado.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-6-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Este recurso está
<emphasis>OBSOLETO</emphasis> a partir do PHP 5.6.0. Confiar nesta funcionalidade
é altamente não recomendado.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Este recurso está
<emphasis>OBSOLETO</emphasis> a partir do PHP 7.0.0. Depender desse recurso
é altamente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-1-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Este recurso está
<emphasis>OBSOLETO</emphasis> a partir do PHP 7.1.0. Depender desse recurso
é altamente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-1-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função está
<emphasis>OBSOLETA</emphasis> a partir do PHP 7.1.0. Depender dessa função
é altamente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-1-0.removed-7-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função está
<emphasis>OBSOLETA</emphasis> a partir do PHP 7.1.0 e foi
<emphasis>REMOVIDA</emphasis> a partir do PHP 7.2.0. Depender dessa função
é altamente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Este recurso está
<emphasis>OBSOLETO</emphasis> a partir do PHP 7.2.0. Depender desse recurso
é altamente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-2-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Este recurso está
<emphasis>OBSOLETO</emphasis> a partir do PHP 7.1.0 e foi <emphasis>REMOVIDO</emphasis> a partir do PHP 8.0.0. Depender desse recurso
é altamente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função está
<emphasis>OBSOLETA</emphasis> a partir do PHP 7.2.0. Depender dessa função
é altamente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-2-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função está
<emphasis>OBSOLETA</emphasis> a partir do PHP 7.1.0 e foi <emphasis>REMOVIDA</emphasis> a partir do PHP 8.0.0. Depender desse recurso
é altamente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Este recurso está
<emphasis>OBSOLETO</emphasis> a partir do PHP 7.3.0. Depender desse recurso
é altamente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função está
<emphasis>OBSOLETA</emphasis> a partir do PHP 7.3.0. Depender dessa função
é altamente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-3-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função está
<emphasis>OBSOLETA</emphasis> a partir do PHP 7.3.0 e foi <emphasis>REMOVIDA</emphasis> a partir do PHP 8.0.0. Depender dessa função
é altamente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Este recurso está
<emphasis>OBSOLETO</emphasis> a partir do PHP 7.4.0. Depender desse recurso
é altamente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função está
<emphasis>OBSOLETA</emphasis> a partir do PHP 7.4.0. Depender dessa função
é altamente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-4-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função está
<emphasis>OBSOLETA</emphasis> a partir do PHP 7.4.0 e foi <emphasis>REMOVIDA</emphasis> a partir do PHP 8.0.0. Depender dessa função
é altamente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função está
<emphasis>OBSOLETA</emphasis> a partir do PHP 8.0.0. Depender dessa função
é altamente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-1-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função está
<emphasis>OBSOLETA</emphasis> a partir do PHP 8.1.0. Depender dessa função
é altamente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função está
<emphasis>OBSOLETA</emphasis> a partir do PHP 8.2.0. Depender dessa função
é altamente desencorajado.</simpara></warning>'>

<!ENTITY removed.php.future 'Esta funcionalidade obsoleta <emphasis xmlns="http://docbook.org/ns/docbook">será</emphasis>
certamente <emphasis xmlns="http://docbook.org/ns/docbook">removida</emphasis> no futuro.'>

<!ENTITY warn.deprecated.function.removed-5-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função tornou-se
<emphasis>OBSOLETA</emphasis> e foi <emphasis>REMOVIDA</emphasis> a partir do PHP 5.3.0.</simpara></warning>'>

<!ENTITY warn.deprecated.function.removed-5-5-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função está
<emphasis>OBSOLETA</emphasis> e <emphasis>REMOVIDA</emphasis> a partir do PHP 5.5.0.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-5-3-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>Este apelido tornou-se <emphasis>OBSOLETO</emphasis> a partir do PHP 5.3.0. Confiar
neste apelido é altamente não recomendado.</simpara></warning>'>

<!ENTITY warn.deprecated.func-5-4-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>Esta função tornou-se <emphasis>OBSOLETA</emphasis> a partir do PHP 5.4.0. Confiar
nesta função é altamente não recomendado.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-5-4-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>Este apelido tornou-se <emphasis>OBSOLETO</emphasis> a partir do PHP 5.4.0. Confiar
neste apelido é altamente não recomendado.</simpara></warning>'>

<!ENTITY warn.deprecated.func-5-5-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>Esta função está <emphasis>OBSOLETA</emphasis> a partir do PHP 5.5.0. Confirar
nessa função é altamente não recomendado.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-5-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Este recurso está
<emphasis>OBSOLETO</emphasis> a partir do PHP 5.5.0, e <emphasis>REMOVIDO</emphasis> a partir do PHP 7.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-5-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Está função está
<emphasis>OBSOLETA</emphasis> a partir do PHP 5.5.0, e <emphasis>REMOVIDA</emphasis> a partir do PHP 7.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.function-4-1-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função está
<emphasis>OBSOLETA</emphasis> a partir do PHP 4.1.0, e <emphasis>REMOVIDA</emphasis> a partir do PHP 7.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-3-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função está
<emphasis>OBSOLETA</emphasis> a partir do PHP 5.3.0, e <emphasis>REMOVIDA</emphasis> a partir do PHP 7.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-5-3-0.removed-7-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Esse alias está
<emphasis>OBSOLETO</emphasis> a partir do PHP 5.3.0, e <emphasis>REMOVIDO</emphasis> a partir do PHP 7.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-6-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Este recurso está
<emphasis>OBSOLETO</emphasis> a partir do PHP 5.6.0, e
<emphasis>REMOVIDO</emphasis> a partir do PHP 7.0.0.</simpara></warning>'>

<!ENTITY warn.removed.function-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função foi
<emphasis>REMOVIDA</emphasis> a partir do PHP 7.0.0.</simpara></warning>'>

<!ENTITY warn.removed.function-7-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função foi
<emphasis>REMOVIDA</emphasis> a partir do PHP 7.4.0.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-7-2-0.removed-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Este apelido está
<emphasis>OBSOLETO</emphasis> a partir do PHP 7.2.0, e <emphasis>REMOVIDO</emphasis> a partir do PHP 8.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-7-4-0.removed-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Este apelido está
<emphasis>OBSOLETO</emphasis> a partir do PHP 7.4.0, e <emphasis>REMOVIDO</emphasis> a partir do PHP 8.0.0.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Este apelido está
<emphasis>OBSOLETO</emphasis> a partir do PHP 8.0.0.</simpara></warning>'>

<!ENTITY warn.removed.alias-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Este apelido está
<emphasis>REMOVIDO</emphasis> a partir do PHP 8.0.0.</simpara></warning>'>

<!ENTITY warn.experimental.func '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Esta função é
<emphasis>EXPERIMENTAL</emphasis>. O comportamento, seu nome e
documentação podem mudar sem aviso em futuras versões do PHP.
Utilize por sua própria conta e risco.
</simpara></warning>'>

<!ENTITY warn.imaprecodeyaz '<warning xmlns="http://docbook.org/ns/docbook"><simpara>As extensões <link
linkend="book.imap">IMAP</link>, <link linkend="book.recode">recode</link> e
<link linkend="book.yaz">YAZ</link>
não podem ser utilizadas em paralelo por conterem
símbolos internos de mesmo nome. Yaz 2.0 e superiores não sofrem deste problema.</simpara></warning>'>

<!ENTITY warn.install.cgi '<warning xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Um servidor implantado em modo CGI está aberto
 para várias vulnerabilidades possíveis. Por favor, leia nossa
 <link xmlns="http://docbook.org/ns/docbook" linkend="security.cgi-bin">seção de segurança CGI</link> para aprender em como
 se defender de tais ataques.</para></warning>'>

<!ENTITY warn.passwordhashing '
<warning xmlns="http://docbook.org/ns/docbook">
 <para>
  Não é recomendado o uso desta função em segurança de senhas
  como benefício da velocidade de seu algoritmo de hash. Veja em
  <link linkend="faq.passwords.fasthash">Gerando hash seguro de senha</link>
  por detalhes e melhores práticas.
 </para>
</warning>
'>

<!ENTITY warn.ssl-non-standard '<warning xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Quando usando SSL, o Microsoft IIS
 irá violar o protocolo fechando a conexão sem enviar uma notificação
 <literal>close_notify</literal>. O PHP acusará isso como sendo "SSL: Fatal
 Protocol Error" quando tentar ler os dados. Para prevenir isso, o valor de
 <link linkend="ini.error-reporting">error_reporting</link> deve ser
 reduzido para um nível que não inclui avisos.
 para o nível que não emita warnings.
 O PHP pode detectar servidores IIS defeituosos quando você abre
 um stream utilizando o wrapper <literal>https://</literal> e suprimirá os avisos.
 Se você está usando <function>fsockopen</function> para criar um socket
 <literal>ssl://</literal>, a responsabilidade de detectar e suprimir esse aviso é do desenvolvedor.</para></warning>'>

<!ENTITY warn.undocumented.class '
<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Esta classe não está documentada. Somente a lista de duas propriedades
  está disponível.
 </simpara>
</warning>
'>

<!ENTITY warn.undocumented.func '<warning xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Esta função
 não está documentada; somente a lista de argumentos está disponível.
 </simpara></warning>'>


<!-- Deprecation and removal warnings designed for use with a list of
     alternatives. See en/reference/regex/functions/ereg.xml and
     en/reference/regex/reference.xml for examples of these in action. -->

<!ENTITY warn.deprecated.function.4-1-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Esta função está <emphasis>OBSOLETA</emphasis> no PHP 4.1.0 e foi
 <emphasis>REMOVIDA</emphasis> no PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternativas a esta função incluem:
</para>
'>

<!ENTITY warn.deprecated.feature.5-3-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Esta função está <emphasis>OBSOLETA</emphasis> no PHP 5.3.0 e foi
 <emphasis>REMOVIDA</emphasis> no PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternativas a esta função incluem:
</para>
'>

<!ENTITY warn.deprecated.function.5-3-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Esta função está <emphasis>OBSOLETA</emphasis> no PHP 5.3.0 e foi
 <emphasis>REMOVIDA</emphasis> no PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternativas a esta função incluem:
</para>
'>

<!ENTITY warn.deprecated.function.5-5-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Esta função está <emphasis>OBSOLETA</emphasis> no PHP 5.5.0 e foi
 <emphasis>REMOVIDA</emphasis> no PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternativas a esta função incluem:
</para>
'>

<!ENTITY warn.removed.feature.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Este recurso foi <emphasis>REMOVIDO</emphasis> no PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternativas a esta função incluem:
</para>
'>

<!ENTITY warn.removed.function.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Esta função foi <emphasis>REMOVIDA</emphasis> no PHP 7.0.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternativas a esta função incluem:
</para>
'>

<!ENTITY warn.deprecated.feature.7-1-0.removed.7-2-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Este recurso foi <emphasis>OBSOLETO</emphasis> no PHP 7.1.0. e
 <emphasis>REMOVIDO</emphasis> no PHP 7.2.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternativas a este recurso incluem:
</para>
'>

<!ENTITY warn.deprecated.function.7-1-0.removed.7-2-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Esta função foi <emphasis>OBSOLETA</emphasis> no PHP 7.1.0. e
 <emphasis>REMOVIDA</emphasis> no PHP 7.2.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternativas a esta função incluem:
</para>
'>

<!-- Misc -->

<!ENTITY version.exists.asof 'Isto existe a partir do PHP '>

<!ENTITY version.trunk.after.53 '<emphasis xmlns="http://docbook.org/ns/docbook">Esta alteração
existe na <link linkend="about.phpversions">versão de desenvolvimento</link> do PHP, e provavelmente
irá existir após o 5.3.</emphasis>'>

<!ENTITY version.trunk.changelog 'Futuro'>

<!ENTITY no.function.parameters '<para xmlns="http://docbook.org/ns/docbook">Esta função não possui parâmetros.</para>'>

<!ENTITY example.outputs '<para xmlns="http://docbook.org/ns/docbook">O exemplo acima irá imprimir:</para>'>

<!ENTITY example.outputs.5 '<para xmlns="http://docbook.org/ns/docbook">O exemplo acima irá imprimir no PHP 5:</para>'>

<!ENTITY example.outputs.53 '<para xmlns="http://docbook.org/ns/docbook">O exemplo acima irá imprimir no PHP 5.3:</para>'>

<!ENTITY example.outputs.54 '<para xmlns="http://docbook.org/ns/docbook">O exemplo acima irá imprimir no PHP 5.4:</para>'>

<!ENTITY example.outputs.55 '<para xmlns="http://docbook.org/ns/docbook">O exemplo acima irá imprimir no PHP 5.5:</para>'>

<!ENTITY example.outputs.56 '<para xmlns="http://docbook.org/ns/docbook">O exemplo acima irá imprimir no PHP 5.6:</para>'>

<!ENTITY example.outputs.7 '<para xmlns="http://docbook.org/ns/docbook">O exemplo acima irá imprimir no PHP 7:</para>'>

<!ENTITY example.outputs.71 '<para xmlns="http://docbook.org/ns/docbook">O exemplo acima irá imprimir no PHP 7.1:</para>'>

<!ENTITY example.outputs.80 '<para xmlns="http://docbook.org/ns/docbook">O exemplo acima irá imprimir no PHP 8.0:</para>'>

<!ENTITY example.outputs.81 '<para xmlns="http://docbook.org/ns/docbook">O exemplo acima irá imprimir no PHP 8.1:</para>'>

<!ENTITY example.outputs.82 '<para xmlns="http://docbook.org/ns/docbook">O exemplo acima irá imprimir no PHP 8.2:</para>'>

<!ENTITY example.outputs.82.similar '<para xmlns="http://docbook.org/ns/docbook">O exemplo acima irá imprimir no PHP 8.2 algo similar à:</para>'>

<!ENTITY example.outputs.32bit '<para xmlns="http://docbook.org/ns/docbook">O exemplo acima irá imprimir em máquinas 32 bit:</para>'>

<!ENTITY example.outputs.64bit '<para xmlns="http://docbook.org/ns/docbook">O exemplo acima irá imprimir em máquinas 64 bit:</para>'>

<!ENTITY example.outputs.similar '<para xmlns="http://docbook.org/ns/docbook">O exemplo acima irá imprimir
algo similar à:</para>'>

<!ENTITY examples.outputs '<para xmlns="http://docbook.org/ns/docbook">Os exemplos acima irão imprimir:</para>'>

<!ENTITY examples.outputs.32bit '<para xmlns="http://docbook.org/ns/docbook">Os exemplos acima irão imprimir em máquinas 32 bit:</para>'>

<!ENTITY examples.outputs.64bit '<para xmlns="http://docbook.org/ns/docbook">Os exemplos acima irão imprimir em máquinas 64 bit:</para>'>

<!ENTITY examples.outputs.similar '<para xmlns="http://docbook.org/ns/docbook">Os exemplos acima irão imprimir
algo similar à:</para>'>

<!ENTITY array.resetspointer '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Esta função irá
 <function xmlns="http://docbook.org/ns/docbook">resetar</function> o ponteiro do <type xmlns="http://docbook.org/ns/docbook">array</type> depois
 do uso.</simpara></note>'>

<!ENTITY array.changelog.by-ref '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Se o <parameter>callback</parameter> espera que um parâmetro seja passado
  por referência, esta função agora emitirá um <constant>E_WARNING</constant>.
 </entry>
</row>'>

<!ENTITY array.changelog.require-only-one '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.0.0</entry>
  <entry>
  Esta função agora pode ser chamada com apenas um parâmetro.
  Anteriormente, pelo menos dois parâmetros eram necessários.
  </entry>
</row>'>

<!ENTITY seealso.array.sorting 'A <link xmlns="http://docbook.org/ns/docbook" linkend="array.sorting">comparação de funções de organização de array</link>'>

<!ENTITY seealso.callback 'informação sobre o tipo <type xmlns="http://docbook.org/ns/docbook">callback</type>'>

<!ENTITY ini.shorthandbytes '<simpara xmlns="http://docbook.org/ns/docbook">Quando um <type xmlns="http://docbook.org/ns/docbook">integer</type> é utilizado, o
 valor é medido em bytes. A resumida notação, como descrito
 <link xmlns="http://docbook.org/ns/docbook" linkend="faq.using.shorthandbytes">neste FAQ</link>, pode também ser usada.
 </simpara>'>

<!ENTITY info.deprecated.alias 'Para compatibilidade com versões anteriores, o seguinte
 apelido obsoleto pode ser usado: '>

<!ENTITY info.function.alias 'Esta função é um apelido para: '>

<!ENTITY info.method.alias 'Este método é um apelido para: '>

<!ENTITY info.function.alias.deprecated '<simpara xmlns="http://docbook.org/ns/docbook">Esta função é um apelido obsoleto
 e apenas existe para razão em manter a compatibilidade com versões anteriores. É
 recomendado não usar esta função já que um dia ela deve ser removida do
 PHP.</simpara>'>

<!ENTITY ext.windows.path.dll 'Para esta extensão funcionar, existem arquivos
 <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym> que devem estar disponíveis no
 <literal xmlns="http://docbook.org/ns/docbook">PATH</literal> do sistema Windows. Para saber como fazer isso,
 veja o <acronym xmlns="http://docbook.org/ns/docbook">FAQ</acronym> intitulado "<link
 linkend="faq.installation.addtopath" xmlns="http://docbook.org/ns/docbook">Como eu adiciono o meu diretório PHP no PATH
 no Windows</link>". Embora copiando arquivos DLL
 da pasta do PHP no diretório system do Windows também funcione
 (porque o diretório system está por padrão no <literal xmlns="http://docbook.org/ns/docbook">PATH</literal> do sistema),
 isto não é recomendado.
 <emphasis xmlns="http://docbook.org/ns/docbook">Esta extensão requer que os seguintes arquivos estejam no
 <literal xmlns="http://docbook.org/ns/docbook">PATH</literal>:</emphasis> '>

<!ENTITY manual.migration.seealso 'Veja também o guia de migração para versões do PHP'>

<!ENTITY style.oop 'Estilo orientado à objeto'>
<!ENTITY style.procedural 'Estilo procedural'>

<!ENTITY resource '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.resource">resource</link>'>

<!ENTITY foreach '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.foreach">foreach</link>'>

<!ENTITY yield '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.yield">yield</link>'>

<!ENTITY parameter.context 'Refira a seção do manual <link xmlns="http://docbook.org/ns/docbook" linkend="context">contexto</link>
 para uma descrição de <literal xmlns="http://docbook.org/ns/docbook">contextos</literal>.'>

<!ENTITY parameter.use_include_path 'Quando mdefinido como &true;, o nome do arquivo também
 é procurado no <link xmlns="http://docbook.org/ns/docbook" linkend="ini.include-path">include_path</link>'>

<!-- Returns -->

<!ENTITY return.falseforfailure ' ou &false; em caso de falha'>
<!ENTITY return.falseforfailure.style.procedural '&style.procedural; retorna &false; em caso de falha.'>

<!ENTITY return.success 'Retorna &true; em caso de sucesso ou &false; em caso de falha.'>

<!ENTITY return.void 'Não há valor retornado.'>

<!ENTITY return.callbacksort 'A função de comparação precisa retornar um inteiro menor, igual, ou maior que zero caso o primeiro argumento seja considerado respectivamente maior, igual ou maior que o segundo.
Note que antes do PHP 7.0.0 este inteiro tinha de estar no intervalo de -2147483648 a 2147483647.'>

<!ENTITY return.falseproblem '<warning xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Esta função pode
 retornar o booleano &false;, mas também pode retornar um valor não-booleano que pode ser
 avaliado como &false;, como <literal xmlns="http://docbook.org/ns/docbook">0</literal> ou
 &quot;&quot;. Leia a seção em <link
 linkend="language.types.boolean">Booleanos</link> para maiores
 informações. Utilize o <link xmlns="http://docbook.org/ns/docbook" linkend="language.operators.comparison">operador ===
 </link> para testar o valor retornado por esta função.</simpara></warning>'>

<!-- Standard -->
<!ENTITY standard.changelog.calling-on-objects '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Chamando esta função em &object;s está obsoleto.
  Ou use <function>get_mangled_object_vars</function> no &object; primeiro, ou use <classname>ArrayIterator</classname>.
 </entry>
</row>
'>

<!ENTITY standard.changelog.binary-safe-string-comparison '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.2.0</entry>
 <entry>
  Essa função agora retorna <literal>-1</literal> ou <literal>1</literal>,
  onde anteriormente retornava um número negativo ou positivo.
 </entry>
</row>
'>

<!-- OpenSSL -->
<!ENTITY openssl.param.x509 '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>x509</parameter></term>
 <listitem>
  <para>
   Veja <link linkend="openssl.certparams">Key/parâmetros de certificado</link> para uma lista de valores válidos.
  </para>
 </listitem>
</varlistentry>'>

<!-- Image (GD) Notes -->
<!ENTITY note.config.t1lib '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Esta função somente está disponível
 se o PHP estiver compilado com <option role="configure">--with-t1lib[=DIR]</option>.
</simpara></note>'>

<!ENTITY note.freetype '<note xmlns="http://docbook.org/ns/docbook"><simpara>Esta função somente está disponível se o
PHP estiver compilado com suporte ao freetype (<option role="configure">--with-freetype-dir=DIR</option>)
</simpara></note>'>

<!ENTITY note.gd.notrequired '<note xmlns="http://docbook.org/ns/docbook"><para>Esta função não requer a biblioteca GD.</para></note>'>

<!ENTITY note.gd.interpolation '<note xmlns="http://docbook.org/ns/docbook"><para>Esta função é afetada pela interpolação configurada com <function>imagesetinterpolation</function>.</para></note>'>

<!ENTITY gd.image.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
image</parameter></term><listitem><para>Um resource de imagem, retornado por funções de criação de imagens,
como <function>imagecreatetruecolor</function>.</para></listitem></varlistentry>'>

<!ENTITY gd.font.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term xmlns="http://docbook.org/ns/docbook"><parameter xmlns="http://docbook.org/ns/docbook">
 font</parameter></term><listitem><para xmlns="http://docbook.org/ns/docbook">Pode ser 1, 2, 3, 4, 5 para as fontes
 embutidas na codificação latin2 (aonde números maiores correspondem a fontes mais largas) ou qualquer um dos seus
 própios identificadores de fonte registrado com <function xmlns="http://docbook.org/ns/docbook">imageloadfont</function>.
 </para></listitem></varlistentry>'>

<!ENTITY gd.return.identifier 'Retorna um resource de imagem no sucesso, &false; em erros.'>

<!ENTITY gd.value.red 'Valor do componente vermelho.'>

<!ENTITY gd.value.green 'Valor do componente verde.'>

<!ENTITY gd.value.blue 'Valor do componente azul.'>

<!ENTITY gd.source.height 'Altura da origem.'>

<!ENTITY gd.source.width 'Largura da origem.'>

<!ENTITY gd.image.path 'O caminho ou um resource stream aberto (o qual será automaticamente fechado quando a função retorna) para gravar o arquivo. Se não informado ou &null;, os bytes da imagem serão impressos diretamente.'>

<!ENTITY gd.image.new 'Cria uma nova imagem a partir de arquivo ou URL'>

<!ENTITY gd.image.source 'Recurso imagem origem.'>

<!ENTITY gd.image.destination 'Recurso da imagem destino.'>

<!ENTITY gd.image.output 'Emite a imagem para o navegador ou um arquivo'>

<!ENTITY gd.image.colors 'Se a imagem foi criada a partir de um arquivo, somente as cores utilizadas na imagem são resolvidas. Cores presentes apenas na paleta não serão resolvidas.'>

<!ENTITY gd.font.size 'O tamanho da fonte. Dependendo da sua versão do GD, isto pode ser especificado em pixel (GD1) ou pontos (GD2).'>

<!-- DBM notes -->

<!ENTITY dbm.dbm-identifier.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term xmlns="http://docbook.org/ns/docbook"><parameter xmlns="http://docbook.org/ns/docbook">
 dbm_identifier</parameter></term><listitem><para xmlns="http://docbook.org/ns/docbook">O identificador da conexão DBM,
 retornado por <function xmlns="http://docbook.org/ns/docbook">dbmopen</function>.</para></listitem></varlistentry>'>

<!-- JSON notes -->

<!ENTITY json.implementation.superset '
 <note xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <para>
   O PHP implementa uma extensção do JSON, além do especificado no
   <link xlink:href="&url.rfc;4627">RFC 4627</link> - podendo também codificar
   e decodificar tipos escalares e &null;. RFC 4627 apenas suporta esses valores quando
   eles estão inseridos dentro de um objeto ou array.
  </para>
  <para>
   Embora isso seja consistente com a definição expandida de "texto
   JSON" na nova <link xlink:href="&url.rfc;7159">RFC 7159</link> (que
   pretende susceder RFC 4627) e
   ECMA-404<!-- Removed link to fix the build ~sobak 12/06/2016 -->, isto pode causar
   problemas de interoperabilidade com parsers JSON antigos que aderem estritamente a RFC
   4627 quando decodificando um valor escalar.
  </para>
 </note>
'>

<!-- cURL notes -->

<!ENTITY curl.ch.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>ch</parameter>
</term><listitem><para>Um handle cURL retornado por
<function>curl_init</function>.</para></listitem></varlistentry>'>

<!ENTITY curl.mh.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>mh</parameter>
</term><listitem><para>Um cURL "multi handle" retornado por
<function>curl_multi_init</function>.</para></listitem></varlistentry>'>

 <!-- IMAP notes -->

<!ENTITY imap.imap-stream.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term xmlns="http://docbook.org/ns/docbook"><parameter xmlns="http://docbook.org/ns/docbook">
 imap_stream</parameter></term><listitem><para xmlns="http://docbook.org/ns/docbook">Um stream IMAP retornado por
 <function xmlns="http://docbook.org/ns/docbook">imap_open</function>.</para></listitem></varlistentry>'>

<!ENTITY imap.pattern '<para xmlns="http://docbook.org/ns/docbook">Especifica aonde na hierarquia da
 caixa de mensagens deve começar a procura.</para><para xmlns="http://docbook.org/ns/docbook">Existem dois caracteres especiais que você
 pode passar como parte para o <parameter xmlns="http://docbook.org/ns/docbook">pattern</parameter>:
 &apos;<literal xmlns="http://docbook.org/ns/docbook">*</literal>&apos; e &apos;<literal xmlns="http://docbook.org/ns/docbook">&#37;</literal>&apos;.
 &apos;<literal xmlns="http://docbook.org/ns/docbook">*</literal>&apos; significa retornar todas as caixas de mensagens. Se você passar
 <parameter xmlns="http://docbook.org/ns/docbook">pattern</parameter> como &apos;<literal xmlns="http://docbook.org/ns/docbook">*</literal>&apos;, você terá
 uma lista de toda a hierarquia da caixa de mensagens.
 &apos;<literal xmlns="http://docbook.org/ns/docbook">&#37;</literal>&apos;
 significa retornar o nível atual apenas.
 &apos;<literal xmlns="http://docbook.org/ns/docbook">&#37;</literal>&apos; como o parâmetro <parameter xmlns="http://docbook.org/ns/docbook">pattern</parameter>
 ira retornar apenas as caixar de mensagem do nível superior;
 &apos;<literal xmlns="http://docbook.org/ns/docbook">~/mail/&#37;</literal>&apos; em <literal xmlns="http://docbook.org/ns/docbook">UW_IMAPD</literal> irá retornar cada caixa de mensagem no diretório <filename xmlns="http://docbook.org/ns/docbook">~/mail</filename>, mais nenhuma em subpastas deste diretório.</para>'>

<!-- intl notes -->

<!ENTITY intl.codepoint.parameter '<para xmlns="http://docbook.org/ns/docbook">Um codepoint <type>integer</type> (por exemplo <literal>0x2603</literal> para <emphasis>U+2603 SNOWMAN</emphasis>), ou um caracter codificado como uma  <type>string</type> UTF-8 (exemplo <literal>"\u{2603}"</literal>)</para>'>

<!ENTITY intl.codepoint.return '<para xmlns="http://docbook.org/ns/docbook">O tipo retornado é <type>integer</type> a não ser que o codepoint seja passado como uma <type>string</type> UTF-8, e nesse caso uma <type>string</type> é retornada. Retorna &null; em falha.</para>'>

<!ENTITY intl.codepoint.example 'Testando codepoints diferentes'>

<!ENTITY intl.property.parameter '<para xmlns="http://docbook.org/ns/docbook">A propriedade Unicode a inspecionar (constantes <literal>IntlChar::PROPERTY_*</literal>).</para>'>

<!ENTITY intl.property.example 'Testando propriedades diferentes'>

<!ENTITY ldap.return-result-array 'Returns an <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname> instance, an array of <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname> instances,&return.falseforfailure;.'>

<!ENTITY ldap.return-result-array-info '<para xmlns="http://docbook.org/ns/docbook">Também é possível realizar buscas paralelas. Neste caso, o primeiro argumento deve ser um array de
<classname>LDAP\Connection</classname> instâncias, em vez de uma única.
Se as pesquisas não devem usar a mesma base DN e filtro, um array de base DNs e/ou um array de filtros podem ser passados como argumentos.
Esses arrays devem ter o mesmo tamanho que o <classname>LDAP\Connection</classname> array de instâncias,
já que as primeiras entradas dos arrays são usadas para uma pesquisa, as segundas entradas são usadas para outra, e assim por diante.
Ao fazer pesquisas paralelas, um array de <classname>LDAP\Result</classname> instâncias é retornado, exceto em caso de erro, quando o valor de retorno será &false;.</para>'>

<!-- mbstring notes -->

<!ENTITY note.mbstring.encoding.internal '<note xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">A codificação interna ou a
codificação de caractere especificado por <function xmlns="http://docbook.org/ns/docbook">mb_regex_encoding</function>
será usado como a codificação de caractere para esta função.</para></note>'>

<!ENTITY note.mbstring.encoding.current '<note xmlns="http://docbook.org/ns/docbook"><para>A
codificação de caracteres especificada por <function>mb_regex_encoding</function>
será utilizada como a codificação de caracter por essa função automaticamente..</para></note>'>

<!ENTITY mbstring.encoding.parameter '<para xmlns="http://docbook.org/ns/docbook">O parâmetro <parameter xmlns="http://docbook.org/ns/docbook">encoding</parameter>
é a codificação de caractere. Se ele é omitido, o valor da codificação de caractere interna
é usado.</para>'>

<!ENTITY mbstring.warning.e-modifier '<warning xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Jamais use o modificador <literal xmlns="http://docbook.org/ns/docbook">e</literal> ao usar com entrada não confiavel. Não será escapado automaticamente (como conhecido da função <function xmlns="http://docbook.org/ns/docbook">preg_replace</function>). Não ter cuidado com isso irá provavelmente criar vulnerabilidades de execução remota de código na sua aplicação.</para></warning>'>

<!-- mcrypt notes -->

<!ENTITY mcrypt.parameter.cipher '<para xmlns="http://docbook.org/ns/docbook">Uma das constantes <constant>MCRYPT_ciphername</constant>, ou o nome do algoritmo como string.</para>'>

<!ENTITY mcrypt.parameter.iv '<para xmlns="http://docbook.org/ns/docbook">Utilizado para a inicialização dos modos CBC, CFB, OFB, e em alguns algoritmos em modo STREAM. Se você não fornecer um IV necessário a algum algoritmo a função lançará um warning e utilizará um IV com todos os bytes com valor "<literal>\0</literal>".</para>'>

<!ENTITY mcrypt.parameter.iv.strict '<para xmlns="http://docbook.org/ns/docbook">Utilizado para a inicialização dos modos CBC, CFB, OFB, e em alguns algoritmos em modo STREAM. Se o tamanho do IV fornecido não for surportado no modo chaining ou um IV não for fornecido para um modo chaining que necessite, a função emitirá um warning e refornará &false;.</para>'>

<!ENTITY mcrypt.parameter.mode '<para xmlns="http://docbook.org/ns/docbook">Uma das constantes <constant>MCRYPT_MODE_modename</constant>, ou uma das strings: "ecb", "cbc", "cfb", "ofb", "nofb" ou "stream".</para>'>

 <!-- MCVE notes -->

<!ENTITY mcve.conn.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term xmlns="http://docbook.org/ns/docbook"><parameter xmlns="http://docbook.org/ns/docbook">
 conn</parameter></term><listitem><para xmlns="http://docbook.org/ns/docbook">Um recurso MCVE_CONN retornado por
 <function xmlns="http://docbook.org/ns/docbook">m_initengine</function>.</para></listitem></varlistentry>'>

<!-- memcached notes -->

<!ENTITY memcached.note.delete-time '<note xmlns="http://docbook.org/ns/docbook"><simpara>
       A partir do memcached 1.3.0 (lançado em 2009) esse recurso não é mais
       suportado. Passando um <parameter>tempo</parameter> diferente de zero vai ocasionar
       a exlusão a falhar. <methodname>Memcached::getResultCode</methodname>
       vai retornar <constant>MEMCACHED_INVALID_ARGUMENTS</constant>.
      </simpara></note>
'>

<!ENTITY memcached.parameter.expiration 'O tempo de expiração, padrão é 0. Veja <link
 linkend="memcached.expiration" xmlns="http://docbook.org/ns/docbook">Tempos de Expiração</link> para maiores informações.'>

<!ENTITY memcached.parameter.server_key 'A chave identificando o servidor onde armazenar ou recuperar o valor. Em vez de fazer o hash do item, é feito o hash da chave do servidor quando decidindo com qual servidor memcached conectar. Isto permite que itens relacionados sejam agrupados em um único servidor para maior eficiência de operações múltiplas.'>

<!ENTITY memcached.parameter.items 'Um array de pares chave/valor para guardar no servidor.'>

<!ENTITY memcached.parameter.key 'A chave sobre a qual guardar o valor.'>

<!ENTITY memcached.parameter.value 'O valor para guardar.'>

<!ENTITY memcached.result.getresultcode 'Use <methodname xmlns="http://docbook.org/ns/docbook">Memcached::getResultCode</methodname> se necessário.'>

<!ENTITY memcached.result.delete-multi '<para xmlns="http://docbook.org/ns/docbook">
   Retorna um array indexado por <parameter>chaves</parameter>. Cada elemento
   é &true; se a chave correspondente foi deletada, ou uma das
   constantes <constant>Memcached::RES_*</constant> se a exclusão correspondente
   falhar.
   </para>
  <para xmlns="http://docbook.org/ns/docbook">
   O <methodname>Memcached::getResultCode</methodname> vai retornar
   o código de resultado para a última operação de exclusão executada, isto é, a operação de
   exclusão para o último elemento de <parameter>chaves</parameter>.
  </para>
'>

<!-- password notes -->

<!ENTITY password.parameter.algo 'Uma <link xmlns="http://docbook.org/ns/docbook" linkend="password.constants">constante de algoritmo de senha</link> indicando qual algoritmo utilizar no hash de senha.'>

<!ENTITY password.parameter.hash 'Um hash criado por <function xmlns="http://docbook.org/ns/docbook">password_hash</function>.'>

<!ENTITY password.parameter.options 'Um array associativo contendo opções. Veja as <link xmlns="http://docbook.org/ns/docbook" linkend="password.constants">constantes de algoritmo de senha</link> sobre detalhes das opções suportadas por cada algoritmo.'>

<!ENTITY password.parameter.password 'A senha do usuário.'>

<!-- geaman notes -->

<!ENTITY gearman.parameter.host 'O nome do servidor.'>

<!ENTITY gearman.parameter.port 'A porta do servidor.'>

<!ENTITY gearman.parameter.functionname 'Uma função registrada a executar'>

<!ENTITY gearman.parameter.workload 'Dados serializados a processar'>

<!ENTITY gearman.parameter.data 'Dados adicionais que podem ser necessários para completar o serviço'>

<!ENTITY gearman.parameter.context 'Contexto da aplicação associado à tarefa'>

<!ENTITY gearman.parameter.unique 'Um identificador único da tarefa'>

<!ENTITY gearman.parameter.jobhandle 'O manipulador do job associado no servidor Gearman'>

<!-- Date and time entities -->
<!ENTITY date.timezone.intro.title '<title xmlns="http://docbook.org/ns/docbook">Lista de Fusos Horários Suportados</title>'>

<!ENTITY date.timezone.intro "<para xmlns='http://docbook.org/ns/docbook'>
Aqui você encontrará a lista completa de timezones suportados no PHP, os quais
poder ser utilizados em <function>date_default_timezone_set</function> e afins.
<caution><simpara>O comportamento dos timezones não listados aqui é indefinido.</simpara></caution>
</para><note xmlns='http://docbook.org/ns/docbook'><simpara>A versão mais recente do banco de timezones pode ser
instalado através do pacote PECL <link xlink:href='&url.pecl.package.get;timezonedb' xmlns:xlink='http://www.w3.org/1999/xlink'>timezonedb</link>.
</simpara></note>">

<!ENTITY date.timezone.bc '<simpara xmlns="http://docbook.org/ns/docbook">Por favor não use nenhuma dos fusos horários
listados aqui (exceto o UTC), pois elas existem apenas para compatibilidade retroativa, e podem ter comportamento errôneo.
</simpara>'>

<!ENTITY date.timezone.posix-signs '<simpara xmlns="http://docbook.org/ns/docbook">
 Se você desconsiderar o aviso acima note que o banco de dados fusos horários
 IANA que o PHP fornece utiliza sinais estilo
 POSIX, que resulta nas time zones <literal>Etc/GMT+n</literal>
 <literal>Etc/GMT-n</literal> acabarem invertidas do uso comum.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
 Por exemplo, fusos horários 8 horas a frente do GMT, utilizada na China e
 Austrália Oeste (entre outros lugares) está marcada como
 <literal>Etc/GMT-8</literal> no banco de dados, e não como
 <literal>Etc/GMT+8</literal> normalmente se espera.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
 Novamente, é fortemente recomendado que você utilizae a time zone
 correta da sua locação, como <literal>Asia/Shanghai</literal> ou
 <literal>Australia/Perth</literal> nos exemplos acima.
</simpara>'>

<!ENTITY date.timezone.abbrev-volatile '<simpara xmlns="http://docbook.org/ns/docbook">
Essas abreviações de timezone devem ser consideradas voláteis, ou seja, elas
podem variar de significado entre as versões do timezonedb, e portanto não podem ser confiáveis.
Recomenda-se evitar essas abreviações de timezone.
</simpara>'>

<!ENTITY date.timezone.errors.description '<para xmlns="http://docbook.org/ns/docbook">
Todas as chamadas a funções de data/hora gerarão um <constant>E_NOTICE</constant>
se o fuso horário não for válido, e/ou uma mensagem <constant>E_STRICT</constant>
ou <constant>E_WARNING</constant>
se utilizar as configurações do sistema ou a variável de ambiente
<varname>TZ</varname>. Veja também <function>date_default_timezone_set</function></para>'>

<!ENTITY date.timezone.errors.changelog '<row xmlns="http://docbook.org/ns/docbook"><entry>5.1.0</entry><entry><para>
Agora lança erros <constant>E_STRICT</constant> e <constant>E_NOTICE</constant>
.</para></entry></row>'>

<!ENTITY date.timestamp.description '
 <varlistentry xmlns="http://docbook.org/ns/docbook"><term xmlns="http://docbook.org/ns/docbook"><parameter xmlns="http://docbook.org/ns/docbook">timestamp</parameter></term><listitem><para xmlns="http://docbook.org/ns/docbook">
 O parâmetro opcional <parameter xmlns="http://docbook.org/ns/docbook">timestamp</parameter> é um
 <type xmlns="http://docbook.org/ns/docbook">integer</type> Unix timestamp cujo padrão é a hora local
 se <parameter xmlns="http://docbook.org/ns/docbook">timestamp</parameter> não for informado. Em outras
 palavras, o padrão é o valor da função <function xmlns="http://docbook.org/ns/docbook">time</function>.</para></listitem></varlistentry>'>

<!-- RNP -->

<!ENTITY rnp.parameter.ffi-description 'O objeto FFI retornado por rnp_ffi_create.'>

<!ENTITY rnp.parameter.key-format 'O formato chave dos dados (GPG, KBX, G10).'>

<!ENTITY rnp.parameter.loadsave-flags 'Veja RNP_LOAD_SAVE_* descrição das bandeiras.'>

<!ENTITY date.datetime.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term xmlns="http://docbook.org/ns/docbook"><parameter xmlns="http://docbook.org/ns/docbook">
object</parameter></term><listitem><para xmlns="http://docbook.org/ns/docbook">Somente estilo procedural: Um objeto <classname xmlns="http://docbook.org/ns/docbook">DateTime</classname>
retornado pela <function xmlns="http://docbook.org/ns/docbook">date_create</function></para></listitem></varlistentry>'>

<!ENTITY date.datetime.description.modified '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>object</parameter></term>
<listitem><para>Somente estilo procedural: Um objeto <classname>DateTime</classname>
returnado por <function>date_create</function>.
A função modifica esse objeto.</para></listitem></varlistentry>'>

<!ENTITY date.datetimezone.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
object</parameter></term><listitem><para>Somente no estilo procedural: Um objeto <classname>DateTimeZone</classname>
retornado por <function>timezone_open</function></para></listitem></varlistentry>'>

<!ENTITY date.datetime.retval.changelog '<row xmlns="http://docbook.org/ns/docbook"><entry>5.3.0</entry><entry>Modificado o valor
retornado de &null; para <classname>DateTime</classname>.</entry></row>'>

<!ENTITY date.datetime.return.modifiedobjectorfalseforfailure 'Retorna o objeto modificado <classname xmlns="http://docbook.org/ns/docbook">DateTime</classname> para encadeamento de métodos&return.falseforfailure;.'>
<!ENTITY date.datetime.return.modifiedobject 'Retorna o objeto modificado <classname xmlns="http://docbook.org/ns/docbook">DateTime</classname> para encadeamento de métodos.'>
<!ENTITY date.datetimeimmutable.return.modifiedobjectorfalseforfailure 'Retorna um novo objeto <classname xmlns="http://docbook.org/ns/docbook">DateTimeImmutable</classname> com os dados modificados &return.falseforfailure;.'>
<!ENTITY date.datetimeimmutable.return.modifiedobject 'Retorna um novo objeto <classname xmlns="http://docbook.org/ns/docbook">DateTimeImmutable</classname> com os dados modificados.'>

<!ENTITY date.timezone.dbversion 'Esta lista depende da versão do banco de dados de fusos horários'>

<!ENTITY date.timezone.africa 'África'>
<!ENTITY date.timezone.america 'América'>
<!ENTITY date.timezone.antarctica 'Antártica'>
<!ENTITY date.timezone.arctic 'Ártico'>
<!ENTITY date.timezone.asia 'Asia'>
<!ENTITY date.timezone.atlantic 'Atlântico'>
<!ENTITY date.timezone.australia 'Australia'>
<!ENTITY date.timezone.europe 'Europa'>
<!ENTITY date.timezone.indian 'Indiano'>
<!ENTITY date.timezone.pacific 'Pacífico'>
<!ENTITY date.timezone.others 'Outros'>
<!ENTITY date.timezone.abbreviations 'Abreviações'>

<!ENTITY date.formats 'Valores válidos são explicados em <link xmlns="http://docbook.org/ns/docbook" linkend="datetime.formats">Formatos de Data e Hora</link>.'>
<!ENTITY date.formats.parameter 'Uma string data/hora. &date.formats;'>

<!-- DomXml Notes -->
<!ENTITY node.inserted 'Este nó não será exibido no documento a não ser
 que ele seja inserido, por exemplo, com <function xmlns="http://docbook.org/ns/docbook">domnode_append_child</function>.'>


<!-- Dom Notes -->
<!ENTITY dom.node.inserted 'Este nó não será exibido no documento a não ser que ele seja inserido, por exemplo, com <link xmlns="http://docbook.org/ns/docbook"
linkend="domnode.appendchild">DOMNode->appendChild()</link>.'>

<!ENTITY dom.allowstatic '<para xmlns="http://docbook.org/ns/docbook">Este método <emphasis>pode</emphasis> ser chamado estaticamente, mas emitirá um erro <constant>E_STRICT</constant>.</para>'>
<!ENTITY dom.malformederror '<para xmlns="http://docbook.org/ns/docbook">Enquanto HTML malformado deve carregar com sucesso, esta função pode gerar erros <constant>E_WARNING</constant> quando encontra marcação ruim. <link linkend="function.libxml-use-internal-errors">libxml&apos;s funções de tratamento de erros</link> pode ser usado para lidar com esses erros.</para>'>
<!ENTITY dom.note.utf8 '<note xmlns="http://docbook.org/ns/docbook"><para>A extensão DOM usa codificação UTF-8. Use <function>mb_convert_encoding</function>, <methodname>UConverter::transcode</methodname>, ou <function>iconv</function> para lidar com outras codificações.</para></note>'>
<!-- Dom Examples -->
<!ENTITY dom.book.example '<para xmlns="http://docbook.org/ns/docbook">Os exemplos a seguir supõem um arquivo <filename>book.xml</filename> com o seguinte conteúdo:</para>
<programlisting role="xml" xmlns="http://docbook.org/ns/docbook">
<!-- Warning: The CDATA markup here is a little tricky. Please DO NOT BREAK it! -->
<![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE books [
  <!ELEMENT books   (book+)>
  <!ELEMENT book    (title, author+, xhtml:blurb?)>
  <!ELEMENT title   (#PCDATA)>
  <!ELEMENT blurb   (#PCDATA)>
  <!ELEMENT author  (#PCDATA)>
  <!ATTLIST books   xmlns        CDATA  #IMPLIED>
  <!ATTLIST books   xmlns:xhtml  CDATA  #IMPLIED>
  <!ATTLIST book    id           ID     #IMPLIED>
  <!ATTLIST author  email        CDATA  #IMPLIED>
]>
<?xml-stylesheet type="text/xsl" href="style.xsl"?>
<books xmlns="http://books.php/" xmlns:xhtml="http://www.w3.org/1999/xhtml">
  <book id="php-basics">
    <title>PHP Basics</title>
    <author email="jim.smith@basics.php">Jim Smith</author>
    <author email="jane.smith@basics.php">Jane Smith</author>
    <xhtml:blurb><![CDATA[
<p><em>PHP Basics</em> provides an introduction to PHP.</p>
]]]]><![CDATA[></xhtml:blurb>
  </book>
  <book id="php-advanced">
    <title>PHP Advanced Programming</title>
    <author email="jon.doe@advanced.php">Jon Doe</author>
  </book>
</books>
]]></programlisting>'>


<!-- FileSystem entities -->
<!ENTITY fs.emits.warning.on.failure '<para xmlns="http://docbook.org/ns/docbook">
Em caso de falha um <constant>E_WARNING</constant> será emitido.
</para>'>

<!ENTITY fs.validfp.all '<para xmlns="http://docbook.org/ns/docbook">O ponteiro de arquivo precisa ser válido, e apontar para
um arquivo aberto por <function>fopen</function> ou
<function>fsockopen</function> (e ainda não fechado por
<function>fclose</function>).</para>'>

<!ENTITY fs.file.pointer '<para xmlns="http://docbook.org/ns/docbook">Um ponteiro de arquivo tipo <type>resource</type>
tipicamente criado por <function>fopen</function>.</para>'>

<!ENTITY fs.file.32bit '<note xmlns="http://docbook.org/ns/docbook"><simpara>
    Por conta do tipo inteiro do PHP ser sinalizado em muitas plataformas de 32bits,
    algumas funções de arquivos podem retornar resultados inesperados para arquivos
    maiores que 2GB.
   </simpara></note>'>

<!ENTITY ini.scanner.typed '<para xmlns="http://docbook.org/ns/docbook">
    A partir do PHP 5.6.1 também pode ser especificado <constant>INI_SCANNER_TYPED</constant>.
    Nesse modo os tipos boolean, null e inteiro são preservados quando possível.
    Valores string <literal>"true"</literal>, <literal>"on"</literal> e <literal>"yes"</literal>
    são convertidos para &true;. <literal>"false"</literal>, <literal>"off"</literal>, <literal>"no"</literal>
    e <literal>"none"</literal> são considerados &false;. <literal>"null"</literal> é convertido para &null;
    no modo tipado. Além disso todas as strings numéricas são convertidas para inteiros, se possível.
   </para>'>

<!-- GNUPG -->
<!ENTITY gnupg.identifier '<para xmlns="http://docbook.org/ns/docbook">O identificador gnupg, obtido de uma chamada à
<function xmlns="http://docbook.org/ns/docbook">gnupg_init</function> ou <classname xmlns="http://docbook.org/ns/docbook">gnupg</classname>.</para>'>

<!ENTITY gnupg.fingerprint '<para xmlns="http://docbook.org/ns/docbook">A chave de fingerprint.</para>'>

<!-- HaruDoc -->
<!ENTITY haru.error '<para xmlns="http://docbook.org/ns/docbook">Lança uma <classname xmlns="http://docbook.org/ns/docbook">HaruException</classname> em erros.</para>'>

<!-- ODBC -->
<!ENTITY odbc.connection.id '<para xmlns="http://docbook.org/ns/docbook">O identificador de conexão ODBC,
veja <function xmlns="http://docbook.org/ns/docbook">odbc_connect</function> para detalhes.</para>'>

<!ENTITY odbc.parameter.search 'Este parâmetro aceita os padrões seguintes:
"&#x25;" para casar zero ou mais caracteres e "_" para casar um único caracter.'>

<!-- OAUTH -->
<!ENTITY oauth.callback.error 'Emite um erro de nível <constant xmlns="http://docbook.org/ns/docbook">E_ERROR</constant>
se a função callback não puder ser chamada ou não tiver sido especificada.'>

<!ENTITY oauth.changelog.error.null 'Previamente retornava &null; em falhas, em vez de &false;.'>

<!-- Oracle -->
<!ENTITY oci.db "<para xmlns='http://docbook.org/ns/docbook' xmlns:xlink='http://www.w3.org/1999/xlink'>Contém
uma <literal>Oracle instance</literal> a conectar. Isso pode ser
uma <link xlink:href='&url.oracle.oic.connect;'>Easy Connect
string</link> ou num Connect Name
de um arquivo <filename>tnsnames.ora</filename>, ou ainda o nome de uma instância
local Oracle.
</para>
<para xmlns='http://docbook.org/ns/docbook'>Se não especificado o PHP utilizará
variáveis de ambiente como <constant>TWO_TASK</constant> (no Linux)
ou <constant>LOCAL</constant> (no Windows)
e <constant>ORACLE_SID</constant> para determinar a
<literal>Oracle instance</literal> a conectar.
</para>
<para xmlns='http://docbook.org/ns/docbook'>
Para utilizar o método via Easy Connect, o PHP precisa ter sido compilado com as bibliotecas cliente Oracle
10<emphasis>g</emphasis> ou maiores. Uma string Easy Connect para o Oracle
10<emphasis>g</emphasis> tem a forma:
<emphasis>[//]host_name[:port][/service_name]</emphasis>. Do Oracle
11<emphasis>g</emphasis> a sintaxe é:
<emphasis>[//]host_name[:port][/service_name][:server_type][/instance_name]</emphasis>.
Nomes de serviço podem ser encontrados ao rodar o utilitário
Oracle <literal>lsnrctl status</literal> na máquina servidora
do banco de dados.
</para>
<para xmlns='http://docbook.org/ns/docbook'>
O arquivo <filename>tnsnames.ora</filename> pode estar em um Oracle Net
search path, que
inclui <filename>$ORACLE_HOME/network/admin</filename>
e <filename>/etc</filename>. Alternativamente é possível
configurar<literal>TNS_ADMIN</literal> de forma
que <filename>$TNS_ADMIN/tnsnames.ora</filename> seja encontrado. Tenha certeza
que o servidor web tem acesso de escrita nesse arquivo.
</para>">

<!ENTITY oci.charset "<para xmlns='http://docbook.org/ns/docbook'>Determina
o conjunto de caracteres utilizado pelas bibliotecas Oracle Client. O conjunto de
caracteres não precisa bater com o utilizado pelo banco de dados. Se
eles não baterem, o Oracle fará a melhor conversão possível dos dados de e para
o conjunto de caracteres do banco de dados. Dependendo dos charsets isso pode ocasionar
dados não utilizáveis. Conversão também aumenta o processamento.
</para>
<para xmlns='http://docbook.org/ns/docbook'>Se não especificado, as
bibliotecas Oracle Client determinam o charset da variável de ambiente
<constant>NLS_LANG</constant>.
</para>
<para xmlns='http://docbook.org/ns/docbook'>Passar esse parâmetro pode
reduzir o tempo necessário a conexão.
</para>">

<!ENTITY oci.sessionmode '<para xmlns="http://docbook.org/ns/docbook">Este
parâmetro está disponível a partir do PHP 5 (PECL OCI8 1.1) e aceita os seguintes
valores: <constant>OCI_DEFAULT</constant>,
<constant>OCI_SYSOPER</constant> e <constant>OCI_SYSDBA</constant>.
Caso esteja especificado <constant>OCI_SYSOPER</constant> ou
<constant>OCI_SYSDBA</constant>, esta função tentará
estabelecer uma conexão privilegiada utilizando credenciais externas.
Conexões privilegiadas estão desativadas por padrão. Para ativá-las é preciso
configurar <link linkend="ini.oci8.privileged-connect">oci8.privileged_connect</link>
para <literal>On</literal>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
O PHP 5.3 (PECL OCI8 1.3.4) introduziu o valor
<constant>OCI_CRED_EXT</constant>. Isso informa o Oracle para utilizar
autenticação External ou OS, que precisa ser configurado no banco
de dados. A flag <constant>OCI_CRED_EXT</constant> somente pode ser utilizado
com o usuário &quot;/&quot; e uma senha em branco.
<link linkend="ini.oci8.privileged-connect">oci8.privileged_connect</link>
pode estar <literal>On</literal> ou <literal>Off</literal>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
<constant>OCI_CRED_EXT</constant> pode ser combinado com
<constant>OCI_SYSOPER</constant> ou
<constant>OCI_SYSDBA</constant>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
<constant>OCI_CRED_EXT</constant> não é suportado no Windows por
razões de segurança.
</para>'>

<!ENTITY oci.datatypes '<para xmlns="http://docbook.org/ns/docbook">Para detalhes no mapeamento de dados realizado
pela extenção OCI8 extension veja <link linkend="oci8.datatypes">tipos
suportados pelo driver</link>.</para>'>

<!ENTITY oci.parameter.connection '<para xmlns="http://docbook.org/ns/docbook">Um indentificador de conexção Oracle,
retornado por <function>oci_connect</function>, <function>oci_pconnect</function>,
ou <function>oci_new_connect</function>.</para>'>

<!ENTITY oci.availability.note.10g '<note xmlns="http://docbook.org/ns/docbook"><title>Versão Oracle mínima</title>
<para>Esta função somente está disponível no PHP linkado com Oracle a
partir da versão 10g em diante.</para></note>'>

<!ENTITY oci.clientinfo.tip '<tip xmlns="http://docbook.org/ns/docbook"><title>Performance</title><para>Com versões anteriores do
OCI8 ou do Oracle Database, as informações do cliente podem ser configurados utilizando o pacote Oracle
<literal>DBMS_APPLICATION_INFO</literal>. Isto é menos eficiente que
utilizar <function>oci_set_client_info</function>.</para></tip>'>

<!ENTITY oci.roundtrip.caution '<caution xmlns="http://docbook.org/ns/docbook"><title>Roundtrip Gotcha</title>
<para>Algumas funções OCI8 causam roundtrips. Roundtrips para
o banco podem não ocorrer quando cache de resultados está ativado.
</para></caution>'>

<!ENTITY oci.use.setprefetch '<para xmlns="http://docbook.org/ns/docbook">Para
queries retornado um grande número de linhas a performance pode ser
melhorada significantemente
aumentando-se <link linkend="ini.oci8.default-prefetch">oci8.default_prefetch</link>
ou utilizando <function>oci_set_prefetch</function>.
</para>'>


<!ENTITY oci.arg.statement.id
"<para xmlns='http://docbook.org/ns/docbook'>Uma identificação de instrução OCI8
válida, criada por<function>oci_parse</function> e executada
por <function>oci_execute</function>, ou ainda um identificador de <literal>REF
CURSOR</literal>.</para>">

<!-- PCNTL Notes -->
<!ENTITY pcntl.parameter.status '<para xmlns="http://docbook.org/ns/docbook">O parâmetro <parameter xmlns="http://docbook.org/ns/docbook">status</parameter> é o
 parâmetro de status fornecido para uma chamada com sucesso
 a <function xmlns="http://docbook.org/ns/docbook">pcntl_waitpid</function>.</para>'>

<!-- PS Notes -->
<!ENTITY ps.note.visible '<para xmlns="http://docbook.org/ns/docbook">A nota não será visível se o documento
 for impresso ou visualizado mas será mostrado se o documento for convertido para
 para o pdf pelo Acrobat Distiller™ ou Ghostview.</para>'>

<!-- Notes for safe-mode limited functions: -->

<!-- Not used in EN anymore -->
<!ENTITY note.sm.disabled '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">&sm.disabled;</simpara></note>'>

<!-- Not used in EN anymore -->
<!ENTITY note.sm.uidcheck '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Quando o <literal>
safe-mode</literal> está ativo, o PHP verifica se
os arquivo(s) ou diretórios que estão usados na operação tem o mesmo UID (proprietário)
do script que está sendo executado.</simpara></note>'>

<!-- Not used in EN anymore -->
<!ENTITY note.sm.uidcheck.dir '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Quando o <literal>
safe-mode</literal> está ativo, o PHP verifica se
o diretório no qual o script está em operação tem o mesmo UID (proprietário)
do script que está sendo executado.</simpara></note>'>

<!ENTITY note.open-basedir.func '<note xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Esta função é afetada por <link
linkend="ini.open-basedir">open_basedir</link>.</para></note>'>


<!ENTITY note.language-construct '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Este é um
construtor de linguagem e não uma função, por isso não é possível chamá-lo através de
<link xmlns="http://docbook.org/ns/docbook" linkend="functions.variable-functions">funções variáveis</link>, ou <link linkend="functions.named-arguments">argumentos nomeados</link>.</simpara>
</note>'>

<!-- Common pieces in features/safe-mode.xml
     Jade doesn't allow in-line entities, so I put them here... Though they
     should have been inline in safe-mode.xml -->

<!-- Not used in EN anymore -->
<!ENTITY sm.uidcheck 'Checks whether the files or directories being operated
upon have the same UID (owner) as the script that is being executed.'>

<!-- Not used in EN anymore -->
<!ENTITY warn.sm.exec '<warning xmlns="http://docbook.org/ns/docbook"><simpara>With <literal>safe mode</literal> enabled,
the command string is escaped with <function>escapeshellcmd</function>. Thus,
<literal>echo y | echo x</literal> becomes <literal>echo y \| echo x</literal>.</simpara></warning>'>

<!-- Not used in EN anymore -->
<!ENTITY note.exec-path '<note xmlns="http://docbook.org/ns/docbook"><simpara>When
<literal>safe mode</literal> is enabled, you can only
execute files within the <literal>safe_mode_exec_dir</literal>.
For practical reasons, it is currently not allowed to have <literal>..</literal>
components in the path to the executable.</simpara></note>'>

<!-- Not used in EN anymore -->
<!ENTITY sm.uidcheck.dir 'Checks whether the directory in which
the script is operating has the same UID (owner) as the script that is being
executed.'>

<!-- Not used in EN anymore -->
<!ENTITY sm.disabled 'This function is disabled when PHP is running in <literal xmlns="http://docbook.org/ns/docbook">
safe mode</literal>.'>

<!-- Common pieces in partintro-sections -->
<!ENTITY no.config '<para xmlns="http://docbook.org/ns/docbook">Esta extensão não possui diretivas de configuração definíveis no &php.ini;.</para>'>
<!ENTITY no.resource '<para xmlns="http://docbook.org/ns/docbook">Esta extensão não tem recursos definidos.</para>'>
<!ENTITY no.constants '<para xmlns="http://docbook.org/ns/docbook">Esta extensão não possui constantes definidas.</para>'>
<!ENTITY no.requirement '<para xmlns="http://docbook.org/ns/docbook">Esta extensão não necessita de bibliotecas externas para compilar.</para>'>
<!ENTITY no.install '<para xmlns="http://docbook.org/ns/docbook">Esta extensão não necessita de instalação.
Suas funções são parte do núcleo do PHP.</para>'>

<!-- Used in every chapter that has directive descriptions -->
<!ENTITY ini.descriptions.title '<para xmlns="http://docbook.org/ns/docbook">Uma rápida explicação das
diretivas de configuração.</para>'>

<!-- Common pieces for reference part BEGIN-->

<!-- Used in reference/$extname/ini.xml -->
<!ENTITY extension.runtime '<simpara xmlns="http://docbook.org/ns/docbook">
O comportamento dessas funções podem ser modificado pelas configurações do &php.ini;.
</simpara>'>

<!ENTITY ini.php.constants 'Para mais detalhes e definições dos modos
 PHP_INI_*, veja <xref xmlns="http://docbook.org/ns/docbook" linkend="configuration.changes.modes"/>.'>

<!-- Used in reference/$extname/constants.xml -->
<!ENTITY extension.constants '<simpara xmlns="http://docbook.org/ns/docbook">
As contantes abaixo são definidas por esta extensão e somente
 estarão disponíveis quando a extensão foi compilada com o PHP
 ou carregada dinamicamente durante a execução.
</simpara>'>

<!-- For STANDARD Constants used in reference/$extname/constants.xml -->
<!ENTITY extension.constants.core '<simpara xmlns="http://docbook.org/ns/docbook">
As constantes listadas abaixo estão sempre disponíveis como parte do núcleo do PHP.
</simpara>'>

<!-- Used in reference/$extname/classes.xml -->
<!ENTITY extension.classes '<simpara xmlns="http://docbook.org/ns/docbook">
As classes abaixo são definidas por esta extensão e
 somente estarão disponíveis quando a extensão for
 compilada junto com o PHP, ou carregada dinamicamente na execução.
</simpara>'>

<!ENTITY note.extension.php5 '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">
Esta extensão requer o PHP 5.</simpara></note>'>

<!-- PDO entities -->
<!ENTITY pdo.driver-constants '<simpara xmlns="http://docbook.org/ns/docbook">As constantes abaixo são definidas por
 este driver, e somente estarão disponíveis quando esta extensão for compilada no
 PHP ou carregada dinamicamente em tempo de execução. Em adição, estas
 constantes especificas do drive somente devem ser usadas se você estive usando este drive.
 Usar atributos especificos do mysql com o driver postgree pode resultar em
 um funcionamento não esperado. <function xmlns="http://docbook.org/ns/docbook">PDO::getAttribute</function> deve ser usado para
 obter o atributo <constant>PDO_ATTR_DRIVER_NAME</constant> para se certificar do
 driver, se o seu código puder ser usado com vários drivers.</simpara>'>

<!ENTITY pdo.errors.exception-not-errmode '<note xmlns="http://docbook.org/ns/docbook"><simpara>Uma exceção é lançada mesmo quando o atributo <constant>PDO::ATTR_ERRMODE</constant> não está definido para <constant>PDO::ERRMODE_EXCEPTION</constant>.</simpara></note>'>

<!-- PECL entities -->
<!ENTITY pecl.moved 'Esta extensão <link xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl;">PECL</link>
não é distribuída junto com o PHP.'>

<!ENTITY pecl.bundled 'Esta extensão <link xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl;">PECL</link>
é distribuída junto com o PHP.'>

<!ENTITY pecl.info 'Informações para instalar essa extensão PECL pode ser
encontrada no capítulo <link xmlns="http://docbook.org/ns/docbook" linkend="install.pecl">Instalação de
Extensões PECL</link>. Informações adicionais como novas versões,
downloads, arquivos fontes, manutenções e CHANGELOG podem ser
encontrados aqui: '>

<!ENTITY pecl.info.dead 'Esta extensão é considerada não mantida e abandonada. Entretanto seu código fonte
está disponível no <acronym xmlns="http://docbook.org/ns/docbook">SVN</acronym>
<acronym xmlns="http://docbook.org/ns/docbook">PECK</acronym> aqui: '>

<!ENTITY pecl.info.dead.git 'Esta extensão é considerada abondadana e morta. Seus fontes, entretanto,
ainda está disponível no <acronym xmlns="http://docbook.org/ns/docbook">GIT</acronym> do
<acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym>, aqui: '>

<!ENTITY pecl.windows.download 'Uma <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym> para esse extensão
<acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym> não está disponível. Veja também a seção
<link xmlns="http://docbook.org/ns/docbook" linkend="install.windows.building">compilando no Windows</link>.
'>

<!ENTITY pecl.windows.download.unbundled '&pecl.windows.download;'>

<!ENTITY pecl.moved-ver 'Esta extensão foi movida para o repositório
<link xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl;">PECL</link> e não é mais incluída
como parte do PHP.'>

<!-- kept for BC -->
<!ENTITY note.pecl-php5 '<note xmlns="http://docbook.org/ns/docbook"><simpara>
Esta extensão foi removida do PHP 5 e movida para o
<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl;">PECL</link> repository.
</simpara></note>'>

<!-- Common pieces for reference part END -->


<!ENTITY windows.builtin '<simpara xmlns="http://docbook.org/ns/docbook">A versão para Windows do <literal xmlns="http://docbook.org/ns/docbook">PHP</literal>
 tem suporte embutido para esta extensão. Você não precisa carregar nenhuma extensão
 adicional para utilizar essas funções.</simpara>'>

<!-- These are here as helpers for manual consistency and brievety-->
<!ENTITY safemode '<literal xmlns="http://docbook.org/ns/docbook">safe mode</literal>'>

<!ENTITY sqlsafemode '<link xmlns="http://docbook.org/ns/docbook" linkend="ini.sql.safe-mode">Modo seguro de SQL</link>'>

<!-- APD Notes -->
<!ENTITY apd.debug-level.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term xmlns="http://docbook.org/ns/docbook"><parameter xmlns="http://docbook.org/ns/docbook">
 debug_level</parameter></term><listitem><para xmlns="http://docbook.org/ns/docbook">Um interiro que é formado pela adição
 em conjunto das constantes <literal xmlns="http://docbook.org/ns/docbook">XXX_TRACE</literal>.</para><para xmlns="http://docbook.org/ns/docbook">Não é recomendado
 usar <constant>MEMORY_TRACE</constant>. è muito lenta e não parece ser exata.
 <constant>ASSIGNMENT_TRACE</constant> ainda não esta implementada.</para><para xmlns="http://docbook.org/ns/docbook">Para ativar todos
 os traços de funções (TIMING, FUNCTIONS, ARGS SUMMARY (como strace -c)) use o valor 99</para>
 </listitem></varlistentry>'>

<!-- BCMath Notes -->
<!ENTITY bc.scale.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
scale</parameter></term><listitem><para>Este parâmetro opcional é utilizado para configurar o número
de dígitos na parte fracionária do resultado. Se omitido será utilizada a escala padrão
globalmente configurada com a função <function>bcscale</function>, com padrão de fábrica em <literal>0</literal> se
não configurado.</para></listitem></varlistentry>'>

<!-- CTYPE Notes -->
<!ENTITY note.ctype.parameter.integer '<note xmlns="http://docbook.org/ns/docbook"><para>
Se um <type>integer</type> entre -128 e 255, inclusive, é informado então ele é interpretado como
o valor ASCII de um caracter simples (valores negativos tem 256 somados de forma a permitir
caracteres no intervalo Extended ASCII). Qualquer outro valor inteiro é interpretado como uma string
contendo dígitos decimais de um inteiro.</para></note>'>

<!ENTITY note.ctype.parameter.non-string '<warning xmlns="http://docbook.org/ns/docbook"><para>
A partir do PHP 8.1.0, passar um argumento não string está obsoleto.
No futuro, o argumento será interpretado como uma string em vez de um ponto de código ASCII.
Dependendo do comportamento pretendido, o argumento deve ser convertido para &string;
ou uma chamada explícita para <function>chr</function> deve ser feita.</para></warning>'>

<!ENTITY ctype.result.empty-string 'When called with an empty string the result will always be &false;.'>

<!-- FBSQL Notes -->
<!ENTITY fbsql.link-identifier.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
link_identifier</parameter></term><listitem><para>Um identificador de link FrontBase
retornado por<function>fbsql_connect</function> ou
<function>fbsql_pconnect</function>.</para><para>Se opcional e não especificado
a função tentará localizar um link aberto ao um servidor FrontBase e se nenhum
link for encontrado será tentado criar um como se
<function>fbsql_connect</function> fosse chamado sem argumentos.</para>
</listitem></varlistentry>'>

<!ENTITY fbsql.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term xmlns="http://docbook.org/ns/docbook"><parameter xmlns="http://docbook.org/ns/docbook">
 result</parameter></term><listitem><para xmlns="http://docbook.org/ns/docbook">Um identificador de resultado
 retornado por <function xmlns="http://docbook.org/ns/docbook">fbsql_query</function> ou
 <function xmlns="http://docbook.org/ns/docbook">fbsql_db_query</function>.</para></listitem></varlistentry>'>

<!-- GMP Notes -->
<!ENTITY gmp.return 'Um número GMP <type xmlns="http://docbook.org/ns/docbook">resource</type> no PHP 5.5 e anteriores, ou um objeto <classname xmlns="http://docbook.org/ns/docbook">GMP</classname> do PHP 5.6 em diante.'>
<!ENTITY gmp.parameter '<para xmlns="http://docbook.org/ns/docbook">Ele pode ser qualquer número GMP <type xmlns="http://docbook.org/ns/docbook">resource</type>, ou uma string numérica que é possível convertê-la para um número.</para>'>

<!-- MySQLi Notes -->
<!ENTITY mysqli.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
result</parameter></term><listitem><para>Somente no estilo procedural: Um recurso result set
retornado por <function>mysqli_query</function>, <function>mysqli_store_result</function>
ou <function>mysqli_use_result</function>.</para></listitem></varlistentry>'>
<!ENTITY mysqli.link.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
link</parameter></term><listitem><para>Somente no estilo procedural: Um recurso link
retornado por <function>mysqli_connect</function> ou <function>mysqli_init</function>
</para></listitem></varlistentry>'>
<!ENTITY mysqli.stmt.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
stmt</parameter></term><listitem><para>Somente no estilo procedural: Um recurso statement
retornado por <function>mysqli_stmt_init</function>.</para></listitem></varlistentry>'>
<!ENTITY mysqli.available.mysqlnd 'Disponível apenas no <link xmlns="http://docbook.org/ns/docbook"
linkend="book.mysqlnd">mysqlnd</link>.'>
<!ENTITY mysqli.charset.note '<note xmlns="http://docbook.org/ns/docbook">
<para>MySQLnd sempre assume o charset padrão do banco de dados. Este charset é enviado durante a criação
da conexão, e o mysqlnd usará a partir daí.</para><para>Libmysql utiliza o charset padrão configurado no arquivo
<filename>my.cnf</filename> ou por uma chamada a <function>mysqli_options</function> anterior a
chamada de <function>mysqli_real_connect</function> e depois de <function>mysqli_init</function>.</para></note>'>

<!ENTITY mysqli.integer.overflow.as.string.note '<note xmlns="http://docbook.org/ns/docbook">
<para>Se o número de linhas for maior que <constant>PHP_INT_MAX</constant>,
o número será retornado como uma &string;.</para></note>'>

<!-- Notes for PCRE -->
<!ENTITY pcre.pattern.warning '<para xmlns="http://docbook.org/ns/docbook">
Se o padrão regex passado não compilar para um regex válido, um <constant>E_WARNING</constant> é emitido.
</para>'>

<!-- Notes for SAPI/Apache -->
<!ENTITY apache.req.module '<simpara xmlns="http://docbook.org/ns/docbook">Esta função é suportada quando o PHP
está instalado como um módulo do Apache.
</simpara>'>

<!-- Notes for SAPI/FPM -->
<!ENTITY fpm.intro '<para xmlns="http://docbook.org/ns/docbook">FPM (FastCGI Process Manager) é
uma implementação primária do PHP FastCGI contendo alguns recursos (principalmente) úteis para sites muito carregados.
</para>'>

<!-- SimpleXML Notes -->
<!ENTITY simplexml.iteration '<note xmlns="http://docbook.org/ns/docbook"><simpara>SimpleXML tem uma regra quando adicionando
propriedades interativas para a maioria dos métodos. Eles não podem ser visualizados com <function>var_dump</function>
ou outros métodos que examinem objetos.</simpara></note>'>

<!-- SQLite Notes -->
<!ENTITY sqlite.case-fold '<para xmlns="http://docbook.org/ns/docbook">Os nomes de colunas retornados por
 <constant>SQLITE_ASSOC</constant> e <constant>SQLITE_BOTH</constant> serão
 serão modificados para maiúsculas/minúsculas de acordo com o valor
 da opção de configuração <link xmlns="http://docbook.org/ns/docbook" linkend="ini.sqlite.assoc-case">sqlite.assoc_case</link>
 .</para>'>

<!ENTITY sqlite.decode-bin '<para xmlns="http://docbook.org/ns/docbook">Quando o parâmetro <parameter xmlns="http://docbook.org/ns/docbook">decode_binary</parameter>
 for definido como &true; (o padrão), o PHP irá decodificar a codificão binária
 aplicada aos dados como se eles tenham sido codificados usando
 <function xmlns="http://docbook.org/ns/docbook">sqlite_escape_string</function>. Você normalmente deve deixar este
 valor como o seu padrão, a menos que esteja operando com banco de dados criados por
 outras aplicações capazes de usar o sqlite.</para>'>

<!ENTITY sqlite.no-unbuffered '<note xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Esta função não pode ser utilizada com
 manipuladores de resultados sem buffer.</para></note>'>

<!ENTITY sqlite.param-compat '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Duas sintaxes alternativas são
 suportaas para compatibilidade com outras extensões de banco de dados( como o MySQL).
 A forma preferida é a primeira, aonde o parâmetro <parameter xmlns="http://docbook.org/ns/docbook">dbhandle</parameter>
 é o primeiro parãmetro da função.</simpara></note>'>

<!ENTITY sqlite.result-type '<para xmlns="http://docbook.org/ns/docbook">O parâmetro opcional <parameter xmlns="http://docbook.org/ns/docbook">result_type</parameter>
 aceita uma constante e determina como a matriz retornada será
 indexada. Usando <constant>SQLITE_ASSOC</constant> irá retornar apenas os índices
 associativos (campos com nomes) enquanto <constant>SQLITE_NUM</constant> irá retornar
 apenas os índices numéricos (campos com números). <constant>SQLITE_BOTH</constant>
 irá retornar ambos os índices, numérico e associativo.
 <constant>SQLITE_BOTH</constant> é o padrão para esta função.</para>'>

<!-- Database Notes -->
<!ENTITY database.field-case '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Nomes de campos nesta função
 <emphasis xmlns="http://docbook.org/ns/docbook">diferenciam maiúsculas e minusculas</emphasis>.</simpara></note>'>

<!ENTITY database.fetch-null '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Esta função assimila campos NULL para o
 o &null; do PHP.</simpara></note>'>

<!-- MSQL Notes -->
<!-- The msql.*.description entities are used in the parameters refsect1 -->
<!ENTITY msql.linkid.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term xmlns="http://docbook.org/ns/docbook"><parameter xmlns="http://docbook.org/ns/docbook">
 link_identifier</parameter></term><listitem><para xmlns="http://docbook.org/ns/docbook">A conexão mSQL.
 Se não for especificado, a ultima conexão aberta por <function xmlns="http://docbook.org/ns/docbook">msql_connect</function>
 é assumida. Se uma conexão assim não for encontrada, a função irá tentar establecer uma
 conexão como se a função <function xmlns="http://docbook.org/ns/docbook">msql_connect</function> fosse chamada, e irá usa-la.
</para></listitem></varlistentry>'>

<!ENTITY msql.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term xmlns="http://docbook.org/ns/docbook"><parameter xmlns="http://docbook.org/ns/docbook">
 result</parameter></term><listitem><para xmlns="http://docbook.org/ns/docbook">O resulatdo <type xmlns="http://docbook.org/ns/docbook">resource</type> que
 esta sendo avaliado. Este resultado vem de uma chamada a
 <function xmlns="http://docbook.org/ns/docbook">msql_query</function>.</para></listitem></varlistentry>'>

<!ENTITY msql.field-offset.req.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
field_offset</parameter></term><listitem><para>O número índice do campor.
<parameter>field_offset</parameter> começa com <literal>1</literal>.</para></listitem></varlistentry>'>


<!-- MySQL Notes -->
<!-- The mysql.*.description entities are used in the parameters refsect1 -->
<!ENTITY mysql.linkid.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
link_identifier</parameter></term><listitem><para>A conexão MySQL. Se o
link identifier não for especificado, o último link aberto por
<function>mysql_connect</function> é utilizado. Se uma conexão anterior não existir
será tentado criar um a partir de uma chadama a <function>mysql_connect</function>
sem nenhum argumento. Se nenhuma conexão for encontrada ou estabelecida, um erro nível
<constant>E_WARNING</constant> é gerado.</para></listitem>
</varlistentry>'>

<!ENTITY mysql.linkid-noreopen.description '<varlistentry
xmlns="http://docbook.org/ns/docbook"><term><parameter>
link_identifier</parameter></term><listitem><para>A conexão MySQL. Se o
link identifier não for especificado, o último link aberto por
<function>mysql_connect</function> é utilizado. Se uma conexão anterior não existir
ou for estabelecida, um erre nível <constant>E_WARNING</constant> será
gerado.</para></listitem></varlistentry>'>

<!ENTITY mysql.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
result</parameter></term><listitem><para>O resultado tipo <type>resource</type> que
está sendo avaliado. Esse resultado é original de uma chamada a
<function>mysql_query</function>.</para></listitem></varlistentry>'>

<!ENTITY mysql.field-offset.req.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>
field_offset</parameter></term><listitem><para>A ordem posicional do campo.
<parameter>field_offset</parameter> começa em <literal>0</literal>. Se
<parameter>field_offset</parameter> não existir, um erro nível
<constant>E_WARNING</constant> é emitido.</para></listitem></varlistentry>'>

<!ENTITY mysql.alternative.note '<para xmlns="http://docbook.org/ns/docbook">Esta extensão está obsoleta a partir do PHP 5.5.0 e foi removida no PHP 7.0.0.
Utilize <link linkend="book.mysqli">MySQLi</link> ou <link linkend="ref.pdo-mysql">PDO_MySQL</link> alternativamente.
Veja também o guia <link linkend="mysqlinfo.api.choosing">MySQL: escolhendo uma API</link>.
Alternativas a essa função incluem:</para>'>

<!ENTITY mysql.alternative.note.4-3-0 '<para xmlns="http://docbook.org/ns/docbook">Esta função está obsoleta a partir do PHP 4.3.0 e
toda a extensão <link linkend="book.mysql">MySQL original</link> foi removida no PHP 7.0.0.
Alternativamente utilize as extensões <link linkend="book.mysqli">MySQLi</link> ou <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Veja também o guia <link linkend="mysqlinfo.api.choosing">MySQL: escolhendo uma API</link>.
Alternatives to this function include:</para>'>

<!ENTITY mysql.alternative.note.5-3-0 '<para xmlns="http://docbook.org/ns/docbook">Esta função está obsoleta a partir do PHP 5.3.0 e
toda a extensão <link linkend="book.mysql">MySQL original</link> foi removida no PHP 7.0.0.
Alternativamente utilize as extensões <link linkend="book.mysqli">MySQLi</link> ou <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Veja também o guia <link linkend="mysqlinfo.api.choosing">MySQL: escolhendo uma API</link>.
Alternatives to this function include:</para>'>

<!ENTITY mysql.alternative.note.5-4-0 '<para xmlns="http://docbook.org/ns/docbook">Esta função está obsoleta a partir do PHP 5.4.0 e
toda a extensão <link linkend="book.mysql">MySQL original</link> foi removida in PHP 7.0.0.
Alternativamente utilize as extensões <link linkend="book.mysqli">MySQLi</link> ou <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Veja também o guia <link linkend="mysqlinfo.api.choosing">MySQL: escolhendo uma API</link>.
Alternatives to this function include:</para>'>

<!ENTITY mysql.alternative.note.5-5-0 '<para xmlns="http://docbook.org/ns/docbook">Esta função está obsoleta a partir do PHP 5.5.0 e
toda a extensão <link linkend="book.mysql">MySQL original</link> foi removida no PHP 7.0.0.
Alternativamente utilize as extensões <link linkend="book.mysqli">MySQLi</link> ou <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Veja também o guia <link linkend="mysqlinfo.api.choosing">MySQL: escolhendo uma API</link>.
Alternatives to this function include:</para>'>

<!ENTITY mysql.close.connections.result.sets '<para xmlns="http://docbook.org/ns/docbook">
Conexões não persistentes ao MySQL e resultsets são automaticamente destruídos quando
um script PHP finaliza. Fechar explicitamente conexões
abertas e liberar resultsets é opcional, mas fazê-los é recomendado.
Isto imediatamente devolve recursos ao PHP e MySQL, o que pode
melhorar a performance. Para mais informações veja
<link linkend="language.types.resource.self-destruct">liberação de recursos</link></para>'>

<!-- Sybase Notes -->
<!ENTITY sybase.ct.only '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Esta função somente está disponível quando utilizando
 a biblioteca de interface CT do Sybase, mas não pela biblioteca DB.
 </simpara></note>'>

<!ENTITY sybase.db.only '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Esta função somente está disponível quabdi utilizando
 a biblioteca DB library como interface para o Sybase, e não com a biblioteca CT.</simpara></note>'>

<!ENTITY sybase.linkid.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term xmlns="http://docbook.org/ns/docbook"><parameter xmlns="http://docbook.org/ns/docbook">
 link_identifier</parameter></term><listitem><para xmlns="http://docbook.org/ns/docbook">A conexão Sybase. Se o
 identificador de conexão não for especificado, a ultima conexão aberta por
 <function xmlns="http://docbook.org/ns/docbook">sybase_connect</function> é assumida. Se uma conexão assim não for enontrada,
 ela irá tentar criar uma como se <function xmlns="http://docbook.org/ns/docbook">sybase_connect</function> fosse chamada
 sem argumentos. Se nenhuma conexão for encontrada ou estabelecida, um
 aviso de nível <constant>E_WARNING</constant> é gerado.</para></listitem>
 </varlistentry>'>

<!-- CPDF Notes -->
<!ENTITY cpdf.ul '<para xmlns="http://docbook.org/ns/docbook">O parâmetro opcional <parameter xmlns="http://docbook.org/ns/docbook">mode</parameter>
 determina a unidade de tamanho. Se é <literal xmlns="http://docbook.org/ns/docbook">0</literal> ou omitida, o valor
 padrão de unidade especificado para a página é utilizada. Caso contrário, as
 coordenadas são medidas em postscript points independentemente da unidade atual</para>'>

<!ENTITY cpdf.mode.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term xmlns="http://docbook.org/ns/docbook"><parameter xmlns="http://docbook.org/ns/docbook">
 mode</parameter></term><listitem><para xmlns="http://docbook.org/ns/docbook">O parâmetro opcional <parameter xmlns="http://docbook.org/ns/docbook">mode</parameter>
 determina o tamanho da unidade. Se for 0 ou omitido a unidade padrão especificada
 para a pagina é usada. Se não as coordenadas são medidas em pontos postscript
 não importando a unidade atual.</para>
 </listitem></varlistentry>'>

<!ENTITY cpdf.pdf-document.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term xmlns="http://docbook.org/ns/docbook"><parameter xmlns="http://docbook.org/ns/docbook">
 pdf_document</parameter></term><listitem><para xmlns="http://docbook.org/ns/docbook">O manipulador do documento, retornado por
 <function xmlns="http://docbook.org/ns/docbook">cpdf_open</function>.</para></listitem></varlistentry>'>

<!-- Xattr entities -->
<!ENTITY xattr.namespace '<para xmlns="http://docbook.org/ns/docbook">Atributos estendidos tem dois namespaces diferentes: usuário
 e root. O namespace de usuário esta disponível para todos os usuários enquanto o namespace
 de root esta disponível apenas para o usuario com privilégios de root. xattr opera no namespace de
 usuário por padrão, mas você pode mudar isso usando o argumento
 <parameter xmlns="http://docbook.org/ns/docbook">flags</parameter>.</para>'>

<!-- Notes for IPv6 -->
<!ENTITY ipv6.brackets '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Quando informando endereços IPv6 numéricos
 (por exemplo, <literal xmlns="http://docbook.org/ns/docbook">fe80::1</literal>), você precisa englobar o IP entre colchetes.
 Exemplo: <literal xmlns="http://docbook.org/ns/docbook"> tcp://[fe80::1]:80</literal>.</simpara></note>'>

<!ENTITY ipv6.php5 '<note xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">O suporte ao IPv6 foi adicionado no PHP 5.0.0.
</simpara></note>'>

<!-- Notes for tidy -->
<!ENTITY note.tidy.ze2 '<note xmlns="http://docbook.org/ns/docbook"><simpara>Esta função somente está disponível no
Zend Engine 2 (PHP &gt;= 5.0.0).</simpara></note>'>

<!ENTITY tidy.object 'Um objeto <classname xmlns="http://docbook.org/ns/docbook">Tidy</classname>.'>

<!ENTITY note.tidy.1only '<note xmlns="http://docbook.org/ns/docbook"><simpara>Esta função somente está disponível no
Tidy 1.0. Ela está obsoleta no Tidy 2.0, sendo removida desde então.
</simpara></note>'>

<!ENTITY note.tidy.2only '<note xmlns="http://docbook.org/ns/docbook"><simpara>Os parâmetros opcionais
<parameter>config</parameter> e <parameter>encoding</parameter> foram
adicionados no Tidy 2.0.</simpara></note>'>

<!ENTITY tidy.conf-enc '<para xmlns="http://docbook.org/ns/docbook">O parâmetro <parameter>config</parameter>
pode ser passado como um array ou string. Se string
ele é interpretado como nome do arquivo de configuração, se como array ele é
tratado como as próprias configurações. Veja
<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.tidy.conf;">&url.tidy.conf;</link>
para explicações sobre cada opção.</para><para>O parâmetro
<parameter>encoding</parameter> configura o encoding para os documentos de entrada
e retorno. Os valores possíveis de <parameter>encoding</parameter> são:
<literal>ascii</literal>, <literal>latin0</literal>, <literal>latin1</literal>,
<literal>raw</literal>, <literal>utf8</literal>, <literal>iso2022</literal>,
<literal>mac</literal>, <literal>win1252</literal>, <literal>ibm858</literal>,
<literal>utf16</literal>, <literal>utf16le</literal>,
<literal>utf16be</literal>, <literal>big5</literal> and
<literal>shiftjis</literal>.</para>'>

<!-- Snippets for the installation section -->
<!ENTITY warn.apache2.compat '<warning xmlns="http://docbook.org/ns/docbook"><para>Não recomendados utilizar o
threaded MPM em produção com o Apache 2. Utilize o prefork MPM, que é
MPM padrão no Apache 2.0 e 2.2.
Para mais informações veja o FAQ relacionado sobre o uso de
<link linkend="faq.installation.apache2">Apache2 com threaded MPM</link></para></warning>'>

<!ENTITY note.apache.slashes '<note xmlns="http://docbook.org/ns/docbook"><simpara>Lembre que ao adicionar
caminhos nos arquivos de configuração do Apache no Windows, todos as contrabarras
como em <filename>c:\directory\file.ext</filename> devem ser convertidos para
barras: <filename>c:/directory/file.ext</filename>. Uma barra
terminal também pode ser necessário para diretórios.</simpara></note>'>

<!-- Snippets and titles for the contributors section -->
<!ENTITY Credit.Authors.and.Contributors 'Autores e participantes'>

<!ENTITY Credit.Introduction '<para xmlns="http://docbook.org/ns/docbook">Destacamos as pessoas atualmente mais ativas
na capa do manual, mas há na verdade um grande número de pessoas que
ajudam no trabalho ou que proveram grande quantidade de esforço no projeto
anteriormente. Existem muitas pessoas não citadas que ajudam com as
notas de usuários, quais são continuamente incluídas nas referências,
trabalho qual somos extremamente gratos. Todas as listas a seguir são
informadas em ordem alfabética.
</para>'>

<!ENTITY Credit.Authors.and.Editors 'Autores e Editores'>

<!ENTITY Credit.Past.Authors.Text 'Os seguintes participantes
são reconhecidos por seu impacto e/ou por continuar a adicionar
conteúdo ao manual:'>

<!ENTITY Credit.Past.Editors.Text 'Os seguintes participantes realizaram
trabalho significativo editando o manual:'>

<!ENTITY Credit.Note.Editors.Title 'Curadores de notas de usuários'>

<!ENTITY Credit.Note.Editors.Active 'Os mais ativos curadores:'>

<!ENTITY Credit.Note.Editors.Inactive 'Pessoas que colocaram grande esforço
gerenciando notas de usuários:'>

<!ENTITY listendand ' e'>

<!-- classkit and runkit entities -->
<!ENTITY note.classkit.selfmanipulation '<note xmlns="http://docbook.org/ns/docbook"><simpara>Esta função não
pode ser utilizada para manipular um método em uso (ou encadeado).</simpara>
</note>'>

<!ENTITY note.runkit.selfmanipulation '<note xmlns="http://docbook.org/ns/docbook"><simpara>Esta função não
pode ser utilizada para manipular um método ativo (ou encadeado) method.</simpara>
</note>'>

<!ENTITY note.runkit.sandbox '<note xmlns="http://docbook.org/ns/docbook"><simpara>Suporte ao sandbox (requerido por
<function>runkit_lint</function>, <function>runkit_lint_file</function>
e a classe <classname>Runkit_Sandbox</classname>) somente está disponível a partir do
PHP 5.1.0 ou versões especificamente alteradas do PHP 5.0, requerendo também thread
safety ativo.
Veja o <filename>README</filename> incluído no pacote do runkit para
mais informações.</simpara></note>'>

<!ENTITY note.runkit.internal-override '<note xmlns="http://docbook.org/ns/docbook"><simpara>Por padrão somente
funções do usuário podem ser removidos, renomeadas ou modificadas. Para
sobrescrever funções internas, você precisa ativar a configuração
<literal>runkit.internal_override</literal> no &php.ini;.</simpara>
</note>'>

<!-- SSH2 Extension -->
<!ENTITY note.ssh2.subsystem.publickey '<note xmlns="http://docbook.org/ns/docbook"><simpara>O subsistema de chave pública
utilizado para gerenciar chaves de um servidor qual o cliente
<emphasis>já está</emphasis> autenticado. Para autenticar em um servidor remoto
utilizando chaves públicas veja a função
<function>ssh2_auth_pubkey_file</function>.</simpara></note>'>

<!-- Session notes -->
<!ENTITY returns.session.storage.retval 'O valor retornado (geralmente &true; no sucesso, &false; em falha). Note que esse valor é retornado internamente ao PHP para processamento.'>

<!-- XMLWriter Notes -->
<!ENTITY xmlwriter.xmlwriter.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term xmlns="http://docbook.org/ns/docbook"><parameter xmlns="http://docbook.org/ns/docbook">
 xmlwriter</parameter></term><listitem><para xmlns="http://docbook.org/ns/docbook">Apenas para chamadas de procedimentos.
 O recurso XMLWriter <type xmlns="http://docbook.org/ns/docbook">resource</type> que esta sendo modificado. Este recurso vem de uma chamada a <function xmlns="http://docbook.org/ns/docbook">xmlwriter_open_uri</function> ou <function xmlns="http://docbook.org/ns/docbook">xmlwriter_open_memory</function>.</para></listitem></varlistentry>'>

<!-- SOAP notes -->
<!ENTITY soap.wsdl.mode.only "<note xmlns='http://docbook.org/ns/docbook'><para>Esta função somente funciona no modo WSDL.</para></note>">

<!-- Stomp notes -->
<!ENTITY stomp.param.link "<varlistentry xmlns='http://docbook.org/ns/docbook'><term><parameter>link</parameter></term><listitem><para>Somente no estilo procedural: O link stomp retornado por <function>stomp_connect</function>.</para></listitem></varlistentry>">
<!ENTITY stomp.param.headers "<varlistentry xmlns='http://docbook.org/ns/docbook'><term><parameter>headers</parameter></term><listitem><para>Um array associativo contendo os headers adicionais.</para></listitem></varlistentry>">
<!ENTITY stomp.note.transaction "<note xmlns='http://docbook.org/ns/docbook'><para>Um header de transição pode ser especificado, indicadno que a mensagem de conhecimento (acknowledgment)  deve ser parte da transação nomeada.</para></note>">
<!ENTITY stomp.note.sync "<tip xmlns='http://docbook.org/ns/docbook'><simpara>O Stomp é naturalmente assíncrono. Comunicação síncrona pode ser implementada adicionando-se um header receipt. Isto fará os métodos não retornarem até o servidor devolver o recibo da mensagem ou até que um timeout ocorra.</simpara></tip>">

<!-- SVN notes -->
<!ENTITY svn.relativepath "<note xmlns='http://docbook.org/ns/docbook'><simpara>Caminhos relativos serão resolvidos como se o diretório atual fosse aquele que contém o binário do PHP. Para usar o diretório de trabalho do script, utilize antes <function>realpath</function> ou dirname(__FILE__).</simpara></note>">
<!ENTITY svn.referto.status 'Veja em <link xmlns="http://docbook.org/ns/docbook" linkend="svn.constants.status">status constants</link> os valores possíveis.'>
<!ENTITY svn.referto.type 'Veja em <link xmlns="http://docbook.org/ns/docbook" linkend="svn.constants.type">type constants</link> os valores possíveis.'>

<!-- FANN notes -->
<!ENTITY fann.ann.description '<para xmlns="http://docbook.org/ns/docbook"><type>resource</type> da rede neural.</para>'>
<!ENTITY fann.train.description '<para xmlns="http://docbook.org/ns/docbook">Dados de treinamento da <type>resource</type> rede neural.</para>'>
<!ENTITY fann.errdat.description '<para xmlns="http://docbook.org/ns/docbook">Um <type>resource</type> de rede neural ou um <type>resource</type> de dados de treinamento.</para>'>
<!ENTITY fann.return.void '<para xmlns="http://docbook.org/ns/docbook">Nenhum valor é retornado.</para>'>
<!ENTITY fann.return.bool '<para xmlns="http://docbook.org/ns/docbook">Retorna &true; no sucesso ou &false; em outros casos.</para>'>
<!ENTITY fann.return.ann '<para xmlns="http://docbook.org/ns/docbook"> Retorna um <type>resource</type> de rede neural no sucesso ou &false; em erros.</para>'>
<!ENTITY fann.return.train '<para xmlns="http://docbook.org/ns/docbook">Retorna um <type>resource</type> de dados de treinamento no sucesso ou &false; em erros.</para>'>

<!-- Imagick generic return types -->
<!ENTITY imagick.return.success 'Retorna &true; no sucesso.'>
<!ENTITY imagick.imagick.throws 'Lança ImagickException em caso de erro.'>
<!ENTITY imagick.imagickdraw.throws 'Lança ImagickDrawException em caso de erro.'>
<!ENTITY imagick.imagickpixel.throws 'Lança ImagickPixelException em caso de erro.'>
<!ENTITY imagick.imagickpixeliterator.throws 'Lança ImagickPixelIteratorException em caso de erro.'>

<!-- Imagick version infos -->
<!ENTITY imagick.method.available.0x629 'Este método está disponível se o PHP foi compilado com o ImageMagick versão 6.2.9 ou superior.'>
<!ENTITY imagick.method.available.0x631 'Este método está disponível se o PHP foi compilado com o ImageMagick versão 6.3.1 ou superior.'>
<!ENTITY imagick.method.available.0x632 'Este método está disponível se o PHP foi compilado com o ImageMagick versão 6.3.2 ou superior.'>
<!ENTITY imagick.method.available.0x636 'Este método está disponível se o PHP foi compilado com o ImageMagick versão 6.3.6 ou superior.'>
<!ENTITY imagick.method.available.0x637 'Este método está disponível se o PHP foi compilado com o ImageMagick versão 6.3.7 ou superior.'>
<!ENTITY imagick.method.available.0x638 'Este método está disponível se o PHP foi compilado com o ImageMagick versão 6.3.8 ou superior.'>
<!ENTITY imagick.method.available.0x639 'Este método está disponível se o PHP foi compilado com o ImageMagick versão 6.3.9 ou superior.'>
<!ENTITY imagick.method.available.0x640 'Este método está disponível se o PHP foi compilado com o ImageMagick versão 6.4.0 ou superior.'>
<!ENTITY imagick.method.available.0x641 'Este método está disponível se o PHP foi compilado com o ImageMagick versão 6.4.1 ou superior.'>
<!ENTITY imagick.method.available.0x642 'Este método está disponível se o PHP foi compilado com o ImageMagick versão 6.4.2 ou superior.'>
<!ENTITY imagick.method.available.0x643 'Este método está disponível se o PHP foi compilado com o ImageMagick versão 6.4.3 ou superior.'>
<!ENTITY imagick.method.available.0x644 'Este método está disponível se o PHP foi compilado com o ImageMagick versão 6.4.4 ou superior.'>
<!ENTITY imagick.method.available.0x645 'Este método está disponível se o PHP foi compilado com o ImageMagick versão 6.4.5 ou superior.'>
<!ENTITY imagick.method.available.0x647 'Este método está disponível se o PHP foi compilado com o ImageMagick versão 6.4.7 ou superior.'>
<!ENTITY imagick.method.available.0x649 'Este método está disponível se o PHP foi compilado com o ImageMagick versão 6.4.9 ou superior.'>
<!ENTITY imagick.method.available.0x653 'Este método está disponível se o PHP foi compilado com o ImageMagick versão 6.5.3 ou superior.'>
<!ENTITY imagick.method.available.0x657 'Este método está disponível se o PHP foi compilado com o ImageMagick versão 6.5.7 ou superior.'>

<!ENTITY imagick.method.not.available.0x700 'Este método não está disponível se o Imagick for compilado contra o ImageMagick versão 7.0.0 ou superior.'>

<!ENTITY imagick.constant.available 'Esta constante está disponível se o Imagick foi compilado com o ImageMagick versão'>

<!-- Imagick default channel information -->
<!ENTITY imagick.default.channel.info 'O padrão é <constant xmlns="http://docbook.org/ns/docbook">Imagick::CHANNEL_DEFAULT</constant>. Veja nessa lista de <link xmlns="http://docbook.org/ns/docbook" linkend="imagick.constants.channel">constantes de canal</link>'>

<!-- Fuzz parameter -->
<!ENTITY imagick.parameter.fuzz 'A quantidade de variação (fuzz). Por exemplo no fuzz de 10 a cor vermelha  nas intensidades 100 e 102 são interpretadas como a mesma cor.'>

<!-- Channel parameter -->
<!ENTITY imagick.parameter.channel 'Informa qualquer constante de canal válida no modo do canal. Para mais de um canal, combine as <link xmlns="http://docbook.org/ns/docbook" linkend="imagick.constants.channel">constantes de canal</link> utilizando operações bitwise. &imagick.default.channel.info;'>

<!-- Alpha parameter -->
<!ENTITY imagick.parameter.alpha 'O nível de transparência: 1.0 é totalmente opaco e 0.0 é totalmente transparente.'>

<!ENTITY imagick.imagickexception.throw 'Lança uma exceção
<classname xmlns="http://docbook.org/ns/docbook">ImagickException</classname> em erros.'>

<!ENTITY imagick.bestfit.note '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  O comportamento do parâmetro <parameter>bestfit</parameter> mudou no Imagick 3.0.0.
  Antes desta versão ao informar dimensões 400x400 numa imagem de 200x150 não causaria
  alterações. No Imagick 3.0.0 e posteriores a imagem seria escalada para 400x300 por
  ser o "melhor ajuste" entre as dimensões. Se <parameter>bestfit</parameter>
  é informado tanto a altura como comprimento devem ser informados.
 </simpara>
</note>'>

<!ENTITY note.openssl.cnf '<note xmlns="http://docbook.org/ns/docbook">
 <simpara xmlns="http://docbook.org/ns/docbook">
  Você precisa ter um válido <filename xmlns="http://docbook.org/ns/docbook">openssl.cnf</filename> instalado para
  esta função operar corretamente.
  Veja as notas sobre <link xmlns="http://docbook.org/ns/docbook" linkend="openssl.installation">a seção de
  instalação</link> para mais informação.
 </simpara>
</note>'>
<!ENTITY note.openssl.param-notext '<para xmlns="http://docbook.org/ns/docbook">
 O parâmetro opcional <parameter xmlns="http://docbook.org/ns/docbook">notext</parameter> afeta
 a exibição da saída; se ele é &false; então informação legível para
 humano é incluida na saída. O valor padrão do <parameter xmlns="http://docbook.org/ns/docbook">notext</parameter>
 é &true;.
</para>'>

<!-- COM/Dotnet -->
<!ENTITY com.variant-arith '<note xmlns="http://docbook.org/ns/docbook">
<para>
 Assim como todas as funções aritméticas, os parâmetros para esta função
 podem ser qualquer um tipo nativo do PHP (integer, string, ponto flutuante, booleano ou
 &null;), ou uma instancia de uma classe COM, VARIANT ou DOTNET. Tipos nativos do PHP
 serão convertidos para variants usando as mesmas regras como mencionadas no construtor
 da classe <xref linkend="class.variant"/>. Objetos COM e DOTNET
 terão o valor de suas propriedades padrão obtidos e usados como um valor variant.
</para>
<para>
 As funções aritméticas variant são wrappers para funções chamadas similarmente
 na biblioteca COM; para mais informação sobre estas funções, consulte
 o MSDN. As funções PHP são nomeadas ligeiramente diferentes; por exemplo
 <function>variant_add</function> no PHP corresponde à <literal>VarAdd()
 </literal> na documentação MSDN.
</para>
</note>
'>
<!ENTITY com.use-oo-instead '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Esta função não existe no PHP 5;, neste caso você deve usar a regular
  e mais natural sintaxe OO para acessar propriedades ou chamar métodos.
 </simpara>
</note>
'>

<!-- phar -->
<!ENTITY phar.write '<note xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Esta
 função requer a configuração do arquivo &php.ini; <literal xmlns="http://docbook.org/ns/docbook">phar.readonly</literal> ser
 definida como <literal xmlns="http://docbook.org/ns/docbook">0</literal> para funcionar os objetos <classname xmlns="http://docbook.org/ns/docbook">Phar</classname>.
 Caso contrário, uma <classname xmlns="http://docbook.org/ns/docbook">PharException</classname> será disparada.</para></note>'>

<!ENTITY phar.removed.pharcompress '<note xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Este
método tem sido removido da extensão phar a partir da versão 2.0.0. Implementações
alternativas são possíveis usando <function xmlns="http://docbook.org/ns/docbook">Phar::compress</function>,
<function xmlns="http://docbook.org/ns/docbook">Phar::decompress</function>, <function xmlns="http://docbook.org/ns/docbook">Phar::compressFiles</function> e
<function xmlns="http://docbook.org/ns/docbook">Phar::decompressFiles</function>.</para></note>'>

<!ENTITY phar.removed.pharfileinfocompress '<note xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Este
método tem sido removido da extensão phar a partir da versão 2.0.0. Implementações
alternativas são possíveis usando <function xmlns="http://docbook.org/ns/docbook">PharFileInfo::isCompressed</function>,
<function xmlns="http://docbook.org/ns/docbook">PharFileInfo::decompress</function>, e <function xmlns="http://docbook.org/ns/docbook">PharFileInfo::compress</function>.</para></note>'>

<!-- XML -->
<!ENTITY libxml.required '<para xmlns="http://docbook.org/ns/docbook">Esta extensão requer a
<link linkend="book.libxml">libxml</link>. Isto significa que também é preciso informar
<option role="configure">--enable-libxml</option>, mas isso já é o padrão
dado que libxml é incluída por default.</para>'>

<!-- XMLReader -->
<!ENTITY xmlreader.libxml20620.note '<caution xmlns="http://docbook.org/ns/docbook"><para xmlns="http://docbook.org/ns/docbook">Esta função está disponível somente quando o PHP é compilado com libxml 20620 ou superior.</para></caution>'>

<!-- inotify -->
<!ENTITY inotify.instance.description 'Um resource retornado por
<function xmlns="http://docbook.org/ns/docbook">inotify_init</function>'>

<!-- User streams -->
<!ENTITY userstream.not.implemented.warning '<para xmlns="http://docbook.org/ns/docbook">Emite
<constant>E_WARNING</constant> se uma chamada a essa função falha
(não implementada, por exemplo).</para>'>
<!ENTITY userstream.updates.context '<note xmlns="http://docbook.org/ns/docbook"><para>A propriedade
<varname linkend="streamwrapper.props.context">streamWrapper::$context</varname>
é atualizada se um contexto válido é passado no chamador da função.</para></note>'>

<!-- Gmagick -->
<!ENTITY gmagick.return.success 'Retorna &true; no sucesso.'>
<!ENTITY gmagick.gmagickexception.throw 'Lança uma exceção
<classname xmlns="http://docbook.org/ns/docbook">GmagickException</classname> em erros.'>

<!-- Reflection -->
<!ENTITY reflection.export.return 'Se o parâmetro <parameter xmlns="http://docbook.org/ns/docbook">return</parameter>
for &true; então o export é retornado como uma <type xmlns="http://docbook.org/ns/docbook">string</type>,
senão retorna &null;.'>

<!ENTITY reflection.export.param.return 'Passar &true; irá retornar o export,
em vez de emiti-lo. Passar &false; (padrão) fará o oposto.'>

<!ENTITY reflection.invoke.reference 'Se essa função tem argumentos que precisam
ser referências, então os parâmetros tem de ser passados como referências nos argumentos.'>

<!ENTITY reflection.export.param.name 'A reflexão para exportar.'>

<!-- SPL -->
<!ENTITY spl.datastructures.intro.title '<title xmlns="http://docbook.org/ns/docbook">Estruturas de Dados</title>'>

<!ENTITY spl.exceptions.intro.title '<title xmlns="http://docbook.org/ns/docbook">Exceções</title>'>
<!ENTITY spl.exceptions.intro '<para xmlns="http://docbook.org/ns/docbook">O SPL fornece um conjunto de Exceptions padrões.</para><para xmlns="http://docbook.org/ns/docbook">Veja também as <xref linkend="reserved.exceptions" /></para>'>

<!ENTITY spl.files.intro.title '<title xmlns="http://docbook.org/ns/docbook">Manipulação de arquivos</title>'>
<!ENTITY spl.files.intro '<partintro xmlns="http://docbook.org/ns/docbook"><para>O SPL fornece um conjunto de classes para manipular arquivos.</para></partintro>'>

<!ENTITY spl.interfaces.intro.title '<title xmlns="http://docbook.org/ns/docbook">Interfaces</title>'>
<!ENTITY spl.interfaces.intro '<para xmlns="http://docbook.org/ns/docbook">O SPL fornece um conjunto de interfaces.</para><para xmlns="http://docbook.org/ns/docbook">Veja também as <xref linkend="reserved.interfaces" /></para>'>
<!ENTITY spl.interfaces.list '<title xmlns="http://docbook.org/ns/docbook">lista de Interfaces</title>'>

<!ENTITY spl.iterators.intro.title '<title xmlns="http://docbook.org/ns/docbook">Iteradores</title>'>
<!ENTITY spl.iterators.intro '<para xmlns="http://docbook.org/ns/docbook">O SPL fornece um conjunto de interadores para percorrer objetos.</para>'>

<!ENTITY spl.misc.intro.title '<title xmlns="http://docbook.org/ns/docbook">Classes e interfaces genéricas</title>'>
<!ENTITY spl.misc.intro '<partintro xmlns="http://docbook.org/ns/docbook"><para>Classes e interfaces que não se enquadram nas outras categorias.</para></partintro>'>

<!-- ZIP -->
<!ENTITY zip.filename.separator '<note xmlns="http://docbook.org/ns/docbook"><simpara>Para portabilidade máxima, é recomendado sempre utilizar barras normais (<literal>/</literal>) como separador de diretórios nos nomes de arquivos dentro de ZIPs.</simpara></note>'>

<!-- Win32Service -->
<!ENTITY win32service.false.error ', &false; se ocorrer um problema com os parâmetros ou um <link xmlns="http://docbook.org/ns/docbook" linkend="win32service.constants.errors">Win32 Error Code</link> em caso de falhas.'>
<!ENTITY win32service.success.false.error 'Retorna &true; no sucesso &win32service.false.error;'>
<!ENTITY win32service.noerror.false.error 'Retorna <constant xmlns="http://docbook.org/ns/docbook">WIN32_NO_ERROR</constant> no sucesso &win32service.false.error;'>

<!-- SNMP -->
<!ENTITY snmp.set.type.values '<para xmlns="http://docbook.org/ns/docbook">
 O <acronym>MIB</acronym> define o tipo de cada id de objeto. Pode ser um caractere da lista abaixo.
</para>
<table xmlns="http://docbook.org/ns/docbook">
 <title>types</title>
 <tgroup cols="2">
  <tbody>
   <row><entry>=</entry><entry>Lista de MIBs id</entry></row>
   <row><entry>i</entry><entry>INTEGER</entry> </row>
   <row><entry>u</entry><entry>INTEGER</entry></row>
   <row><entry>s</entry><entry>STRING</entry></row>
   <row><entry>x</entry><entry>HEX STRING</entry></row>
   <row><entry>d</entry><entry>DECIMAL STRING</entry></row>
   <row><entry>n</entry><entry>NULLOBJ</entry></row>
   <row><entry>o</entry><entry>OBJID</entry></row>
   <row><entry>t</entry><entry>TIMETICKS</entry></row>
   <row><entry>a</entry><entry>IPADDRESS</entry></row>
   <row><entry>b</entry><entry>BITS</entry></row>
  </tbody>
 </tgroup>
</table>
<para xmlns="http://docbook.org/ns/docbook">
 Se <constant>OPAQUE_SPECIAL_TYPES</constant> foi definido durante a compilação da biblioteca <acronym>SNMP</acronym>, os seguintes também são válidos:
</para>
<table xmlns="http://docbook.org/ns/docbook">
 <title>types</title>
 <tgroup cols="2">
  <tbody>
   <row><entry>U</entry><entry>unsigned int64</entry></row>
   <row><entry>I</entry><entry>signed int64</entry></row>
   <row><entry>F</entry><entry>float</entry></row>
   <row><entry>D</entry><entry>double</entry></row>
  </tbody>
 </tgroup>
</table>
'>
<!ENTITY snmp.set.type.values.asn.mapping '<para xmlns="http://docbook.org/ns/docbook">
 A maioria dos tipos tem correspondentes óbvios com tipos ASN.1.  &apos;s&apos;, &apos;x&apos;, &apos;d&apos; e &apos;b&apos; são modos diferentes de especificar um valor OCTET STRING e
  &apos;u&apos; também é utilizado para manipular valores Gauge32.
</para>
'>
<!ENTITY snmp.set.type.values.equal.note '<para xmlns="http://docbook.org/ns/docbook">
 Se MIB-Files foi carregado na árvore MIB com "snmp_read_mib" ou por especificá-lo na configuração do libsnmp, &apos;=&apos; pode ser utilizado
 como parâmetro <parameter>type</parameter> para todos os identificadores de objeto que podem ser lidos automaticamente do MIB.
</para>
'>
<!ENTITY snmp.set.type.values.bitset.note '<para xmlns="http://docbook.org/ns/docbook">
 Note que há duas maneiras de configurar o tipo BITS, assim:
 "SYNTAX    BITS {telnet(0), ftp(1), http(2), icmp(3), snmp(4), ssh(5), https(6)}":
</para>
<itemizedlist xmlns="http://docbook.org/ns/docbook">
 <listitem>
  <simpara>
   Utilizando "b" e uma lista de bits. Esse método não é recomendado desde que requisições GET para o mesmo OID pode retornar algo com 0xF8.
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   Utilizando "x" e um número hex sem (!) o prefixo "0x".
  </simpara>
 </listitem>
</itemizedlist>
<para xmlns="http://docbook.org/ns/docbook">
 Veja a seção de exemplo para mais detalhes.
</para>
'>
<!ENTITY snmp.methods.exceptions_enable.refsect '<refsect1 role="errors" xmlns="http://docbook.org/ns/docbook">
&reftitle.errors;
<para>
 Esse método não lança nenhuma exceção por padrão.
 Para ativar o lançamento de exceções SNMPException quando algum erro ocorrer,
 o parâmetro <parameter>exceptions_enabled</parameter>
 deve ser configurado. Veja <link linkend="snmp.props.exceptions-enabled">
 <parameter>SNMP::$exceptions_enabled</parameter>essa explicação</link> para mais detalhes.
</para>
</refsect1>
'>

<!-- Eio -->
<!ENTITY eio.callback.proto '<para xmlns="http://docbook.org/ns/docbook">
A função <parameter xmlns="http://docbook.org/ns/docbook">callback</parameter> é chamada quando a requisição finaliza.
Ela deve ter o seguinte protótipo: <programlisting role="php"><![CDATA[
void callback(mixed $data, int $result[, resource $req]);
]]></programlisting>
<variablelist xmlns="http://docbook.org/ns/docbook">
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>data</parameter></term>
<listitem><para>são os dados passados para a requisição.</para></listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>result</parameter></term>
<listitem><para>resultado específico retornado; basicamente o valor retornado pela
chamada ao sistema.</para></listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>req</parameter></term>
<listitem><para>é o recurso opcional que pode ser utilizado em funções como <function>eio_get_last_error</function></para></listitem>
</varlistentry>
</variablelist>
</para>
'>

<!ENTITY eio.request.pri.values '<para
xmlns="http://docbook.org/ns/docbook">A prioridade da requisição: <constant
xmlns="http://docbook.org/ns/docbook">EIO_PRI_DEFAULT</constant>, <constant
xmlns="http://docbook.org/ns/docbook">EIO_PRI_MIN</constant>, <constant
xmlns="http://docbook.org/ns/docbook">EIO_PRI_MAX</constant>, or &null;.
Se &null; for passado o parâmetro <parameter
xmlns="http://docbook.org/ns/docbook">pri</parameter> internamente é configurado para
<constant xmlns="http://docbook.org/ns/docbook">EIO_PRI_DEFAULT</constant>.
</para>
'>

<!ENTITY eio.warn.relpath '<warning
xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Evite utilizar caminhos
relativos</simpara></warning>
'>

<!ENTITY trader.arg.array.of.real 'Array de valores reais.'>
<!ENTITY trader.arg.array.of.real.high 'Preço máximo, array de valores reais.'>
<!ENTITY trader.arg.array.of.real.low 'Preço mínimo, array de valores reais.'>
<!ENTITY trader.arg.array.of.real.close 'Preço de fechamento (último), array de valores reais.'>
<!ENTITY trader.arg.array.of.real.open 'Preço de abertura, array de valores reais.'>
<!ENTITY trader.arg.array.of.real.volume 'Volume negociado, array de valores reais.'>
<!ENTITY trader.arg.array.of.real.periods 'Array de valores reais.'>
<!ENTITY trader.arg.penetration 'Percentual de penetração de um candle referente a outro.'>
<!ENTITY trader.arg.vfactor 'Fator de volume. Válido de 1 a 0.'>
<!ENTITY trader.arg.time.period 'Número de períodos. Valores válidos de 2 a 100000.'>
<!ENTITY trader.arg.fast.period 'Número de períodos para o MA rápido. Valores válidos de 2 a 100000.'>
<!ENTITY trader.arg.slow.period 'Número de períodos para o MA lento. Valores válidos de 2 a 100000.'>
<!ENTITY trader.arg.signal.period 'Amaciamento da linha de sinal (nb do período). Valores válidos de 1 a 100000.'>
<!ENTITY trader.arg.fastk.period 'Tempo de construção da linha Fast-K. Valores válidos de 1 a 100000.'>
<!ENTITY trader.arg.fastd.period 'Amaciamento na construção da linha Fast-D. Valores válidos de 1 a 100000, geralmente 3.'>
<!ENTITY trader.arg.slowk.period 'Amaciamento na construção da linha Slow-K. Valores válidos de 1 a 100000, geralmente 3.'>
<!ENTITY trader.arg.slowd.period 'Amaciamento na construção da linha Slow-D. Valores válidos de 1 a 100000.'>
<!ENTITY trader.arg.min.period 'Valor menor que o mínimo qual será modificado para Minimum period. Valores válidos de 2 a 100000'>
<!ENTITY trader.arg.max.period 'Valor maior que o mínimo qual será modificado para Maximum period. Valores válidos de 2 a 100000'>
<!ENTITY trader.arg.ma.type 'Tipo de Média Móvel. As <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> constantes devem ser utilizadas.'>
<!ENTITY trader.arg.fast.ma.type 'Tipo de Média Móvel para o MA rápido. As <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> constantes devem ser utilizadas.'>
<!ENTITY trader.arg.slow.ma.type 'Tipo de Média Móvel para o MA lento. As <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> constantes devem ser utilizadas.'>
<!ENTITY trader.arg.fastd.ma.type 'Tipo de Média Móvel para o Fast-D. As <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> constantes devem ser utilizadas.'>
<!ENTITY trader.arg.slowk.ma.type 'Tipo de Média Móvel para o Slow-K. As <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> constantes devem ser utilizadas.'>
<!ENTITY trader.arg.slowd.ma.type 'Tipo de Média Móvel para o Slow-D. As <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> constantes devem ser utilizadas.'>
<!ENTITY trader.arg.slowk.ma.type 'Tipo de Média Móvel para o Slow-K. As <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> constantes devem ser utilizadas.'>
<!ENTITY trader.arg.signal.ma.type 'Tipo de Média Móvel para a linha sinal. As <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> constantes devem ser utilizadas.'>
<!ENTITY trader.arg.nbdevup 'Deviation multiplier para a banda superior. Valores válidos de <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-min">TRADER_REAL_MIN</link> a <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-max">TRADER_REAL_MAX</link>.'>
<!ENTITY trader.arg.nbdevdn 'Deviation multiplier para a banda inferior. Valores válidos de <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-min">TRADER_REAL_MIN</link> a <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-max">TRADER_REAL_MAX</link>.'>
<!ENTITY trader.arg.fast.limit 'Limite superior a ser utilizado no algoritmo adaptativo. Valores válidos de 0.01 a 0.99.'>
<!ENTITY trader.arg.slow.limit 'Limite inferior a ser utilizado no algortimo adaptativo. Valores válidos de 0.01 a 0.99.'>

<!-- Mongo -->
<!ENTITY mongo.setreadpreference.parameters '<variablelist xmlns="http://docbook.org/ns/docbook"><varlistentry><term><parameter>read_preference</parameter></term><listitem><para>The read preference mode: <constant>MongoClient::RP_PRIMARY</constant>, <constant>MongoClient::RP_PRIMARY_PREFERRED</constant>, <constant>MongoClient::RP_SECONDARY</constant>, <constant>MongoClient::RP_SECONDARY_PREFERRED</constant>, ou <constant>MongoClient::RP_NEAREST</constant>.</para></listitem></varlistentry><varlistentry><term><parameter>tags</parameter></term><listitem><para>An array of zero or more tag sets, where each tag set is itself an array of criteria used to match tags on replica set members.</para></listitem></varlistentry></variablelist>'>
<!ENTITY mongo.setreadpreference.returnvalues '<para xmlns="http://docbook.org/ns/docbook">Returns &true; on success, or &false; otherwise.</para>'>
<!ENTITY mongo.setreadpreference.errors '<para xmlns="http://docbook.org/ns/docbook">Emits <constant>E_WARNING</constant> if either parameter is invalid, or if one or more tag sets are provided with the <constant>MongoClient::RP_PRIMARY</constant> read preference mode.</para>'>
<!ENTITY mongo.getreadpreference.returnvalues '<para xmlns="http://docbook.org/ns/docbook">This function returns an array describing the read preference. The array contains the values <literal>type</literal> for the string read preference mode (corresponding to the <classname>MongoClient</classname> constants), and <literal>tagsets</literal> containing a list of all tag set criteria. If no tag sets were specified, <literal>tagsets</literal> will not be present in the array.</para>'>
<!ENTITY mongo.setwriteconcern.parameters '<variablelist xmlns="http://docbook.org/ns/docbook"><varlistentry><term><parameter>w</parameter></term><listitem><para>The write concern. This may be an integer denoting the number of servers required to acknowledge the write, or a string mode (e.g. "majority").</para></listitem></varlistentry><varlistentry><term><parameter>wtimeout</parameter></term><listitem><para>The maximum number of milliseconds to wait for the server to satisfy the write concern.</para></listitem></varlistentry></variablelist>'>
<!ENTITY mongo.setwriteconcern.returnvalues '<para xmlns="http://docbook.org/ns/docbook">Returns &true; on success, or &false; otherwise.</para>'>
<!ENTITY mongo.setwriteconcern.errors '<para xmlns="http://docbook.org/ns/docbook">Emits <constant>E_WARNING</constant> if the <literal>w</literal> parameter is not an integer or string value.</para>'>
<!ENTITY mongo.getwriteconcern.returnvalues '<para xmlns="http://docbook.org/ns/docbook">This function returns an array describing the write concern. The array contains the values <literal>w</literal> for an integer acknowledgement level or string mode, and <literal>wtimeout</literal> denoting the maximum number of milliseconds to wait for the server to satisfy the write concern.</para>'>
<!ENTITY mongo.command.parameters.maxtimems '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"maxTimeMS"</literal></para><para>Specifies a cumulative time limit in milliseconds for processing the operation on the server (does not include idle time). If the operation is not completed by the server within the timeout period, a <classname>MongoExecutionTimeoutException</classname> will be thrown.</para></listitem>'>
<!ENTITY mongo.index.parameters.background '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"background"</literal></para><para>Builds the index in the background so that building an index does <emphasis>not</emphasis> block other database activities. Specify &true; to build in the background. The default value is &false;.</para><warning xmlns="http://docbook.org/ns/docbook"><para>Prior to MongoDB 2.6.0, index builds on secondaries were executed as foreground operations, irrespective of this option. See <link xlink:href="&url.mongodb.dochub.indexes.rs;" xmlns:xlink="http://www.w3.org/1999/xlink">Building Indexes with Replica Sets</link> for more information.</para></warning></listitem>'>
<!ENTITY mongo.index.parameters.dropdups '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"dropDups"</literal></para><para>Specify &true; to force creation of a unique index where the collection may contain duplicate values for a key. MongoDB will index the first occurrence of a key and delete all subsequent documents from the collection that contain a duplicate value for that key. The default value is &false;.</para><warning xmlns="http://docbook.org/ns/docbook"><para><literal>"dropDups"</literal> may delete data from your database. Use with extreme caution.</para></warning><note xmlns="http://docbook.org/ns/docbook"><para>This option is not supported on MongoDB 2.8+. Index creation will fail if the collection contains duplicate values.</para></note></listitem>'>
<!ENTITY mongo.index.parameters.expireafterseconds '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"expireAfterSeconds"</literal></para><para>The value of this option should specify the number of seconds after which a document should be considered expired and automatically removed from the collection. This option is only compatible with single-field indexes where the field will contain <classname>MongoDate</classname> values.</para><note xmlns="http://docbook.org/ns/docbook"><para>This feature is available in MongoDB 2.2+. See <link xlink:href="&url.mongodb.docs.expire_data;" xmlns:xlink="http://www.w3.org/1999/xlink">Expire Data from Collections by Setting TTL</link> for more information.</para></note></listitem>'>
<!ENTITY mongo.index.parameters.name '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"name"</literal></para><para>A optional name that uniquely identifies the index.</para><note xmlns="http://docbook.org/ns/docbook"><para>By default, the driver will generate an index name based on the index&apos;s field(s) and ordering or type. For example, a compound index <literal>array("x" => 1, "y" => -1)</literal> would be named <literal>"x_1_y_-1"</literal> and a geospatial index <literal>array("loc" => "2dsphere")</literal> would be named <literal>"loc_2dsphere"</literal>. For indexes with many fields, it is possible that the generated name might exceed MongoDB&apos;s <link xlink:href="&url.mongodb.docs.limits;#Index-Name-Length" xmlns:xlink="http://www.w3.org/1999/xlink">limit for index names</link>. The <literal>"name"</literal> option may be used in that case to supply a shorter name.</para></note></listitem>'>
<!ENTITY mongo.index.parameters.sparse '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"sparse"</literal></para><para>Specify &true; to create a sparse index, which only indexes documents containing a specified field. The default value is &false;.</para></listitem>'>
<!ENTITY mongo.index.parameters.unique '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"unique"</literal></para><para>Specify &true; to create a unique index. The default value is &false;. This option applies only to ascending/descending indexes.</para><note xmlns="http://docbook.org/ns/docbook"><para>When MongoDB indexes a field, if a document does not have a value for the field, a &null; value is indexed. If multiple documents do not contain a field, a unique index will reject all but the first of those documents. The <literal>"sparse"</literal> option may be used to overcome this, since it will prevent documents without the field from being indexed.</para></note></listitem>'>
<!ENTITY mongo.listcollections.note '<note xmlns="http://docbook.org/ns/docbook"><simpara>This method will use the <link xlink:href="&url.mongodb.dochub.listcollections;" xmlns:xlink="http://www.w3.org/1999/xlink">listCollections</link> database command when communicating with MongoDB 2.8+. For previous database versions, the method will query the special <literal>system.namespaces</literal> collection.</simpara></note>'>
<!ENTITY mongo.listcollections.parameters.filter '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"filter"</literal></para><para>Optional query criteria. If provided, this criteria will be used to filter the collections included in the result.</para><para>Relevant fields that may be queried include <literal>"name"</literal> (collection name as a string, without the database name prefix) and <literal>"options" (object containing options used to create the collection).</literal>.</para><note><simpara>MongoDB 2.6 and earlier versions require the <literal>"name"</literal> criteria, if specified, to be a string value (i.e. equality match). This is because the driver must prefix the value with the database name in order to query the <literal>system.namespaces</literal> collection. Later versions of MongoDB do not have this limitation, as the driver will use the listCollections command.</simpara></note></listitem>'>
<!ENTITY mongo.listcollections.parameters.includesystemcollections '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"includeSystemCollections"</literal></para><para>Boolean, defaults to &false;. Determines whether system collections should be included in the result.</para></listitem>'>
<!ENTITY mongo.writes.parameters.writeconcern '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"w"</literal></para><para>See <link linkend="mongo.writeconcerns">Write Concerns</link>. The default value for <classname>MongoClient</classname> is <literal>1</literal>.</para></listitem>'>
<!ENTITY mongo.writes.parameters.writeconcerntimeout '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"wtimeout"</literal></para><para>Deprecated alias for <literal>"wTimeoutMS"</literal>.</para></listitem>'>
<!ENTITY mongo.writes.parameters.writeconcerntimeoutms '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"wTimeoutMS"</literal></para><para>This option specifies the time limit, in milliseconds, for <link linkend="mongo.writeconcerns">write concern</link> acknowledgement. It is only applicable when <literal>"w"</literal> is greater than <literal>1</literal>, as the timeout pertains to replication. If the write concern is not satisfied within the time limit, a <classname>MongoCursorException</classname> will be thrown. A value of <literal>0</literal> may be specified to block indefinitely. The default value for <classname>MongoClient</classname> is <literal>10000</literal> (ten seconds).</para></listitem>'>
<!ENTITY mongo.writes.parameters.fsync '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"fsync"</literal></para><para>Boolean, defaults to &false;. If journaling is enabled, it works exactly like <literal>"j"</literal>. If journaling is not enabled, the write operation blocks until it is synced to database files on disk. If &true;, an acknowledged insert is implied and this option will override setting <literal>"w"</literal> to <literal>0</literal>.</para><note><simpara>If journaling is enabled, users are strongly encouraged to use the <literal>"j"</literal> option instead of <literal>"fsync"</literal>. Do not use <literal>"fsync"</literal> and <literal>"j"</literal> simultaneously, as that will result in an error.</simpara></note></listitem>'>
<!ENTITY mongo.writes.parameters.sockettimeoutms '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"socketTimeoutMS"</literal></para><para>This option specifies the time limit, in milliseconds, for socket communication. If the server does not respond within the timeout period, a <classname>MongoCursorTimeoutException</classname> will be thrown and there will be no way to determine if the server actually handled the write or not. A value of <literal>-1</literal> may be specified to block indefinitely. The default value for <classname>MongoClient</classname> is <literal>30000</literal> (30 seconds).</para></listitem>'>
<!ENTITY mongo.writes.parameters.journal '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"j"</literal></para><para>Boolean, defaults to &false;. Forces the write operation to block until it is synced to the journal on disk. If &true;, an acknowledged write is implied and this option will override setting <literal>"w"</literal> to <literal>0</literal>.</para><note><simpara>If this option is used and journaling is disabled, MongoDB 2.6+ will raise an error and the write will fail; older server versions will simply ignore the option.</simpara></note></listitem>'>
<!ENTITY mongo.writes.parameters.safe '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"safe"</literal></para><para>Deprecated. Please use the <link linkend="mongo.writeconcerns">write concern</link> <literal>"w"</literal> option.</para></listitem>'>
<!ENTITY mongo.writes.parameters.timeout '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"timeout"</literal></para><para>Deprecated alias for <literal>"socketTimeoutMS"</literal>.</para></listitem>'>
<!ENTITY mongo.errors.exceptions.writeconcern '<para xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoCursorException</classname> if the <literal>"w"</literal> option is set and the write fails.</para><para xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoCursorTimeoutException</classname> if the <literal>"w"</literal> option is set to a value greater than one and the operation takes longer than <varname>MongoCursor::$timeout</varname> milliseconds to complete.  This does not kill the operation on the server, it is a client-side timeout. The operation in <varname>MongoCollection::$wtimeout</varname> is milliseconds.</para>'>
<!ENTITY mongo.errors.deprecated '<para xmlns="http://docbook.org/ns/docbook">Issues <constant>E_DEPRECATED</constant> warning</para>'>
<!ENTITY mongo.gridfs.store.metadata.note '<note xmlns="http://docbook.org/ns/docbook"><para>These fields may also overwrite those that would be created automatically by the driver, as described in the MongoDB core documentation for the <link xlink:href="&url.mongodb.docs.gridfs;#the-files-collection" xmlns:xlink="http://www.w3.org/1999/xlink">files collection</link>. Some practical use cases for this behavior would be to specify a custom <literal>chunkSize</literal> or <literal>_id</literal> for the file.</para></note>'>
<!ENTITY mongo.gridfs.store.return '<para xmlns="http://docbook.org/ns/docbook">Returns the <literal>_id</literal> of the saved file document. This will be a generated <classname>MongoId</classname> unless an <literal>_id</literal> was explicitly specified in the <parameter>metadata</parameter> parameter.</para>'>
<!ENTITY mongo.mongowritebatch.writeoptions.description '<listitem xmlns="http://docbook.org/ns/docbook"><para>An array of Write Options.<informaltable><thead><row><entry>key</entry><entry>value meaning</entry></row></thead><tbody><row><entry>w (int|string)</entry><entry><link linkend="mongo.writeconcerns">Write concern</link> value</entry></row><row><entry>wtimeout (int)</entry><entry><link linkend="mongo.writeconcerns">Maximum time to wait for replication</link></entry></row><row><entry>ordered</entry><entry>Determines if MongoDB must apply this batch in order. Ordered writes execute serially (i.e. one at a time) and execution will stop after the first error. Unordered writes may execute in parallel and execution will not stop after the first error. Defaults to &true;</entry></row><row><entry>j (bool)</entry><entry>Wait for journaling on the primary. This value is discouraged, use WriteConcern instead</entry></row><row><entry>fsync (bool)</entry><entry>Wait for fsync on the primary. This value is discouraged, use WriteConcern instead</entry></row></tbody></informaltable></para></listitem>'>
<!ENTITY mongo.mongowritebatch.collection.description '<listitem xmlns="http://docbook.org/ns/docbook"><para>The <classname>MongoCollection</classname> to execute the batch on. Its <link linkend="mongo.writeconcerns">write concern</link> will be copied and used as the default write concern if none is given as <parameter>$write_options</parameter> or during <methodname>MongoWriteBatch::execute</methodname>.</para></listitem>'>
<!ENTITY mongo.context.server ' <varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>server</parameter> </term> <listitem> <para> An array containing the basic information about the server that was picked. <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>hash</entry> <entry>server hash, example: <literal>localhost:27017;-;X;56052</literal></entry> </row> <row> <entry>type</entry> <entry>Node type (primary/secondary/mongos/arbiter): <literal>2</literal></entry> </row> <row> <entry>max_bson_size</entry> <entry>The maximum BSON Size over the wire this node accepts: <literal>16777216</literal></entry> </row> <row> <entry>max_message_size</entry> <entry>The maximum Message Size over the wire this node accepts: <literal>48000000</literal></entry> </row> <row> <entry>request_id</entry> <entry>The request identifier for this message: <literal>42</literal></entry> </row> </tbody> </tgroup> </informaltable> </para> </listitem> </varlistentry>'>
<!ENTITY mongo.context.writeoptions '<varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>writeOptions</parameter> </term> <listitem> <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>ordered</entry> <entry>boolean, if the operation (in case of batch operation) must be executed sequentually (ordered=true)</entry> </row> <row> <entry>writeConcern</entry> <entry>An array of writeConcern options (see below)</entry> </row> </tbody> </tgroup> </informaltable> <table> <title>writeConcern array values</title> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>fsync</entry> <entry>boolean, force flushing to disk before returning</entry> </row> <row> <entry>j</entry> <entry>boolean, force journal write before returning</entry> </row> <row> <entry>wtimeout</entry> <entry>integer, milliseconds, maximum time the primary is allowed to wait to verify replication</entry> </row> <row> <entry>w</entry> <entry>integer=server count, or string=replication-tag</entry> </row> </tbody> </tgroup> </table> </para> </listitem> </varlistentry>'>
<!ENTITY mongo.context.protocoloptions ' <varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>protocolOptions</parameter> </term> <listitem> <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>message_length</entry> <entry>The total size (in bytes) of the encoded message being sent over the wire</entry> </row> <row> <entry>request_id</entry> <entry>The request identifier for this message: <literal>42</literal></entry> </row> <row> <entry>namespace</entry> <entry>The MongoDB namespace used for the protocol message <literal>dbname.collectionname</literal></entry> </row> </tbody> </tgroup> </informaltable> </para> </listitem> </varlistentry>'>
<!ENTITY mongo.alternative.class.note '<para
xmlns="http://docbook.org/ns/docbook">A extensão que define essa classe
está obsoleta. Alternativamente utilize a extensão <link linkend="set.mongodb">MongoDB</link> deve ser utilizada.
Alternativas a essa classe incluem:</para>'>
<!ENTITY mongo.noalternative.class.note '<para
xmlns="http://docbook.org/ns/docbook">A extensão que define esta classe
está obsoleta. Alternativamente utilize a extensão <link linkend="set.mongodb">MongoDB</link> deve ser utilizada.
Não há uma equivalente desta classe na nova extensão.</para>'>
<!ENTITY mongo.alternative.method.note '<para
xmlns="http://docbook.org/ns/docbook">A extensão que define esse método
está obsoleta. Alternativamente utilize a extensão <link linkend="set.mongodb">MongoDB</link> deve ser utilizada.
Alternativas a esse método incluem:</para>'>
<!ENTITY mongo.noalternative.method.note '<para
xmlns="http://docbook.org/ns/docbook">A extensão que define esse método
está obsoleta. Alternativamente a extensão <link linkend="set.mongodb">MongoDB</link> deve ser utilizada.
Não há um equivalente deste método na nova extensão.</para>'>
<!ENTITY mongo.alternative.phplib.note '<para
xmlns="http://docbook.org/ns/docbook">A extensão que define esse método
está obsoleta. Alternativamente, a extensão <link linkend="set.mongodb">MongoDB</link> deve ser utilizada.
Não há um equivalente deste método na nova extensão, mas exite uma
alternativa nas <link linkend="mongodb.overview">bibliotecas PHP</link>:</para>'>

<!ENTITY mongo.deprecated.note '<para
xmlns="http://docbook.org/ns/docbook">Esta extensão está obsoleta. Alternativamente a extensão
the <link linkend="set.mongodb">MongoDB</link> deve ser
utilizada.</para>'>

<!-- mongodb -->
<!ENTITY mongodb.changelog.tentative-return-types '
       <row xmlns="http://docbook.org/ns/docbook">
        <entry>PECL mongodb 1.15.0</entry>
        <entry>
         Tipos de retorno para métodos são declarados como provisórios no PHP 8.0 e mais recentes,
         acionando avisos de descontinuação no código que implementa essa interface
         sem declarar os tipos de retorno apropriados. O atributo <code>#[ReturnTypeWillChange]</code>
         pode ser adicionado para silenciar o aviso de descontinuação.
        </entry>
       </row>
'>

<!ENTITY mongodb.parameter.namespace '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>namespace</parameter> (<type>string</type>)</term>
    <listitem>
     <para>
      Um namespace completo (por exemplo <literal>"databaseName.collectionName"</literal>).
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.db '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>db</parameter> (<type>string</type>)</term>
    <listitem>
     <para>
      O nome do banco a executar o comando.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.bulkwrite '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>bulk</parameter> (<type>MongoDB\Driver\BulkWrite</type>)</term>
    <listitem>
     <para>
      O <classname>MongoDB\Driver\BulkWrite</classname> a executar.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.command '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>command</parameter> (<type>MongoDB\Driver\Command</type>)</term>
    <listitem>
     <para>
      O <classname>MongoDB\Driver\Command</classname> a executar.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.query '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>query</parameter> (<type>MongoDB\Driver\Query</type>)</term>
    <listitem>
     <para>
      A <classname>MongoDB\Driver\Query</classname> a executar.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.readPreference '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>readPreference</parameter> (<type>MongoDB\Driver\ReadPreference</type>)</term>
    <listitem>
     <para>
      Um <classname>MongoDB\Driver\ReadPreference</classname> para rotear o comando, opcional. Se nenhum informado, o padrão para Read Preferences é configurado no <link linkend="mongodb-driver-manager.construct-uri">URI de Conexão do MongoDB</link>.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.typeMap '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>typeMap</parameter> (<type>array</type>)</term>
    <listitem>
     <para>
      <link linkend="mongodb.persistence.typemaps">O mapeamento de tipos (Type)</link>.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.writeConcern '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>writeConcern</parameter></term>
    <listitem>
     <para>
Um <classname>MongoDB\Driver\WriteConcern</classname> opcional. Se nenhum informado, o padrão para Write Concern é configurado no <link linkend="mongodb-driver-manager.construct-uri">MongoDB Connection URI</link>.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.filter '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>filter</parameter> (<type>array|object</type>)</term>
    <listitem>
     <para>
      O filtro de busca.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.returns.cursor '<para xmlns="http://docbook.org/ns/docbook">Retorna <classname>MongoDB\Driver\Cursor</classname> no sucesso.</para>'>
<!ENTITY mongodb.returns.writeresult '<para xmlns="http://docbook.org/ns/docbook">Retorna <classname>MongoDB\Driver\WriteResult</classname> no sucesso.</para>'>
<!ENTITY mongodb.throws.std '&mongodb.throws.argumentparsing;&mongodb.throws.connection;&mongodb.throws.authentication;'>
<!ENTITY mongodb.throws.bulkwriteexception '<member xmlns="http://docbook.org/ns/docbook">Lança <classname>MongoDB\Driver\Exception\BulkWriteException</classname> em qualquer erro de escrita (erro de escrita, falha ao aplicar um write concern)</member>'>
<!ENTITY mongodb.throws.argumentparsing '<member xmlns="http://docbook.org/ns/docbook">Lança <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname> no caso de erros ao interpretar parâmetros.</member>'>
<!ENTITY mongodb.throws.authentication '<member xmlns="http://docbook.org/ns/docbook">Lança <classname>MongoDB\Driver\Exception\AuthenticationException</classname> se a autenticação é necessária e falha.</member>'>
<!ENTITY mongodb.throws.connection '<member xmlns="http://docbook.org/ns/docbook">Lança <classname>MongoDB\Driver\Exception\ConnectionException</classname> se a conexão com o servidor falhar (por razões outras que autenticação).</member>'>
<!ENTITY mongodb.note.getwriteerrors '
  <note xmlns="http://docbook.org/ns/docbook">
   <para>
    Quando ocorrer erros de escrita,
    <methodname>MongoDB\Driver\WriteResult::getWriteErrors</methodname>
    terá um único <classname>MongoDB\Driver\WriteError</classname> no
    array, e <methodname>MongoDB\Driver\WriteError::getIndex</methodname>
    será sempre 0 (o índice desta opção no lote de processamento).
   </para>
  </note>
'>
<!ENTITY mongodb.note.getupsertedids '
  <note xmlns="http://docbook.org/ns/docbook">
   <para>
    <methodname>MongoDB\Driver\WriteResult::getUpsertedIds</methodname> terá
    um único <classname>BSON\ObjectID</classname> no
    array, e o índice será sempre 0 (o índice desta operação no lote de processamento).
   </para>
  </note>
'>

<!ENTITY mongodb.option.let '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>let</entry>
          <entry><type class="union"><type>array</type><type>object</type></type></entry>
          <entry>
           <para>
            Mapa de nomes e valores de parâmetros. Os valores devem ser expressões constantes ou fechadas que não fazem referência a campos do documento. Os parâmetros podem então ser acessados como variáveis em um contexto de expressão agregada (e.g. <literal>$$var</literal>).
           </para>
           <para>
            Esta opção está disponível no MongoDB 5.0+ e resultará em uma exceção no tempo de execução se for especificada para uma versão de servidor mais antiga.
           </para>
          </entry>
         </row>
'>

<!ENTITY mongodb.option.encryption.masterKey-options-by-provider '
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title><literal>"aws"</literal> opções do provedor</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Type</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>region</entry>
       <entry>string</entry>
       <entry>Requerido.</entry>
      </row>
      <row>
       <entry>key</entry>
       <entry>string</entry>
       <entry>Requerido. O nome de recurso da Amazon (ARN) para a chave mestra do cliente (CMK) da AWS.</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>string</entry>
       <entry>Opcional. Um identificador de host alternativo para o qual enviar solicitações KMS. Pode incluir o número da porta.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title><literal>"azure"</literal> opções do provedor</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Type</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>keyVaultEndpoint</entry>
       <entry>string</entry>
       <entry>Requerido. Host com porta opcional (e.g. "example.vault.azure.net").</entry>
      </row>
      <row>
       <entry>keyName</entry>
       <entry>string</entry>
       <entry>Requerido.</entry>
      </row>
      <row>
       <entry>keyVersion</entry>
       <entry>string</entry>
       <entry>Opcional. Uma versão específica da chave nomeada. Padrões para usar a versão da chave primária.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title><literal>"gcp"</literal> opções do provedor</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Type</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>projectId</entry>
       <entry>string</entry>
       <entry>Requerido.</entry>
      </row>
      <row>
       <entry>location</entry>
       <entry>string</entry>
       <entry>Requerido.</entry>
      </row>
      <row>
       <entry>keyRing</entry>
       <entry>string</entry>
       <entry>Requerido.</entry>
      </row>
      <row>
       <entry>keyName</entry>
       <entry>string</entry>
       <entry>Requerido.</entry>
      </row>
      <row>
       <entry>keyVersion</entry>
       <entry>string</entry>
       <entry>Opcional. Uma versão específica da chave nomeada. O padrão é usar a versão principal da chave.</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>string</entry>
       <entry>Opcional. Host com porta opcional. O padrão é "cloudkms.googleapis.com".</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title><literal>"kmip"</literal> opções do provedor</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Type</entry>
       <entry>Description</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>keyId</entry>
       <entry>string</entry>
       <entry>Opcional. Identificador exclusivo para um objeto gerenciado de dados secretos KMIP de 96 bytes. Se não especificado, o driver cria um objeto gerenciado de dados secretos KMIP aleatório de 96 bytes.</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>string</entry>
       <entry>Opcional. Host com porta opcional.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
'>
<!ENTITY mongodb.option.encryption.tlsOptions '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>tlsOptions</entry>
          <entry><type>array</type></entry>
          <entry>
           <para>
            Um documento que contém a configuração TLS para um ou mais provedores KMS. Provedores suportados incluem <literal>"aws"</literal>, <literal>"azure"</literal>, <literal>"gcp"</literal> e <literal>"kmip"</literal>. Todos os provedores suportam as seguintes opções:
           </para>
           <programlisting role="javascript">
<![CDATA[
<provider>: {
    tlsCaFile: <optional string>,
    tlsCertificateKeyFile: <optional string>,
    tlsCertificateKeyFilePassword: <optional string>
}
]]>
           </programlisting>
          </entry>
         </row>
'>

<!ENTITY mongodb.note.queryable-encryption-preview '
   <note xmlns="http://docbook.org/ns/docbook">
    <simpara>
     A Criptografia Queryable está em visualização pública e disponível para propositos de avaliação
     Ainda não é recomendado para implantações de produção, pois alterações importantes
     podem ser introduzidas. Veja o post <link xlink:href="https://www.mongodb.com/blog/post/mongodb-releases-queryable-encryption-preview/" xmlns:xlink="http://www.w3.org/1999/xlink">Visualização de criptografia consultável</link> para mais informações.
    </simpara>
   </note>
'>

<!ENTITY mongodb.warning.duplicate-keys '
   <warning xmlns="http://docbook.org/ns/docbook">
    <simpara>
     Os documentos BSON podem tecnicamente conter chaves duplicadas porque os documentos são
     armazenado como uma lista de pares chave-valor; no entanto, as candidaturas devem abster-se
     da geração de documentos com chaves duplicadas como servidor e comportamento do driver
     pode ser indefinido. Como objetos e arrays PHP não podem ter chaves duplicadas,
     os dados também podem ser perdidos ao decodificar um documento BSON com chaves duplicadas.
    </simpara>
   </warning>
'>

<!-- Radius -->
<!ENTITY radius.request.required '<note xmlns="http://docbook.org/ns/docbook"><para>Uma requisição criada via <function>radius_create_request</function>, necessário para chamar essa função.</para></note>'>
<!ENTITY radius.parameter.attribute-type '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>type</parameter></term><listitem><para>O tipo de atributo.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.handle '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>radius_handle</parameter></term><listitem><para>O recurso RADIUS.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.options '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>options</parameter></term><listitem><para>Um bitmask de opções de atributos. As opções incluem <link linkend="constant.radius-option-tagged"><constant>RADIUS_OPTION_TAGGED</constant></link> e <link linkend="constant.radius-option-salt"><constant>RADIUS_OPTION_SALT</constant></link>.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.tag '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>tag</parameter></term><listitem><para>O atributo tag. Este parâmetro é ignorado a não ser que <link linkend="constant.radius-option-tagged"><constant>RADIUS_OPTION_TAGGED</constant></link> esteja indicado.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.vendor '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>vendor</parameter></term><listitem><para>O vendor ID.</para></listitem></varlistentry>'>

<!-- posix snippets -->
<!ENTITY posix.parameter.fd '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>fd</parameter></term>
 <listitem>
  <para>
   O descritor do arquivo, qual é esperado ser um
   <type>resource</type> de arquivo ou um <type>integer</type>. Um <type>integer</type>
   será interpretado como um descritor de arquivo que pode ser repassado diretamente
   à uma system call.
  </para>
  <para>
   Na maioria dos casos você deve prover um <type>resource</type> de arquivo.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY posix.rlimits '
<para xmlns="http://docbook.org/ns/docbook">
  Cada recurso está associado a um soft limit e um hard limit. O soft limit
  é o limite que o kernel restringe do
  recurso. O hard limit funciona com um teto máximo para o limite soft.
  Qualquer processo sem privilégios só pode pode configurar o soft limit
  entre zero e o hard limit, e irreversivelmente abaixo que o hard limit.
</para>
'>

<!-- strings snippets -->
<!ENTITY strings.parameter.encoding '
 <para xmlns="http://docbook.org/ns/docbook">
  Argumento opcional definindo a codificação utilizada na conversão de caracteres.
 </para>

 <para xmlns="http://docbook.org/ns/docbook">
  Se omitido o valor padrão de <parameter>encoding</parameter> varia
  dependendo da versão do PHP em uso. No PHP 5.6 e posteriores a configuração
  <link linkend="ini.default-charset">default_charset</link>
  é utilizada como valor padrão. No PHP 5.4 e 5.5 será utilizado
  <literal>UTF-8</literal> como padrão. Versões anteriores utilizarão
  <literal>ISO-8859-1</literal>.
 </para>

 <para xmlns="http://docbook.org/ns/docbook">
  Embora esse parâmetro seja tecnicamente opcional, é altamente recomendável
  especificar o valor correto em seu código se estiver utilizando o PHP 5.5 ou anteriores,
  ou se a opção <link linkend="ini.default-charset">default_charset</link>
  estiver incorretamente configurada para uma entrada específico.
 </para>
'>

<!ENTITY strings.changelog.encoding '
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>5.6.0</entry>
  <entry>
   O valor padrão do parâmetro <parameter>encoding</parameter> foi
   modificado para ser o valor da configuração
   <link linkend="ini.default-charset">default_charset</link>.

  </entry>
 </row>
'>

<!ENTITY strings.scanf.parameter.format '
<varlistentry xmlns="http://docbook.org/ns/docbook">
     <term><parameter>format</parameter></term>
     <listitem>
      <para>
       O formato interpretado para <parameter>string</parameter>, que é
       descrito na documentação para <function>sprintf</function> com
       seguintes diferenças:
       <simplelist>
        <member>
         A função não reconhece a localidade.
        </member>
        <member>
         <literal>F</literal>, <literal>g</literal>, <literal>G</literal> e
         <literal>b</literal> não são suportados.
        </member>
        <member>
         <literal>D</literal> significa número decimal.
        </member>
        <member>
         <literal>i</literal> significa inteiro com detecção de base.
        </member>
        <member>
         <literal>n</literal> representa o número de caracteres processados até agora.
        </member>
        <member>
         <literal>s</literal> pára de ler em qualquer caractere de espaço em branco.
        </member>
        <member>
         <literal>*</literal> ao invés de <literal>argnum$</literal> suprime
         a atribuição desta especificação de conversão.
        </member>
       </simplelist>
      </para>
     </listitem>
    </varlistentry>
'>

<!ENTITY strings.changelog.ascii-case-conversion '
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>8.2.0</entry>
  <entry>
   A conversão de maiúsculas e minúsculas não depende mais da localidade definida com
   <function>setlocale</function>. Somente caracteres ASCII serão convertidos.
  </entry>
 </row>
'>

<!ENTITY strings.changelog.ascii-case-folding '
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>8.2.0</entry>
  <entry>
   A dobragem de caixa não depende mais da localidade definida com
   <function>setlocale</function>. Somente a dobragem de maiúsculas e minúsculas ASCII será feita.
   Os bytes não ASCII serão comparados por seu valor de byte.
  </entry>
 </row>
'>

<!-- filter snippets -->
<!ENTITY filter.param.filter '
 <varlistentry xmlns="http://docbook.org/ns/docbook">
  <term><parameter>filter</parameter></term>
  <listitem>
   <para>
    O ID do filtro a ser aplicado. Veja <xref linkend="filter.filters" />
    para uma lista dos filtros disponíveis.
   </para>
   <para>
    Se omitido <constant>FILTER_DEFAULT</constant> será utilizado, o que é
    equivalente a
    <link linkend="filter.filters.sanitize"><constant>FILTER_UNSAFE_RAW</constant></link>.
    Isto resultará em nenhum filtro aplicado.
   </para>
  </listitem>
 </varlistentry>
'>

<!-- csprng snippets -->
<!ENTITY csprng.sources '
<para xmlns="http://docbook.org/ns/docbook">
 As fontes de aleatoriedade dessa função são:
</para>
<itemizedlist xmlns="http://docbook.org/ns/docbook">
 <listitem>
  <simpara>
   No Windows, a função
   <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.csprng.crypt-gen-random;"><function>CryptGenRandom</function></link>
   sempre será utilizada.
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   No Linux, a syscall
   <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.csprng.get-random-2;">getrandom(2)</link>
   será utilizada se disponível.
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   Em outras plataformas <filename>/dev/urandom</filename> será utilizada.
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   Se nenhuma das fontes acima estiver disponível, então uma
   <classname>Random\RandomException</classname> será lançada.
  </simpara>
 </listitem>
</itemizedlist>
'>
<!ENTITY csprng.errors '
 <listitem xmlns="http://docbook.org/ns/docbook">
  <simpara>
   Se uma fonte de aleatoriedade não for encontrada
   uma <classname>Random\RandomException</classname> será lançada.
  </simpara>
 </listitem>
 <listitem xmlns="http://docbook.org/ns/docbook">
  <simpara>
    No caso de parâmetros inválidos um <classname>TypeError</classname>
    será lançado.
  </simpara>
 </listitem>
'>
<!ENTITY csprng.function.backport '
 <note xmlns="http://docbook.org/ns/docbook">
  <simpara>
   Embora essa função tenha sido adicionado no PHP 7.0, existe
   <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.csprng.compat;">implementação userland</link>
   disponível para PHP 5.2 ao 5.6.
  </simpara>
 </note>
'>


<!-- Migration Guide snippets -->
<!ENTITY migration56.openssl.peer-verification '
   <para xmlns="http://docbook.org/ns/docbook">
    Todos os streams criptografados agora tem verificação de peer ativado por padrão. Assim,
    a coleção de CAs padrão do OpenSSL será utilizado para verificar o certificado
    do peer. Na maioria dos casos, não será necessário modificações para se comunicar
    com servidores com certificados válidos pois as distribuições geralmente
    configuram o OpenSSL com boas coleções de CA.
   </para>

   <para xmlns="http://docbook.org/ns/docbook">
    A coleção de CAs padrão pode ser substituída globalmente configurando-se
    as diretivas openssl.cafile ou openssl.capath, ou
    por requisição utilizando-se as ações
    <link linkend="context.ssl.cafile"><parameter>cafile</parameter></link> ou
    <link linkend="context.ssl.capath"><parameter>capath</parameter></link>
    no parâmetro contexto.
   </para>

   <para xmlns="http://docbook.org/ns/docbook">
    Embora não recomendado no geral, é possível desabilitar a verificação de certificado
    do peer numa requisição configurando-se a opção de contexto
    <link linkend="context.ssl.verify-peer"><parameter>verify_peer</parameter></link>
    para &false;, e até desabilitar a verificação do nome do peer configurando-se a opção
    <link linkend="context.ssl.verify-peer-name"><parameter>verify_peer_name</parameter></link>
    para false &false;.
   </para>
'>

<!-- Random snippets -->
<!ENTITY random.engineErrors '
 <listitem xmlns="http://docbook.org/ns/docbook">
  <simpara>
   Qualquer <classname>Throwable</classname> lançado pelo método <methodname>Random\Engine::generate</methodname>
   do <link linkend="random-randomizer.props.engine"><literal>Random\Randomizer::$engine</literal></link> subjacente.
  </simpara>
 </listitem>
'>

<!-- 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: fen fdm=syntax fdl=2 si
vim: et tw=78
vi: ts=1 sw=1
-->