language-snippets.ent

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 19e23dc364880a2d85249c9eb3e20c4411e1c30c Maintainer: adiel Status: ready --><!-- CREDITS: adiel, ae, atomotavio, fabioluciano, felipe, klaussilveira, rafaelbernard, leonardolara, fernandowobeto -->

<!ENTITY installation.enabled.disable 'Esta extensão está habilitada por padrão. Ela pode ser desabilitada usando a seguinte opção em tempo de compilação: '>

<!-- 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 fins que exijam que os valores retornados sejam impossíveis de adivinhar.
 </para>
 <para>
  Se aleatoriedade criptograficamente segura for necessária, a classe <classname>Random\Randomizer</classname> pode ser
  usada com o mecanismo <classname>Random\Engine\Secure</classname>. Para casos de uso simples, as funções <function>random_int</function>
  e <function>random_bytes</function> fornecem uma <acronym>API</acronym> conveniente e segura que é garantida pelo
  <acronym>CSPRNG</acronym> do sistema operacional.
 </para>
</caution>'>

<!ENTITY caution.mt19937-tiny-seed '<caution xmlns="http://docbook.org/ns/docbook">
 <para>
  Como o mecanismo Mt19937 (“Mersenne Twister”) aceita apenas um único inteiro de 32 bits como
  semente, o número de sequências aleatórias possíveis é limitado a apenas 2<superscript>32</superscript>
  (ou seja, 4.294.967.296), embora o Mt19937 possua um gigantesco período de 2<superscript>19937</superscript>-1.
 </para>
 <para>
  Ao depender da geração aleatória implícita ou explícita de sementes, as duplicações aparecerão
  muito mais cedo. Sementes duplicadas são esperadas com probabilidade de 50&#37; depois de menos de
  80.000 sementes geradas aleatoriamente de acordo com o problema do aniversário. Uma probabilidade de 10&#37;
  de uma semente duplicada acontece depois de gerar aleatoriamente cerca de 30.000 sementes.
 </para>
 <para>
  Isso torna o Mt19937 inadequado para aplicações em que sequências duplicadas não devem ocorrer com
  mais do que uma probabilidade desprezível. Se a geração reproduzível de sementes for necessária, ambos os mecanismos
  <classname>Random\Engine\Xoshiro256StarStar</classname> e <classname>Random\Engine\PcgOneseq128XslRr64</classname>
  suportam sementes muito maiores que são improváveis de colidir aleatoriamente. Se a reprodutibilidade
  não for necessária, o mecanismo <classname>Random\Engine\Secure</classname> fornece aleatoriedade
  criptograficamente segura.
 </para>
</caution>'>

<!-- Notes -->

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

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

<!ENTITY note.context-support '<para xmlns="http://docbook.org/ns/docbook">Um <type>resource</type> de
<link linkend="stream.contexts">contexto de stream</link>.</para>'>

<!ENTITY note.exec-bg '<note xmlns="http://docbook.org/ns/docbook"><para>Se um programa for iniciado com esta função,
para que continue rodando em segundo plano, a saída do
programa deve ser redirecionada para um arquivo ou outro stream de saída. Deixar de fazer isso
fará com que o PHP trave 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, a função <function>exec</function>
primeiro iniciará o cmd.exe para executar o comando. Se desejar iniciar um programa externo sem iniciar o cmd.exe,
use a função <function>proc_open</function> com o parâmetro <parameter>bypass_shell</parameter> definido.</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 nomes de arquivos, como <literal>&lt;|&gt;*?":</literal>. Nomes de arquivos que terminam com ponto
também não são suportados. Ao contrário de algumas ferramentas de extração, este método não substitui estes caracteres por
um sublinhado, mas falha ao extrair esses arquivos.</para></note>'>

<!ENTITY note.func-callback '<note xmlns="http://docbook.org/ns/docbook"><simpara>Em vez de um nome de função, um
array contendo uma referência de objeto e um 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 se houver uma exceção não capturada que foi 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,
qualquer alteração nos argumentos será refletida 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.func-named-params '<note xmlns="http://docbook.org/ns/docbook"><para>A partir do PHP 8.0.0, a família de funções
func_*() deve 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 valores padrão.
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>Se o PHP não estiver reconhecendo corretamente
os finais de linha ao ler arquivos em um computador Macintosh ou que foram criados
em um, habilitar a opção de configuração em tempo de execuçã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á em
<link linkend="features.remote-files">arquivos remotos</link>, pois o arquivo a
ser examinado deve ser acessível através do 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
atribui novas chaves aos elementos do <parameter>array</parameter>.
Ela removerá todas as chaves existentes que possam ter sido atribuídas, em vez
de apenas reordenar as chaves.</simpara></note>'>

<!ENTITY note.no-windows '<note xmlns="http://docbook.org/ns/docbook"><simpara>Esta função não foi
implementada em plataformas Windows.</simpara></note>'>

<!ENTITY note.no-windows.extension '<note xmlns="http://docbook.org/ns/docbook"><simpara>Esta extensão não está
disponível em plataformas 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 o recurso ZTS (Zend Thread Safety) habilitado. Para verificar se sua cópia do PHP foi compilada com o ZTS habilitado, use o comando <command>php -i</command> ou teste a constante <constant>PHP_ZTS</constant>.</simpara></note>'>

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

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

<!ENTITY note.uses-ob '<note xmlns="http://docbook.org/ns/docbook"><para>Quando o parâmetro <parameter>return</parameter>
é usado, esta função usa um buffer de saída interno, portanto não pode ser usada em uma função
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>
é usado, esta função usa um buffer de saída interno antes do PHP 7.1.0, portanto não pode ser usada em uma função
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 variar
de um sistema de arquivos para outro.</para></note>'>

<!ENTITY note.uses-autoload '<note xmlns="http://docbook.org/ns/docbook">
<para>Usar esta função fará com que qualquer
<link linkend="language.oop5.autoload">autoloader</link> registrado seja usado se a classe ainda não for conhecida.</para></note>'>

<!ENTITY note.network.header.sapi '<note xmlns="http://docbook.org/ns/docbook">
   <para>
    Os cabeçalhos só serão acessíveis e enviados quando uma 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 valor retornado por esta função é indefinido.
 </para>
</note>
'>

<!ENTITY note.sort-unstable '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  Se dois elementos são comparados como iguais, eles mantêm sua ordem original.
  Antes do PHP 8.0.0, sua ordem relativa no array ordenado era indefinida.
 </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.resource-migration-8.0-dead-function '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  Esta função não tem efeito. Antes do PHP 8.0.0, esta função era usada para fechar o recurso.
 </para>
</note>
'>

<!-- Tips -->

<!ENTITY tip.fopen-wrapper '<tip xmlns="http://docbook.org/ns/docbook"><simpara>Uma URL pode ser usada como um
nome de arquivo com esta função se os <link linkend="ini.allow-url-fopen"
>wrappers fopen</link> estiverem habilitados.
Consulte a função <function>fopen</function> para mais detalhes sobre como especificar
o nome do arquivo. Consulte os <xref linkend="wrappers"/> para obter links para informações
sobre as capacidades de cada wrapper, notas de uso
e informações sobre quaisquer variáveis predefinidas que eles possam
fornecer.</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 usada com <emphasis>alguns</emphasis> wrappers URL. Consulte os
<xref linkend="wrappers"/> para determinar quais wrappers suportam
a família de funções <function>stat</function>.</simpara></tip>'>

<!ENTITY tip.ob-capture '<tip xmlns="http://docbook.org/ns/docbook"><simpara>Assim como qualquer coisa que envia
seu resultado diretamente para o navegador, as <link
linkend="book.outcontrol">funções de controle de saída</link> podem ser usadas para capturar
a saída desta função e salvá-la 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>Ao permitir que os dados fornecidos pelo usuário sejam
passados para esta função, use
<function>escapeshellarg</function> ou <function>escapeshellcmd</function>
para garantir que os usuários não possam induzir o sistema a executar 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
os nomes de suas funções e qualquer outra documentação relacionada a esta
extensão, pode mudar sem aviso prévio em futuras versões do PHP.
Use por sua conta e risco.</simpara></warning>'>

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

<!ENTITY warn.deprecated.feature-5-6-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Este recurso tornou-se
<emphasis>OBSOLETO</emphasis> a partir do PHP 5.6.0. O uso deste recurso
é fortemente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-1-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Este recurso tornou-se
<emphasis>OBSOLETO</emphasis> a partir do PHP 7.1.0. O uso deste recurso
é fortemente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-1-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função tornou-se
<emphasis>OBSOLETA</emphasis> a partir do PHP 7.1.0. O uso desta função
é fortemente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-0-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função tornou-se
<emphasis>OBSOLETA</emphasis> a partir do PHP 7.0.0 e foi
<emphasis>REMOVIDA</emphasis> a partir do PHP 8.0.0. O uso desta função
é fortemente 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 tornou-se
<emphasis>OBSOLETA</emphasis> a partir do PHP 7.1.0 e foi
<emphasis>REMOVIDA</emphasis> a partir do PHP 7.2.0. O uso desta função
é fortemente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Este recurso tornou-se
<emphasis>OBSOLETO</emphasis> a partir do PHP 7.2.0. O uso deste recurso
é fortemente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-2-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Este recurso tornou-se
<emphasis>OBSOLETO</emphasis> a partir do PHP 7.2.0 e foi <emphasis>REMOVIDO</emphasis> a partir do PHP 8.0.0. O uso deste recurso
é fortemente 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 tornou-se
<emphasis>OBSOLETA</emphasis> a partir do PHP 7.2.0 e foi <emphasis>REMOVIDA</emphasis> a partir do PHP 8.0.0. O uso desta função
é fortemente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Este recurso tornou-se
<emphasis>OBSOLETO</emphasis> a partir do PHP 7.3.0. O uso deste recurso
é fortemente 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 tornou-se
<emphasis>OBSOLETA</emphasis> a partir do PHP 7.3.0 e foi <emphasis>REMOVIDA</emphasis> a partir do PHP 8.0.0. O uso desta função
é fortemente 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 tornou-se
<emphasis>OBSOLETA</emphasis> a partir do PHP 7.4.0 e foi <emphasis>REMOVIDA</emphasis> a partir do PHP 8.0.0. O uso desta função
é fortemente desencorajado.</simpara></warning>'>

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

<!ENTITY warn.deprecated.function-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função tornou-se
<emphasis>OBSOLETA</emphasis> a partir do PHP 8.0.0. O uso desta função
é fortemente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-1-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função tornou-se
<emphasis>OBSOLETA</emphasis> a partir do PHP 8.1.0. O uso desta função
é fortemente desencorajado.</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função tornou-se
<emphasis>OBSOLETA</emphasis> a partir do PHP 8.2.0. O uso desta função
é fortemente desencorajado.</simpara></warning>'>

 <!ENTITY warn.deprecated.feature-8-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Este recurso tornou-se
<emphasis>OBSOLETO</emphasis> a partir do PHP 8.3.0. O uso deste recurso
é fortemente desencorajado.</simpara></warning>'>

 <!ENTITY warn.deprecated.function-8-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função tornou-se
<emphasis>OBSOLETA</emphasis> a partir do PHP 8.3.0. O uso desta função
é fortemente desencorajado.</simpara></warning>'>

<!ENTITY removed.php.future 'Este recurso obsoleto certamente
<emphasis xmlns="http://docbook.org/ns/docbook">será removido</emphasis> no futuro.'>

<!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. O uso
deste apelido é fortemente desencorajado.</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 tornou-se
<emphasis>OBSOLETO</emphasis> a partir do PHP 7.2.0 e foi <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 tornou-se
<emphasis>OBSOLETO</emphasis> a partir do PHP 7.4.0 e foi <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 tornou-se
<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 foi
<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 desta função, seu nome e
documentação poderão mudar sem aviso prévio em futuras versões do PHP.
Use por sua 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 usadas em conjunto, pois
compartilham os mesmos símbolos internos. Observação: a Yaz 2.0 e superiores não sofrem deste problema.</simpara></warning>'>

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

<!ENTITY warn.passwordhashing '
<warning xmlns="http://docbook.org/ns/docbook">
 <para>
  Não é recomendado usar esta função para proteger senhas,
  devido à natureza rápida deste algoritmo de hash. Consulte as
  <link linkend="faq.passwords.fasthash">Perguntas Frequentes sobre Hashing de Senha</link>
  para obter detalhes e melhores práticas.
 </para>
</warning>
'>

<!ENTITY warn.ssl-non-standard '<warning xmlns="http://docbook.org/ns/docbook"><para>Ao usar SSL, o Microsoft IIS
violará o protocolo fechando a conexão sem enviar uma notificação
<literal>close_notify</literal>. O PHP reportará isso como "SSL: Fatal
Protocol Error" quando chegar ao final dos dados. Para contornar isso, o
valor de <link linkend="ini.error-reporting">error_reporting</link> deve ser
reduzido a um nível que não inclua avisos.
O PHP pode detectar servidores IIS defeituosos quando o stream
é aberto usando o wrapper <literal>https://</literal> e suprimirá o aviso.
Ao usar <function>fsockopen</function> para criar um soquete
<literal>ssl://</literal>, o desenvolvedor é responsável por detectar
e suprimir este aviso.</para></warning>'>

<!ENTITY warn.undocumented.func '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Esta função não
está documentada; apenas 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.feature.7-1-0.removed.7-2-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Este recurso tornou-se <emphasis>OBSOLETO</emphasis> a partir do PHP 7.1.0 e foi
 <emphasis>REMOVIDO</emphasis> a partir do 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 tornou-se <emphasis>OBSOLETA</emphasis> a partir do PHP 7.1.0 e foi
 <emphasis>REMOVIDA</emphasis> a partir do PHP 7.2.0.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternativas a esta função incluem:
</para>
'>

<!ENTITY warn.deprecated.function-8-1-0.alternatives '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função tornou-se
<emphasis>OBSOLETA</emphasis> a partir do PHP 8.1.0. O uso desta função
é fortemente desencorajado.</simpara></warning>
<para xmlns="http://docbook.org/ns/docbook">
 Alternativas a esta função incluem:
</para>
'>

<!-- Misc -->

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

<!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 produzirá:</para>'>

<!ENTITY example.outputs.5 '<para xmlns="http://docbook.org/ns/docbook">Saída do exemplo acima no PHP 5:</para>'>

<!ENTITY example.outputs.55 '<para xmlns="http://docbook.org/ns/docbook">Saída do exemplo acima no PHP 5.5:</para>'>

<!ENTITY example.outputs.56 '<para xmlns="http://docbook.org/ns/docbook">Saída do exemplo acima no PHP 5.6:</para>'>

<!ENTITY example.outputs.7 '<para xmlns="http://docbook.org/ns/docbook">Saída do exemplo acima no PHP 7:</para>'>

<!ENTITY example.outputs.70 '<para xmlns="http://docbook.org/ns/docbook">Saída do exemplo acima no PHP 7.0:</para>'>

<!ENTITY example.outputs.71 '<para xmlns="http://docbook.org/ns/docbook">Saída do exemplo acima no PHP 7.1:</para>'>

<!ENTITY example.outputs.72 '<para xmlns="http://docbook.org/ns/docbook">Saída do exemplo acima no PHP 7.2:</para>'>

<!ENTITY example.outputs.73 '<para xmlns="http://docbook.org/ns/docbook">Saída do exemplo acima no PHP 7.3:</para>'>

<!ENTITY example.outputs.8 '<para xmlns="http://docbook.org/ns/docbook">Saída do exemplo acima no PHP 8:</para>'>

<!ENTITY example.outputs.8.similar '<para xmlns="http://docbook.org/ns/docbook">A saída do exemplo acima no PHP 8 é semelhante a:</para>'>

<!ENTITY example.outputs.80 '<para xmlns="http://docbook.org/ns/docbook">Saída do exemplo acima no PHP 8.0:</para>'>

<!ENTITY example.outputs.81 '<para xmlns="http://docbook.org/ns/docbook">Saída do exemplo acima no PHP 8.1:</para>'>

<!ENTITY example.outputs.82 '<para xmlns="http://docbook.org/ns/docbook">Saída do exemplo acima no PHP 8.2:</para>'>

<!ENTITY example.outputs.82.similar '<para xmlns="http://docbook.org/ns/docbook">A saída do exemplo acima no PHP 8.2 é semelhante a:</para>'>

<!ENTITY example.outputs.32bit '<para xmlns="http://docbook.org/ns/docbook">Saída do exemplo acima em máquinas de 32 bits:</para>'>

<!ENTITY example.outputs.64bit '<para xmlns="http://docbook.org/ns/docbook">Saída do exemplo acima em máquinas de 64 bits:</para>'>

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

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

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

<!ENTITY array.resetspointer '<note xmlns="http://docbook.org/ns/docbook"><simpara>Após o uso desta função,
assim como na função <function>reset</function>, o ponteiro interno do <type>array</type> fornecido apontará para o
primeiro elemento.</simpara></note>'>

<!ENTITY array.changelog.by-ref '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Se a funçã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 '<link xmlns="http://docbook.org/ns/docbook" linkend="array.sorting">Comparação entre as funções de ordenação de array</link>'>

<!ENTITY sort.flags.parameter '<varlistentry xmlns="http://docbook.org/ns/docbook">
  <term><parameter>flags</parameter></term>
  <listitem>
   <para>
    O segundo parâmetro opcional <parameter>flags</parameter>
    pode ser usado para modificar o comportamento da ordenação usando estes valores:
   </para>
   <para>
    Flags dos tipos de ordenação:
    <itemizedlist>
     <listitem>
      <simpara><constant>SORT_REGULAR</constant> - compara os elementos normalmente;
      os detalhes são descritos na seção <link linkend="language.operators.comparison">operadores de comparação</link></simpara>
     </listitem>
     <listitem>
      <simpara><constant>SORT_NUMERIC</constant> - compara os elementos numericamente</simpara>
     </listitem>
     <listitem>
      <simpara><constant>SORT_STRING</constant> - compara os elementos como strings</simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>SORT_LOCALE_STRING</constant> - compara os elementos como
       strings, com base na localidade atual. A localidade
       pode ser alterada usando <function>setlocale</function>
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>SORT_NATURAL</constant> - compara os elementos como strings
       usando "ordenação natural" como <function>natsort</function>
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       <constant>SORT_FLAG_CASE</constant> - pode ser combinada
       (usando o operador bit a bit OR) com
       <constant>SORT_STRING</constant> ou
       <constant>SORT_NATURAL</constant> para ordenar strings sem fazer distinção entre maiúsculas e minúsculas
      </simpara>
     </listitem>
    </itemizedlist>
   </para>
  </listitem>
 </varlistentry>
'>

<!ENTITY sort.callback.description '<para xmlns="http://docbook.org/ns/docbook">
 &return.callbacksort;
</para>
&callback.cmp;
<caution xmlns="http://docbook.org/ns/docbook">
 <para>
  Retornar valores <emphasis>não inteiros</emphasis> da função de
  comparação, como <type>float</type>, resultará em uma conversão interna
  do valor retornado da função callback para <type>int</type>. Portanto, valores como
  <literal>0.99</literal> e <literal>0.1</literal> serão convertidos para o
  valor inteiro <literal>0</literal>, o que comparará esses valores como iguais.
 </para>
</caution>'>

<!ENTITY ini.shorthandbytes '<simpara xmlns="http://docbook.org/ns/docbook">Quando um <type>int</type> é usado, o
valor é medido em bytes. A notação abreviada, como descrita
<link linkend="faq.using.shorthandbytes">nesta FAQ</link>, também pode 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 ext.windows.path.dll 'Para que esta extensão funcione, existem arquivos
<acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym> que devem estar disponíveis no
<envar xmlns="http://docbook.org/ns/docbook">PATH</envar> do sistema Windows. Para saber como fazer isso, veja a
<acronym xmlns="http://docbook.org/ns/docbook">FAQ</acronym> intitulada "<link
xmlns="http://docbook.org/ns/docbook" linkend="faq.installation.addtopath">Como eu adiciono o meu diretório PHP ao PATH
do Windows</link>". Embora copiar arquivos DLL
da pasta do PHP para o diretório system do Windows também funcione
(porque o diretório system está, por padrão, no <envar xmlns="http://docbook.org/ns/docbook">PATH</envar> do sistema),
isso não é recomendado.
<emphasis xmlns="http://docbook.org/ns/docbook">Esta extensão requer que os seguintes arquivos estejam no
<envar>PATH</envar>:</emphasis> '>

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

<!ENTITY style.oop 'Estilo orientado a objetos'>
<!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 match '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.match">match</link>'>

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

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

<!ENTITY parameter.use_include_path 'Quando definido 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.type.true '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.2.0</entry>
 <entry>
  O tipo do retorno agora é &true;; anteriormente, era <type>bool</type>.
 </entry>
</row>'>

<!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&return.falseforfailure;.'>

<!ENTITY return.nullorfalse 'Retorna &null; em caso de sucesso&return.falseforfailure;.'>

<!ENTITY return.void 'Nenhum valor é retornado.'>

<!ENTITY return.true.always 'Sempre retorna &true;.'>

<!ENTITY return.callbacksort 'A função de comparação deve retornar um inteiro menor que, igual ou maior que zero se o primeiro argumento for considerado respectivamente menor que, igual ou maior que o segundo.'>

<!ENTITY return.falseproblem '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Esta função pode
retornar o valor booleano &false;, mas também pode retornar um valor não booleano que pode ser
avaliado como &false;. Leia a seção sobre <link
linkend="language.types.boolean">Booleanos</link> para mais
informações. Use o <link 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>
  Chamar esta função em &object;s tornou-se obsoleto.
  Converta o &object; para um &array; usando <function>get_mangled_object_vars</function> primeiro ou, em vez disso, use os métodos
  fornecidos por uma classe que implementa <interfacename>Iterator</interfacename>, como <classname>ArrayIterator</classname>.
   </entry>
</row>
<row xmlns="http://docbook.org/ns/docbook">
 <entry>7.4.0</entry>
 <entry>
  Instâncias de classes <link xmlns="http://docbook.org/ns/docbook" linkend="book.spl">SPL</link> agora são tratadas como objetos vazios que não possuem propriedades em vez de chamar o método da interface <interfacename>Iterator</interfacename> com o mesmo nome desta função.
 </entry>
</row>
'>

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

<!-- FileInfo -->
<!ENTITY fileinfo.parameters.finfo '<para xmlns="http://docbook.org/ns/docbook">Uma instância de <classname>finfo</classname>, retornada por <function>finfo_open</function>.</para>'>
<!ENTITY fileinfo.changelog.finfo-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  O parâmetro <parameter>finfo</parameter> agora espera uma instância de <classname>finfo</classname>;
  anteriormente, um &resource; era esperado.
 </entry>
</row>'>

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

<!ENTITY openssl.param.csr '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>csr</parameter></term>
 <listitem>
  <para>
   Consulte <link linkend="openssl.certparams">Parâmetros CSR</link> para obter uma lista de valores válidos.
  </para>
 </listitem>
</varlistentry>'>

<!-- Image (GD) Notes -->

<!ENTITY note.freetype '<note xmlns="http://docbook.org/ns/docbook"><simpara>Esta função só estará disponível se
o PHP for 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 de imagens GD.</para></note>'>

<!ENTITY note.gd.interpolation '<note xmlns="http://docbook.org/ns/docbook"><para>Esta função é afetada pelo método de interpolação definido por <function>imagesetinterpolation</function>.</para></note>'>

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

<!ENTITY gd.font.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>font</parameter></term><listitem><para>Pode ser 1, 2, 3, 4, 5 para as fontes
nativas na codificação latin2 (onde números maiores correspondem a fontes maiores) ou uma instância de <classname>GdFont</classname>,
retornada por <function>imageloadfont</function>.</para></listitem></varlistentry>'>

<!ENTITY gd.changelog.gdfont-instance '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.1.0</entry>
  <entry>
  O parâmetro <parameter>font</parameter> agora aceita uma instância de <classname>GdFont</classname>
  ou um &integer;; anteriormente, apenas &integer; era aceito.
  </entry>
</row>'>

<!ENTITY gd.ttf.fontfile "
    <varlistentry xmlns='http://docbook.org/ns/docbook'>
     <term><parameter>fontfile</parameter></term>
     <listitem>
      <para>
       O caminho para a fonte TrueType que será usada.
      </para>
      <para>
       Dependendo de qual versão da biblioteca GD o PHP estiver usando, <emphasis>quando
       <parameter>fontfile</parameter> não começar com uma
       <literal>/</literal> então <literal>.ttf</literal> será adicionado</emphasis>
       ao nome do arquivo e a biblioteca tentará procurá-lo
       em um caminho de fontes definido pela biblioteca.
      </para>
      <para>
       Ao usar versões da biblioteca GD anteriores à versão 2.0.18, um caractere <literal>espaço</literal>,
       em vez de um ponto-e-vírgula, foi usado como 'separador de caminho' para diferentes arquivos de fonte.
       O uso não intencional desse recurso resultará na mensagem de aviso:
       <literal>Warning: Could not find/open font</literal>. Para essas versões afetadas, a
       única solução é mover a fonte para um caminho que não contenha espaços.
      </para>
      <para>
       Em muitos casos em que uma fonte reside no mesmo diretório que o script que a usa,
       o truque a seguir aliviará qualquer problema de inclusão.
       <programlisting role='php'>
<![CDATA[
<?php
// Define a variável de ambiente GDFONTPATH
putenv('GDFONTPATH=' . realpath('.'));

// Define a fonte a ser usada (observe a ausência da extensão .ttf)
$font = 'SomeFont';
?>
]]>
       </programlisting>
      </para>
      <note>
       <para>
        Note que <link linkend='ini.open-basedir'>open_basedir</link>
        <emphasis>não</emphasis> se aplica a <parameter>fontfile</parameter>.
       </para>
      </note>
     </listitem>
    </varlistentry>
">

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

<!ENTITY gd.return.trueonerror '<caution xmlns="http://docbook.org/ns/docbook"><simpara>Entretanto, se a biblioteca libgd falhar ao gerar a imagem, esta função retornará &true;.</simpara></caution>'>

<!ENTITY gd.identifier.color "Um identificador de cor criado com <function xmlns='http://docbook.org/ns/docbook'>imagecolorallocate</function>.">

<!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 imagem de origem.'>

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

<!ENTITY gd.image.path 'O caminho ou um recurso de stream aberto (que será fechado automaticamente após o retorno desta função) para salvar o arquivo. Se não for definido ou for &null;, o stream da imagem bruta será enviado diretamente.'>

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

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

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

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

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

<!ENTITY gd.font.size 'O tamanho da fonte em pontos.'>

<!ENTITY gd.constants.types '<simpara xmlns="http://docbook.org/ns/docbook">
    Usada como valor retornado por <function>imagetypes</function>.
</simpara>'>

<!ENTITY gd.constants.color '<simpara xmlns="http://docbook.org/ns/docbook">
    Opção de cor especial que pode ser usada em vez de uma cor alocada com
    <function>imagecolorallocate</function> ou
    <function>imagecolorallocatealpha</function>.
</simpara>'>

<!ENTITY gd.constants.affine '<simpara xmlns="http://docbook.org/ns/docbook">
    Uma constante de tipo de transformação afim usada pela função <function>imageaffinematrixget</function>.
</simpara>'>

<!ENTITY gd.constants.arc '<simpara xmlns="http://docbook.org/ns/docbook">
    Uma constante de estilo usada pela função <function>imagefilledarc</function>.
</simpara>'>

<!ENTITY gd.constants.gd2 '<simpara xmlns="http://docbook.org/ns/docbook">
    Uma constante de tipo usada pela função <function>imagegd2</function>.
</simpara>'>

<!ENTITY gd.constants.effect '<simpara xmlns="http://docbook.org/ns/docbook">
    Efeito de mesclagem alfa usado pela função <function>imagelayereffect</function>.
</simpara>'>

<!ENTITY gd.constants.filter '<simpara xmlns="http://docbook.org/ns/docbook">
    Filtro GD especial usado pela função <function>imagefilter</function>.
</simpara>'>

<!ENTITY gd.constants.type '<simpara xmlns="http://docbook.org/ns/docbook">
    Constante do tipo de imagem usada pelas funções <function>image_type_to_mime_type</function>
    e <function>image_type_to_extension</function>.
</simpara>'>

<!ENTITY gd.constants.png-filter '<simpara xmlns="http://docbook.org/ns/docbook">
    Um filtro PNG especial usado pela função <function>imagepng</function>.
</simpara>'>

<!ENTITY gd.constants.flip '<simpara xmlns="http://docbook.org/ns/docbook">
    Usada junto com <function>imageflip</function>, disponível a partir do PHP 5.5.0.
</simpara>'>

<!ENTITY gd.constants.interpolation '<simpara xmlns="http://docbook.org/ns/docbook">
    Usada junto com <function>imagesetinterpolation</function>, disponível a partir do PHP 5.5.0.
</simpara>'>

<!ENTITY gd.deprecated.gd-formats '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Os formatos
de imagem GD e GD2 são formatos de imagem proprietários da biblioteca libgd. Eles devem ser considerados
<emphasis>obsoletos</emphasis> e só devem ser usados para propósitos de desenvolvimento
e testes.</simpara></warning>'>

<!ENTITY gd.changelog.image-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  O parâmetro <parameter>image</parameter> agora espera uma instância de <classname>GdImage</classname>;
  anteriormente, um <type>resource</type> <literal>gd</literal> válido era esperado.
 </entry>
</row>'>

<!-- 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 um superconjunto de JSON conforme especificado na
   <link xlink:href="&url.rfc;7159">RFC 7159</link> original.
  </para>
 </note>
'>

<!-- cURL notes -->

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

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

<!ENTITY curl.sh.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>share_handle</parameter>
</term><listitem><para>Um manipulador cURL de compartilhamento retornado por
<function>curl_share_init</function>.</para></listitem></varlistentry>'>

<!ENTITY curl.changelog.handle-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  O parâmetro <parameter>handle</parameter> agora espera uma instância de <classname>CurlHandle</classname>;
  anteriormente, um <type>resource</type> era esperado.
 </entry>
</row>'>

<!ENTITY curl.changelog.multi-handle-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  O parâmetro <parameter>multi_handle</parameter> agora espera uma instância de <classname>CurlMultiHandle</classname>;
  anteriormente, um <type>resource</type> era esperado.
 </entry>
</row>'>

<!ENTITY curl.changelog.share-handle-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  O parâmetro <parameter>share_handle</parameter> agora espera uma instância de <classname>CurlShareHandle</classname>;
  anteriormente, um <type>resource</type> era esperado.
 </entry>
</row>'>

<!-- dbase notes -->

<!ENTITY dbase.type-conversion '<para xmlns="http://docbook.org/ns/docbook">
   Cada campo é convertido para o tipo PHP apropriado, exceto:
   <itemizedlist>
    <listitem>
     <simpara>
      Datas são mantidas como strings.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Valores DateTime são convertidos em strings.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Números inteiros fora do intervalo
      <constant>PHP_INT_MIN</constant>..<constant>PHP_INT_MAX</constant> são
      retornados como strings.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Antes do dbase 7.0.0, os booleanos (<literal>L</literal>) eram convertidos em <literal>1</literal> ou
      <literal>0</literal>.
     </simpara>
    </listitem>
   </itemizedlist>
  </para>'>

<!-- enchant entities -->

<!ENTITY enchant.param.broker '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>broker</parameter></term>
 <listitem>
  <para>
   Um agente Enchant retornado por <function>enchant_broker_init</function>.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY enchant.param.dictionary '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>dictionary</parameter></term>
 <listitem>
  <para>
   Um dicionário Enchant retornado por <function>enchant_broker_request_dict</function>
   ou <function>enchant_broker_request_pwl_dict</function>.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY enchant.changelog.broker-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  O parâmetro <parameter>broker</parameter> agora espera uma instância de <classname>EnchantBroker</classname>;
  anteriormente, um &resource; era esperado.
 </entry>
</row>'>

<!ENTITY enchant.changelog.dictionary-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  O parâmetro <parameter>dictionary</parameter> agora espera uma instância de <classname>EnchantDictionary</classname>;
  anteriormente, um &resource; era esperado.
 </entry>
</row>'>

<!-- IMAP notes -->

<!ENTITY imap.changelog.imap-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  O parâmetro <parameter>imap</parameter> agora espera uma instância de <classname>IMAP\Connection</classname>;
  anteriormente, um &resource; <literal>imap</literal> válido era esperado.
 </entry>
</row>'>

<!ENTITY imap.imap-parameter.imap '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>imap</parameter></term><listitem><para>Uma instância de <classname>IMAP\Connection</classname>.</para></listitem></varlistentry>'>

<!ENTITY imap.pattern '<para xmlns="http://docbook.org/ns/docbook">Especifica onde iniciar a pesquisa na hierarquia
da caixa de mensagem.</para><para xmlns="http://docbook.org/ns/docbook">Existem dois caracteres especiais que podem
ser passados como parte do parâmetro <parameter>pattern</parameter>:
&apos;<literal>*</literal>&apos; e &apos;<literal>&#37;</literal>&apos;.
&apos;<literal>*</literal>&apos; significa retornar todas as caixas de mensagem. Se
<parameter>pattern</parameter> for passado como &apos;<literal>*</literal>&apos;, será retornada
uma lista de toda a hierarquia da caixa de mensagem.
&apos;<literal>&#37;</literal>&apos;
significa retornar apenas o nível atual.
Passar &apos;<literal>&#37;</literal>&apos; como o parâmetro <parameter>pattern</parameter>
retornará apenas as caixas de mensagem do nível
mais alto; Passar &apos;<literal>~/mail/&#37;</literal>&apos; em <literal>UW_IMAPD</literal> retornará todas as caixas de mensagem no diretório <filename>~/mail</filename>, mas não retornará nenhuma nas subpastas deste diretório.</para>'>

<!ENTITY imap.mailboxname.insecure '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
Passar dados não confiáveis para este parâmetro é <emphasis>inseguro</emphasis>, a menos que
<link linkend="ini.imap.enable-insecure-rsh">imap.enable_insecure_rsh</link> esteja desabilitado.
</simpara></warning>'>

<!-- intl notes -->

<!ENTITY intl.parameter.intl-calendar '<para xmlns="http://docbook.org/ns/docbook">Uma instância de <classname>IntlCalendar</classname>.</para>'>

<!ENTITY intl.error.intl-calendar '<para xmlns="http://docbook.org/ns/docbook">Em caso de falha, &false; também é retornado. Para detectar condições de erro, use <function>intl_get_error_code</function> ou configure Intl para lançar <link linkend="ini.intl.use-exceptions">exceções</link>.</para>'>

<!ENTITY intl.codepoint.parameter '<para xmlns="http://docbook.org/ns/docbook">O valor <type>int</type> do ponto de código (por exemplo, <literal>0x2603</literal> para <emphasis>U+2603 SNOWMAN</emphasis>) ou o caractere codificado como uma <type>string</type> UTF-8 (por exemplo, <literal>"\u{2603}"</literal>).</para>'>

<!ENTITY intl.codepoint.return '<para xmlns="http://docbook.org/ns/docbook">O tipo do retorno é <type>int</type>, a menos que o ponto de código tenha sido passado como uma <type>string</type> UTF-8, caso em que uma <type>string</type> é retornada. Retorna &null; em caso de falha.</para>'>

<!ENTITY intl.codepoint.example 'Testando diferentes pontos de código'>

<!ENTITY intl.locale-len.return '<para xmlns="http://docbook.org/ns/docbook">Retorna &null; quando o comprimento de <parameter>locale</parameter> excede <constant>INTL_MAX_LOCALE_LEN</constant>.</para>'>

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

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

<!-- LDAP notes -->

<!ENTITY ldap.parameter.ldap 'Uma instância de <classname xmlns="http://docbook.org/ns/docbook">LDAP\Connection</classname>, retornada por <function xmlns="http://docbook.org/ns/docbook">ldap_connect</function>.'>

<!ENTITY ldap.parameter.result 'Uma instância de <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>, retornada por <function xmlns="http://docbook.org/ns/docbook">ldap_list</function> ou <function xmlns="http://docbook.org/ns/docbook">ldap_search</function>.'>

<!ENTITY ldap.parameter.entry 'Uma instância de <classname xmlns="http://docbook.org/ns/docbook">LDAP\ResultEntry</classname>.'>

<!ENTITY ldap.warn.control-paged '<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Esta função tornou-se <emphasis>OBSOLETA</emphasis> a partir do PHP 7.4.0 e foi <emphasis>REMOVIDA</emphasis> a partir do PHP 8.0.0.
  Em vez disso, o parâmetro <parameter>controls</parameter> da função <function>ldap_search</function> deve ser usado.
  Veja também <link linkend="ldap.controls">Controles LDAP</link> para obter detalhes.
 </simpara>
</warning>'>

<!ENTITY ldap.changelog.controls-nullable '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  O parâmetro <parameter>controls</parameter> agora pode ser nulo; anteriormente, o padrão era <literal>[]</literal>.
 </entry>
</row>'>

<!ENTITY ldap.changelog.ldap-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  O parâmetro <parameter>ldap</parameter> agora espera uma instância de <classname>LDAP\Connection</classname>;
  anteriormente, um &resource; <literal>ldap link</literal> válido era esperado.
 </entry>
</row>'>

<!ENTITY ldap.changelog.entry-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  O parâmetro <parameter>entry</parameter> agora espera uma instância de <classname>LDAP\ResultEntry</classname>;
  anteriormente, um &resource; <literal>ldap result entry</literal> válido era esperado.
 </entry>
</row>'>

<!ENTITY ldap.changelog.result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  O parâmetro <parameter>result</parameter> agora espera uma instância de <classname>LDAP\Result</classname>;
  anteriormente, um &resource; <literal>ldap result</literal> válido era esperado.
 </entry>
</row>'>

<!ENTITY ldap.changelog.return-result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Agora retorna uma instância de <classname>LDAP\Result</classname>;
  anteriormente, um &resource; era retornado.
 </entry>
</row>'>

<!ENTITY ldap.changelog.return-result-entry-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Agora retorna uma instância de <classname>LDAP\ResultEntry</classname>;
  anteriormente, um &resource; era retornado.
 </entry>
</row>'>

<!ENTITY ldap.return-result 'Retorna uma instância de <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>,&return.falseforfailure;.'>
<!ENTITY ldap.return-result-array 'Retorna uma instância de <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>, um array de instâncias de <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>,&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
instâncias de <classname>LDAP\Connection</classname>, em vez de apenas uma instância.
Se as pesquisas não devem usar a mesma DN base e filtro, um array de DNs base e/ou um array de filtros podem ser passados como argumentos.
Esses arrays devem ter o mesmo tamanho que o array de instâncias de <classname>LDAP\Connection</classname>,
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 instâncias de <classname>LDAP\Result</classname> é retornado, exceto em caso de erro, quando o valor retornado será &false;.</para>'>

<!-- mbstring notes -->

<!ENTITY note.mbstring.encoding.internal '<note xmlns="http://docbook.org/ns/docbook"><para>A codificação interna ou a
codificação de caracteres especificada por <function>mb_regex_encoding</function>
será usada como a codificação de caracteres 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á usada como a codificação de caracteres para esta função por padrão.</para></note>'>

<!ENTITY mbstring.encoding.parameter '<para xmlns="http://docbook.org/ns/docbook">O parâmetro <parameter>encoding</parameter>
é a codificação de caracteres. Se for omitido ou &null;, o valor da codificação
de caracteres interna será usado.</para>'>

<!ENTITY mbstring.warning.e-modifier '<warning xmlns="http://docbook.org/ns/docbook"><para>Nunca use o modificador <literal>e</literal> ao trabalhar com entradas não confiáveis. Nenhum escape automático acontecerá (como é conhecido em <function>preg_replace</function>). Não cuidar disso provavelmente criará vulnerabilidades de execução remota de código na sua aplicação.</para></warning>'>

<!ENTITY mbstring.changelog.encoding-nullable '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  O parâmetro <parameter>encoding</parameter> agora pode ser nulo.
 </entry>
</row>'>

<!ENTITY mbstring.changelog.needle-empty '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  O parâmetro <parameter>needle</parameter> agora aceita uma string vazia.
 </entry>
</row>'>

<!-- mcrypt notes -->

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

<!ENTITY mcrypt.parameter.iv.strict '<para xmlns="http://docbook.org/ns/docbook">Usado para a inicialização nos modos CBC, CFB, OFB e em alguns algoritmos no modo STREAM. Se o tamanho do IV fornecido não for suportado pelo modo de encadeamento ou nenhum IV for fornecido, mas o modo de encadeamento exigir um, a função emitirá um aviso e retornará &false;.</para>'>

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

<!-- memcached notes -->

<!ENTITY memcached.note.delete-time '<note xmlns="http://docbook.org/ns/docbook"><simpara>
       A partir da memcached 1.3.0 (lançada em 2009), este recurso não é mais
       suportado. Passar um parâmetro <parameter>time</parameter> diferente de zero causará
       a falha da exclusão. <methodname>Memcached::getResultCode</methodname>
       retornará <constant>MEMCACHED_INVALID_ARGUMENTS</constant>.
      </simpara></note>
'>

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

<!ENTITY memcached.parameter.server_key 'A chave que identifica o servidor no qual armazenar o valor ou de onde recuperá-lo. Em vez de fazer o hash na chave real do item, o hash é feito na chave do servidor ao decidir com qual servidor memcached se comunicar. Isso permite que itens relacionados sejam agrupados em um único servidor para eficiência com múltiplas operações.'>

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

<!ENTITY memcached.parameter.key 'A chave sob a qual armazenar o valor.'>

<!ENTITY memcached.parameter.value 'O valor a ser armazenado.'>

<!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>keys</parameter>. Cada elemento
   é &true; se a chave correspondente foi deletada ou uma das
   constantes <constant>Memcached::RES_*</constant> se a exclusão correspondente
   falhou.
   </para>
  <para xmlns="http://docbook.org/ns/docbook">
   O método <methodname>Memcached::getResultCode</methodname> retornará
   o código de resultado da última operação de exclusão executada, ou seja, a operação
   de exclusão do último elemento de <parameter>keys</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> denotando o algoritmo a ser usado ao fazer o hash da 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. Consulte as <link xmlns="http://docbook.org/ns/docbook" linkend="password.constants">constantes de algoritmo de senha</link> para obter a documentação sobre as opções suportadas por cada algoritmo.'>

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

<!-- pspell notes -->

<!ENTITY pspell.changelog.pspell-dictionary '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  O parâmetro <parameter>dictionary</parameter> agora espera uma instância de <classname>PSpell\Dictionary</classname>;
  anteriormente, um &resource; era esperado.
 </entry>
</row>'>

<!ENTITY pspell.changelog.pspell-config '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  O parâmetro <parameter>config</parameter> agora espera uma instância de <classname>PSpell\Config</classname>;
  anteriormente, um &resource; era esperado.
 </entry>
</row>'>

<!ENTITY pspell.parameter.pspell-dictionary '<para xmlns="http://docbook.org/ns/docbook">Uma instância de <classname>PSpell\Dictionary</classname>.</para>'>

<!ENTITY pspell.parameter.pspell-config '<para xmlns="http://docbook.org/ns/docbook">Uma instância de <classname>PSpell\Config</classname>.</para>'>

<!-- RNP -->

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

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

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

<!-- socket entities -->

<!ENTITY sockets.changelog.socket-param '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.0.0</entry>
  <entry>
   O parâmetro <parameter>socket</parameter> agora espera uma instância de <classname>Socket</classname>;
   anteriormente, um <type>resource</type> era esperado.
  </entry>
 </row>'>

<!ENTITY sockets.changelog.address-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  O parâmetro <parameter>address</parameter> agora espera uma instância de <classname>AddressInfo</classname>;
  anteriormente, um <type>resource</type> era esperado.
 </entry>
</row>'>

<!-- geaman notes -->

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

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

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

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

<!ENTITY gearman.parameter.context 'Contexto da aplicação para associar a uma tarefa'>

<!ENTITY gearman.parameter.unique 'Um identificador único usado para identificar uma tarefa específica'>

<!ENTITY gearman.parameter.jobhandle 'O manipulador de trabalho atribuído pelo 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 pode ser encontrada a lista completa de fusos horários suportados pelo PHP, os quais
podem ser usados, por exemplo, com <function>date_default_timezone_set</function>.
<caution><simpara>O comportamento dos fusos horários não listados aqui é indefinido.</simpara></caution>
</para><note xmlns='http://docbook.org/ns/docbook'><simpara>A versão mais recente do banco de dados de fusos horários pode ser
instalada 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">Não use nenhum dos fusos horários
listados aqui (exceto o UTC), pois eles existem apenas por motivos de compatibilidade com versões anteriores e podem ter comportamento errôneo.
Além disso, esses fusos horários podem ser removidos do banco de dados de fusos horários da IANA a qualquer momento.
</simpara>'>

<!ENTITY date.timezone.posix-signs '<simpara xmlns="http://docbook.org/ns/docbook">
 Se o aviso acima for desconsiderado, observe também que o banco de dados
 de fusos horários da IANA que fornece suporte aos fusos horários do PHP usa sinais no estilo
 POSIX, o que resulta nos fusos horários <literal>Etc/GMT+n</literal> e
 <literal>Etc/GMT-n</literal> sendo invertidos do uso comum.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
 Por exemplo, o fuso horário 8 horas à frente do GMT usado na China e
 na Austrália Ocidental (entre outros lugares) é, na verdade,
 <literal>Etc/GMT-8</literal> neste banco de dados, e não
 <literal>Etc/GMT+8</literal>, como normalmente esperado.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
 Novamente, é altamente recomendável que seja usado o fuso horário correto
 para sua localização, como <literal>Asia/Shanghai</literal> ou
 <literal>Australia/Perth</literal> nos exemplos acima.
</simpara>'>

<!ENTITY date.timezone.errors.description '<para xmlns="http://docbook.org/ns/docbook">
Toda chamada a uma função de data/hora gerará um <constant>E_WARNING</constant>
se o fuso horário não for válido. Veja também <function>date_default_timezone_set</function></para>'>

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

<!ENTITY date.datetime.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>object</parameter></term>
<listitem><para>Somente no estilo procedural: Um objeto <classname>DateTime</classname>
retornado por <function>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 no estilo procedural: Um objeto <classname>DateTime</classname>
retornado por <function>date_create</function>.
A função modifica este 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.return.modifiedobjectorfalseforfailure 'Retorna o objeto <classname xmlns="http://docbook.org/ns/docbook">DateTime</classname> modificado para encadeamento de métodos&return.falseforfailure;.'>
<!ENTITY date.datetime.return.modifiedobject 'Retorna o objeto <classname xmlns="http://docbook.org/ns/docbook">DateTime</classname> modificado para encadeamento de métodos.'>
<!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 é baseada na 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 'Ásia'>
<!ENTITY date.timezone.atlantic 'Atlântico'>
<!ENTITY date.timezone.australia 'Austrália'>
<!ENTITY date.timezone.europe 'Europa'>
<!ENTITY date.timezone.indian 'Índia'>
<!ENTITY date.timezone.pacific 'Pacífico'>
<!ENTITY date.timezone.others 'Outros'>

<!ENTITY date.formats 'Os formatos 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 de data/hora. &date.formats;'>

<!-- Dom Notes -->
<!ENTITY dom.node.inserted 'Este nó não aparecerá no documento a menos que
seja inserido, por exemplo, com <function xmlns="http://docbook.org/ns/docbook">DOMNode::appendChild</function>.'>


<!ENTITY dom.malformederror '<para xmlns="http://docbook.org/ns/docbook">Embora o HTML malformado deva ser carregado com sucesso, esta função pode gerar erros <constant>E_WARNING</constant> quando encontrar marcação incorreta. As <link linkend="function.libxml-use-internal-errors">funções de tratamento de erros da biblioteca libxml</link> podem ser usadas 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>'>
<!ENTITY dom.note.json '<note xmlns="http://docbook.org/ns/docbook"><para>Ao usar <function>json_encode</function> em um objeto <classname>DOMDocument</classname>, o resultado será a codificação de um objeto vazio.</para></note>'>


<!-- Dom Examples -->
<!ENTITY dom.book.example '<para xmlns="http://docbook.org/ns/docbook">Os exemplos a seguir usam um arquivo <filename>book.xml</filename> que contém o seguinte:</para>
<programlisting role="xml" xmlns="http://docbook.org/ns/docbook">
<!-- Aviso: A marcação CDATA aqui é um pouco complicada. Por favor, NÃO QUEBRE! -->
<![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>Princípios do PHP</title>
    <author email="jim.smith@basics.php">Jim Smith</author>
    <author email="jane.smith@basics.php">Jane Smith</author>
    <xhtml:blurb><![CDATA[
<p><em>Princípios do PHP</em> fornece uma introdução ao PHP.</p>
]]]]><![CDATA[></xhtml:blurb>
  </book>
  <book id="php-advanced">
    <title>Programação PHP Avançada</title>
    <author email="jon.doe@advanced.php">Jon Doe</author>
  </book>
</books>
]]></programlisting>'>

<!-- Dom entities -->
<!ENTITY dom.parameter.options '<para xmlns="http://docbook.org/ns/docbook">
  <link linkend="language.operators.bitwise">Bit a bit <literal>OR</literal></link>
  das <link linkend="libxml.constants">constantes de opções da libxml</link>.
</para>'>

<!ENTITY dom.errors.hierarchy.parent '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>
  <listitem>
  <para>
    Emitido se o pai é de um tipo que não permite filhos do
    tipo de um dos <parameter>nodes</parameter> informados, ou se o nó a ser
    inserido é um dos ancestrais deste nó, ou este próprio nó.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY dom.errors.hierarchy.self '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>
  <listitem>
  <para>
    Emitido se este nó é de um tipo que não permite filhos do
    tipo de um dos <parameter>nodes</parameter> informados, ou se o nó a ser
    inserido é um dos ancestrais deste nó, ou o próprio nó.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY dom.errors.wrong_document '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><constant>DOM_WRONG_DOCUMENT_ERR</constant></term>
  <listitem>
  <para>
    Emitido se um dos <parameter>nodes</parameter> informados foi criado a partir de um documento
    diferente daquele que criou este nó.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY dom.changelog.previous_hierarchy_exception 'Anteriormente, era lançada uma exceção
 <classname xmlns="http://docbook.org/ns/docbook">DOMException</classname> com código
 <constant xmlns="http://docbook.org/ns/docbook">DOM_HIERARCHY_REQUEST_ERR</constant>.'>

<!-- 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 deve ser válido e deve apontar para
um arquivo aberto com sucesso 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 <type>resource</type> de ponteiro do sistema de arquivos
que normalmente é criado usando <function>fopen</function>.</para>'>

<!ENTITY fs.file.32bit '<note xmlns="http://docbook.org/ns/docbook"><simpara>
    Como o tipo inteiro do PHP possui sinal e muitas plataformas usam números inteiros de 32 bits,
    algumas funções do sistema 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 como <constant>INI_SCANNER_TYPED</constant>.
    Nesse modo, os tipos boolean, null e integer são preservados quando possível.
    Os valores string <literal>"true"</literal>, <literal>"on"</literal> e <literal>"yes"</literal>
    são convertidos em &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 o tipo inteiro, se possível.
   </para>'>

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

<!ENTITY gnupg.fingerprint '<para xmlns="http://docbook.org/ns/docbook">A chave da impressão digital.</para>'>

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

<!ENTITY odbc.parameter.catalog 'O catálogo (&apos;qualifier&apos; na linguagem ODBC 2).'>

<!ENTITY odbc.parameter.schema 'O esquema (&apos;owner&apos; na linguagem ODBC 2).'>

<!ENTITY odbc.parameter.search 'Este parâmetro aceita os seguintes padrões de pesquisa:
<literal xmlns="http://docbook.org/ns/docbook">&#x25;</literal> para corresponder a zero ou mais caracteres
e <literal xmlns="http://docbook.org/ns/docbook">_</literal> para corresponder a um único caractere.'>

<!ENTITY odbc.result.driver-specific 'Drivers podem listar colunas adicionais.'>

<!-- 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 for especificada.'>

<!ENTITY oauth.changelog.error.null 'Anteriormente, retornava &null; em caso de falha, 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
a <literal>instância do Oracle</literal> à qual se conectar. Pode ser
uma <link xlink:href='&url.oracle.oic.connect;'>string Easy
Connect</link> ou um Connect Name do
arquivo <filename>tnsnames.ora</filename> ou o nome de uma instância
local do Oracle.
</para>
<para xmlns='http://docbook.org/ns/docbook'>Se não especificado ou &null;, o PHP usará
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>instância do Oracle</literal> à qual se conectar.
</para>
<para xmlns='http://docbook.org/ns/docbook'>
Para usar o método de nomenclatura Easy Connect, o PHP precisa ter sido compilado com as bibliotecas
Oracle Client 10<emphasis>g</emphasis> ou superiores. A string Easy Connect para o Oracle
10<emphasis>g</emphasis> tem o formato:
<emphasis>[//]nome_do_servidor[:porta][/nome_do_servico]</emphasis>. A partir do Oracle
11<emphasis>g</emphasis> a sintaxe é:
<emphasis>[//]nome_do_servidor[:porta][/nome_do_servico][:tipo_de_servidor][/nome_da_instancia]</emphasis>.
Outras opções foram introduzidas com o Oracle 19c, incluindo as configurações de timeout
e keep-alive. Consulte a documentação do Oracle. Os nomes dos serviços podem ser encontrados executando
o utilitário Oracle <literal>lsnrctl status</literal> na máquina do servidor de
banco de dados.
</para>
<para xmlns='http://docbook.org/ns/docbook'>
O arquivo <filename>tnsnames.ora</filename> pode estar no caminho de pesquisa Oracle Net,
que
inclui <filename>/seu/caminho/para/instantclient/network/admin</filename>, <filename>$ORACLE_HOME/network/admin</filename>
e <filename>/etc</filename>. Como alternativa, defina <literal>TNS_ADMIN</literal>
para que <filename>$TNS_ADMIN/tnsnames.ora</filename> possa ser lido. Certifique-se de que o servidor
web tem acesso de leitura ao arquivo.
</para>">

<!ENTITY oci.charset "<para xmlns='http://docbook.org/ns/docbook'>Determina
o conjunto de caracteres usado pelas bibliotecas Oracle Client. O conjunto de
caracteres não precisa corresponder ao conjunto de caracteres usado pelo banco de dados. Se
não corresponderem, o Oracle fará o possível para converter os dados de e para
o conjunto de caracteres do banco de dados. Dependendo dos conjuntos de caracteres, isso pode
não fornecer resultados utilizáveis. A conversão também adiciona alguma sobrecarga de tempo.
</para>
<para xmlns='http://docbook.org/ns/docbook'>Se não for especificado, as
bibliotecas Oracle Client determinam um conjunto de caracteres a partir da
variável de ambiente <constant>NLS_LANG</constant>.
</para>
<para xmlns='http://docbook.org/ns/docbook'>Passar este parâmetro pode
reduzir o tempo necessário para conectar.
</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>.
Se <constant>OCI_SYSOPER</constant> ou
<constant>OCI_SYSDBA</constant> forem especificadas, esta função tentará
estabelecer uma conexão privilegiada usando credenciais externas.
Conexões privilegiadas estão desabilitadas por padrão. Para habilitá-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
de modo <constant>OCI_CRED_EXT</constant>. Ele informa ao Oracle para usar
autenticação External ou OS, que deve ser configurada no
banco de dados. A flag <constant>OCI_CRED_EXT</constant> só pode ser usada
com o usuário &quot;/&quot; e uma senha vazia.
<link linkend="ini.oci8.privileged-connect">oci8.privileged_connect</link>
pode ser <literal>On</literal> ou <literal>Off</literal>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
<constant>OCI_CRED_EXT</constant> pode ser combinado com os modos
<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 obter detalhes sobre o mapeamento dos tipos de dados realizado pela
extensão OCI8, consulte os <link linkend="oci8.datatypes">tipos de dados
suportados pelo driver</link>.</para>'>

<!ENTITY oci.parameter.connection '<para xmlns="http://docbook.org/ns/docbook">Um identificador 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>Requisitos de versão do Oracle</title>
<para>Esta função estará disponível quando o PHP for compilado com as bibliotecas do Oracle
Database a partir da versão 10<emphasis>g</emphasis> em diante.</para></note>'>

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

<!ENTITY oci.roundtrip.caution '<caution xmlns="http://docbook.org/ns/docbook"><title>Pegadinha da Viagem de Ida e Volta</title>
<para>Algumas, mas não todas as funções do OCI8, causam viagens de ida e volta. Viagens de ida e volta ao
banco de dados podem não ocorrer com consultas quando o cache de resultados estiver habilitado.
</para></caution>'>

<!ENTITY oci.use.setprefetch '<para xmlns="http://docbook.org/ns/docbook">Para
consultas que retornam um grande número de linhas, o desempenho pode ser
melhorado significativamente
aumentando <link linkend="ini.oci8.default-prefetch">oci8.default_prefetch</link>
ou usando <function>oci_set_prefetch</function>.
</para>'>


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

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

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

<!ENTITY note.open-basedir.func '<note xmlns="http://docbook.org/ns/docbook"><para>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>Como esta é uma
construção da linguagem e não uma função, ela não pode ser chamada usando
<link linkend="functions.variable-functions">funções variáveis</link>
ou <link linkend="functions.named-arguments">argumentos nomeados</link>.</simpara>
</note>'>

<!-- 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 definidas no &php.ini;.</para>'>
<!ENTITY no.resource '<para xmlns="http://docbook.org/ns/docbook">Esta extensão não possui tipos de 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">Nenhuma biblioteca externa é necessária para compilar esta extensão.</para>'>
<!ENTITY no.install '<para xmlns="http://docbook.org/ns/docbook">Nenhuma instalação é necessária para usar essas
funções; elas fazem 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">Aqui está uma breve 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 é afetado pelas configurações do &php.ini;.
</simpara>'>

<!ENTITY ini.php.constants 'Para mais detalhes e definições dos modos
PHP_INI_*, consulte os <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
só estarão disponíveis quando a extensão tiver sido compilada no PHP
ou tiver sido carregada dinamicamente em tempo de 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 abaixo estão sempre disponíveis como parte do núcleo do PHP.
</simpara>'>

<!-- PDO entities -->
<!ENTITY pdo.driver-constants '<simpara xmlns="http://docbook.org/ns/docbook">As constantes abaixo são definidas por
este driver e só estarão disponíveis quando a extensão tiver sido
compilada no PHP ou tiver sido carregada dinamicamente em tempo de execução. Além disso, estas
constantes específicas do driver só devem ser usadas se este driver estiver sendo usado.
Usar atributos específicos de um driver com outro driver pode resultar em
comportamento inesperado. <function>PDO::getAttribute</function> pode ser usada para
obter o atributo <constant>PDO::ATTR_DRIVER_NAME</constant> para verificar o
driver, se o código puder ser executado com vários drivers.</simpara>'>

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

<!-- PDO errors -->

<!ENTITY pdo.errors '<para xmlns="http://docbook.org/ns/docbook">
Emite um erro de nível <constant>E_WARNING</constant> se o atributo <constant>PDO::ATTR_ERRMODE</constant> estiver definido
como <constant>PDO::ERRMODE_WARNING</constant>.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Lança uma exceção <classname>PDOException</classname> se o atributo <constant>PDO::ATTR_ERRMODE</constant>
estiver definido como <constant>PDO::ERRMODE_EXCEPTION</constant>.
</para>'>

<!-- PECL entities -->
<!ENTITY pecl.moved 'Esta extensão &link.pecl; não é distribuída com o PHP.'>

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

<!ENTITY pecl.info.dead 'Esta extensão é considerada sem manutenção e abandonada. No entanto, o código-fonte
desta extensão ainda está disponível no <acronym xmlns="http://docbook.org/ns/docbook">SVN</acronym> do
<acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym> aqui: '>

<!ENTITY pecl.info.dead.git 'Esta extensão é considerada sem manutenção e abandonada. No entanto, o código-fonte
desta extensão 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 esta
extensão <acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym> não está disponível no momento. 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.avail 'Binários do Windows (arquivos <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym>)
para esta extensão <acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym> estão disponíveis no site do PECL.'>

<!ENTITY pecl.moved-ver 'Esta extensão foi movida para o repositório &link.pecl;
e não é mais distribuída com o PHP desde a versão '>

<!-- PGSQL entities -->

<!ENTITY pgsql.parameter.connection '<para xmlns="http://docbook.org/ns/docbook">Uma instância de <classname>PgSql\Connection</classname>.</para>'>

<!ENTITY pgsql.parameter.connection-with-unspecified-default '<para xmlns="http://docbook.org/ns/docbook">Uma instância de <classname>PgSql\Connection</classname>.
Quando o parâmetro <parameter>connection</parameter> não for especificado, a conexão padrão será usada.
A conexão padrão é a última conexão feita por <function>pg_connect</function>
ou <function>pg_pconnect</function>.
<warning><simpara>A partir do PHP 8.1.0, usar a conexão padrão tornou-se obsoleto.</simpara></warning></para>'>

<!ENTITY pgsql.parameter.connection-with-nullable-default '<para xmlns="http://docbook.org/ns/docbook">Uma instância de <classname>PgSql\Connection</classname>.
Quando o parâmetro <parameter>connection</parameter> for &null;, a conexão padrão será usada.
A conexão padrão é a última conexão feita por <function>pg_connect</function>
ou <function>pg_pconnect</function>.
<warning><simpara>A partir do PHP 8.1.0, usar a conexão padrão tornou-se obsoleto.</simpara></warning></para>'>

<!ENTITY pgsql.parameter.result '<para xmlns="http://docbook.org/ns/docbook">Uma instância de <classname>PgSql\Result</classname>, retornada por <function>pg_query</function>,
<function>pg_query_params</function> ou <function>pg_execute</function> (entre outras).</para>'>

<!ENTITY pgsql.parameter.lob '<para xmlns="http://docbook.org/ns/docbook">Uma instância de <classname>PgSql\Lob</classname>, retornada por <function>pg_lo_open</function>.</para>'>

<!ENTITY pgsql.parameter.mode '<para xmlns="http://docbook.org/ns/docbook">
Um parâmetro opcional que controla como o <type>array</type> retornado será indexado.
<parameter>mode</parameter> é uma constante e pode assumir os seguintes valores:
<constant>PGSQL_ASSOC</constant>, <constant>PGSQL_NUM</constant> e <constant>PGSQL_BOTH</constant>.
Usando <constant>PGSQL_NUM</constant>, a função retornará um array com índices numéricos,
usando <constant>PGSQL_ASSOC</constant> ela retornará apenas índices associativos
enquanto <constant>PGSQL_BOTH</constant> retornará índices numéricos e associativos.</para>'>

<!ENTITY pgsql.changelog.connection-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  O parâmetro <parameter>connection</parameter> agora espera uma instância de <classname>PgSql\Connection</classname>;
  anteriormente, um &resource; era esperado.
 </entry>
</row>'>

<!ENTITY pgsql.changelog.result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  O parâmetro <parameter>result</parameter> agora espera uma instância de <classname>PgSql\Result</classname>;
  anteriormente, um &resource; era esperado.
 </entry>
</row>'>

<!ENTITY pgsql.changelog.lob-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  O parâmetro <parameter>lob</parameter> agora espera uma instância de <classname>PgSql\Lob</classname>;
  anteriormente, um &resource; era esperado.
 </entry>
</row>'>

<!ENTITY pgsql.changelog.return-result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Agora retorna uma instância de <classname>PgSql\Result</classname>;
  anteriormente, um &resource; era retornado.
 </entry>
</row>'>

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


<!ENTITY windows.builtin '<simpara xmlns="http://docbook.org/ns/docbook">A versão do PHP para Windows tem suporte
nativo para esta extensão. Nenhuma extensão adicional precisa ser carregada
para usar essas funções.</simpara>'>

<!-- These are here as helpers for manual consistency and brievety-->
<!ENTITY sqlsafemode '<link xmlns="http://docbook.org/ns/docbook" linkend="ini.sql.safe-mode">modo seguro do SQL</link>'>

<!-- BCMath Notes -->
<!ENTITY bc.scale.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>scale</parameter></term><listitem><para>Este parâmetro opcional é usado para definir o número
de dígitos após a casa decimal do resultado. Se omitido, o padrão será a escala definida
globalmente com a função <function>bcscale</function> ou, em último caso, <literal>0</literal> se
a escala não tiver sido definida.</para></listitem></varlistentry>'>

<!-- CTYPE Notes -->
<!ENTITY note.ctype.parameter.integer '<note xmlns="http://docbook.org/ns/docbook"><para>
Se um <type>int</type> entre -128 e 255 inclusive for fornecido, ele será interpretado como
o valor ASCII de um único caractere (valores negativos são somados a 256 para permitir
caracteres no intervalo ASCII estendido). Qualquer outro inteiro será interpretado como uma string
contendo os dígitos decimais do 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 que não seja string tornou-se obsoleto.
No futuro, o argumento será interpretado como uma string em vez de um ponto de código ASCII.
Dependendo do comportamento esperado, 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 'Quando chamada com uma string vazia, o resultado sempre será &false;.'>

<!-- FTP Notes -->
<!ENTITY ftp.changelog.ftp-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  O parâmetro <parameter>ftp</parameter> agora espera uma instância de <classname>FTP\Connection</classname>;
  anteriormente, um &resource; era esperado.
 </entry>
</row>'>
<!ENTITY ftp.parameter.ftp '<para xmlns="http://docbook.org/ns/docbook">Uma instância de <classname>FTP\Connection</classname>.</para>'>

<!-- GMP Notes -->
<!ENTITY gmp.return 'Um objeto <classname xmlns="http://docbook.org/ns/docbook">GMP</classname>.'>
<!ENTITY gmp.parameter '<para xmlns="http://docbook.org/ns/docbook">Um objeto <classname>GMP</classname>, um &integer; ou uma &string; numérica.</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 objeto <classname>mysqli_result</classname>
retornado por <function>mysqli_query</function>, <function>mysqli_store_result</function>,
<function>mysqli_use_result</function> ou <function>mysqli_stmt_get_result</function>.</para></listitem></varlistentry>'>
<!ENTITY mysqli.link.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>mysql</parameter></term><listitem><para>Somente no estilo procedural: Um objeto <classname>mysqli</classname>
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>statement</parameter></term><listitem><para>Somente no estilo procedural: Um objeto <classname>mysqli_stmt</classname>
retornado por <function>mysqli_stmt_init</function>.</para></listitem></varlistentry>'>
<!ENTITY mysqli.available.mysqlnd 'Disponível apenas com o <link xmlns="http://docbook.org/ns/docbook"
linkend="book.mysqlnd">mysqlnd</link>.'>
<!ENTITY mysqli.charset.note '<note xmlns="http://docbook.org/ns/docbook">
<para>O MySQLnd sempre assume o conjunto de caracteres padrão do servidor. Este conjunto de caracteres é enviado durante a
criação/autenticação da conexão e será usado pelo mysqlnd.</para><para>A libmysqlclient usa o conjunto de caracteres padrão definido no
arquivo <filename>my.cnf</filename> ou definido por uma chamada explícita a <function>mysqli_options</function> antes de
chamar <function>mysqli_real_connect</function>, mas depois de chamar <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>'>
<!ENTITY mysqli.sqlinjection.warning '<warning xmlns="http://docbook.org/ns/docbook">
<title>Alerta de segurança: injeção de SQL</title><para>Se a consulta contiver qualquer entrada de
variável, <link linkend="mysqli.quickstart.prepared-statements">instruções
preparadas parametrizadas</link> devem ser usadas. Alternativamente, os
dados devem ser formatados corretamente e todas as strings devem ser escapadas usando
a função <function>mysqli_real_escape_string</function>.
</para></warning>'>
<!ENTITY mysqli.conditionalexception '<para xmlns="http://docbook.org/ns/docbook">
Se o relatório de erros da extensão mysqli estiver habilitado (<constant>MYSQLI_REPORT_ERROR</constant>) e a operação solicitada falhar,
um aviso será gerado. Se, além disso, o modo for definido como <constant>MYSQLI_REPORT_STRICT</constant>,
uma exceção <classname>mysqli_sql_exception</classname> será lançada em vez do aviso.</para>'>

<!-- Notes for PCRE -->
<!ENTITY pcre.pattern.warning '<para xmlns="http://docbook.org/ns/docbook">
Se o padrão de expressão regular passado não for compilado para uma expressão regular válida, um <constant>E_WARNING</constant> será emitido.
</para>'>

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

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

<!-- SimpleXML Notes -->
<!ENTITY simplexml.iteration '<note xmlns="http://docbook.org/ns/docbook"><simpara>Na SimpleXML tornou-se comum adicionar
propriedades iterativas à maioria dos métodos. Elas não podem ser visualizadas usando <function>var_dump</function>
ou qualquer outra coisa que possa examinar objetos.</simpara></note>'>

<!-- Database Notes -->
<!ENTITY database.field-case '<note xmlns="http://docbook.org/ns/docbook"><simpara>Os nomes de campos retornados por esta função
<emphasis>diferenciam maiúsculas e minúsculas</emphasis>.</simpara></note>'>

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

<!-- 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
identificador da conexão não for especificado, a última conexão aberta por
<function>mysql_connect</function> será usada. Se não houver uma conexão anterior,
haverá uma tentativa de criar uma como se <function>mysql_connect</function> tivesse sido chamada
sem argumentos. Se nenhuma conexão for encontrada ou estabelecida, um erro de nível
<constant>E_WARNING</constant> será 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
identificador da conexão não for especificado, a última conexão aberta por
<function>mysql_connect</function> será usada. Se nenhuma conexão for encontrada ou
estabelecida, um erro de 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 <type>resource</type> do resultado que
está sendo avaliado. Este resultado vem 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>O deslocamento numérico do campo.
<parameter>field_offset</parameter> começa em <literal>0</literal>. Se
<parameter>field_offset</parameter> não existir, um erro de nível
<constant>E_WARNING</constant> também será emitido.</para></listitem></varlistentry>'>

<!ENTITY mysql.alternative.note '<para xmlns="http://docbook.org/ns/docbook">Esta extensão tornou-se obsoleta a partir do PHP 5.5.0 e foi removida no PHP 7.0.0.
Em vez disso, as extensões <link linkend="book.mysqli">MySQLi</link> ou <link linkend="ref.pdo-mysql">PDO_MySQL</link> devem ser usadas.
Veja também o guia <link linkend="mysqlinfo.api.choosing">MySQL: escolhendo uma API</link>.
Alternativas a esta função incluem:</para>'>

<!ENTITY mysql.alternative.note.4-3-0 '<para xmlns="http://docbook.org/ns/docbook">Esta função tornou-se obsoleta a partir do PHP 4.3.0 e
ela e a <link linkend="book.mysql">extensão MySQL original</link> foram removidas a partir do PHP 7.0.0.
Em vez disso, use as extensões <link linkend="book.mysqli">MySQLi</link> ou <link linkend="ref.pdo-mysql">PDO_MySQL</link>, que são desenvolvidas ativamente.
Veja também o guia <link linkend="mysqlinfo.api.choosing">MySQL: escolhendo uma API</link>.
Alternativas a esta função incluem:</para>'>

<!ENTITY mysql.alternative.note.5-3-0 '<para xmlns="http://docbook.org/ns/docbook">Esta função tornou-se obsoleta a partir do PHP 5.3.0 e
ela e a <link linkend="book.mysql">extensão MySQL original</link> foram removidas a partir do PHP 7.0.0.
Em vez disso, use as extensões <link linkend="book.mysqli">MySQLi</link> ou <link linkend="ref.pdo-mysql">PDO_MySQL</link>, que são desenvolvidas ativamente.
Veja também o guia <link linkend="mysqlinfo.api.choosing">MySQL: escolhendo uma API</link>.
Alternativas a esta função incluem:</para>'>

<!ENTITY mysql.alternative.note.5-4-0 '<para xmlns="http://docbook.org/ns/docbook">Esta função tornou-se obsoleta a partir do PHP 5.4.0 e
ela e a <link linkend="book.mysql">extensão MySQL original</link> foram removidas a partir do PHP 7.0.0.
Em vez disso, use as extensões <link linkend="book.mysqli">MySQLi</link> ou <link linkend="ref.pdo-mysql">PDO_MySQL</link>, que são desenvolvidas ativamente.
Veja também o guia <link linkend="mysqlinfo.api.choosing">MySQL: escolhendo uma API</link>.
Alternativas a esta função incluem:</para>'>

<!ENTITY mysql.close.connections.result.sets '<para xmlns="http://docbook.org/ns/docbook">
Conexões MySQL não persistentes abertas e conjuntos de resultados são automaticamente destruídos quando um
script PHP termina sua execução. Portanto, embora seja opcional fechar conexões
abertas e liberar conjuntos de resultados, isso é recomendado.
Isso retornará imediatamente os recursos usados ao PHP e MySQL, o que pode
melhorar o desempenho. Para obter informações relacionadas, consulte a página
<link linkend="language.types.resource.self-destruct">liberando recursos</link>.</para>'>

<!-- Xattr entities -->
<!ENTITY xattr.namespace '<para xmlns="http://docbook.org/ns/docbook">Os atributos estendidos têm dois namespaces diferentes: usuário
e root. O namespace de usuário está disponível para todos os usuários, enquanto o namespace de root
está disponível apenas para o usuário com privilégios de root. xattr opera no namespace de
usuário por padrão, mas isso pode ser alterado com o parâmetro
<parameter>flags</parameter>.</para>'>

<!-- Notes for IPv6 -->
<!ENTITY ipv6.brackets '<note xmlns="http://docbook.org/ns/docbook"><simpara>Ao especificar um endereço IPv6 numérico
(por exemplo, <literal>fe80::1</literal>), o IP deve ser colocado entre
colchetes — por exemplo, <literal>tcp://[fe80::1]:80</literal>.</simpara></note>'>

<!-- Notes for tidy -->

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

<!-- Snippets for the installation section -->
<!ENTITY warn.apache2.compat '<warning xmlns="http://docbook.org/ns/docbook"><para>Não recomendamos usar um
MPM com threads no Apache 2 em produção. Use o módulo prefork, que é
o MPM padrão no Apache 2.0 e 2.2 e não usa threads.
Para obter informações sobre o motivo, leia a FAQ sobre o uso do
<link linkend="faq.installation.apache2">Apache2 com MPM com threads</link>.</para></warning>'>

<!ENTITY note.apache.slashes '<note xmlns="http://docbook.org/ns/docbook"><simpara>Lembre-se que ao adicionar
caminhos nos arquivos de configuração do Apache no Windows, todas as barras invertidas
como em <filename>c:\diretorio\arquivo.ext</filename> devem ser convertidas para
barras: <filename>c:/diretorio/arquivo.ext</filename>. Uma barra
final também pode ser necessária para diretórios.</simpara></note>'>

<!-- Snippets and titles for the contributors section -->
<!ENTITY Credit.Authors.and.Contributors 'Pessoas Autoras e Pessoas Contribuidoras'>

<!ENTITY Credit.Introduction '<para xmlns="http://docbook.org/ns/docbook">Destacamos as pessoas mais ativas atualmente
na página inicial do manual, mas há muito mais pessoas que
ajudam no nosso trabalho ou que forneceram uma grande ajuda ao projeto
no passado. Existem muitas pessoas não citadas que ajudam com as
notas de usuários nas páginas do manual, que continuamente são incluídas nas referências,
cujo trabalho somos extremamente gratos. Todas as listas a seguir estão
em ordem alfabética.
</para>'>

<!ENTITY Credit.Authors.and.Editors 'Pessoas Autoras e Pessoas Editoras'>

<!ENTITY Credit.Past.Authors.Text 'As seguintes pessoas contribuidoras são
reconhecidas pelo impacto que causaram e/ou continuam a causar ao adicionar
conteúdo ao manual:'>

<!ENTITY Credit.Past.Editors.Text 'As seguintes pessoas contribuidoras fizeram
um trabalho significativo editando o manual:'>

<!ENTITY Credit.Note.Editors.Title 'Pessoas Mantenedoras de Notas de Usuários'>

<!ENTITY Credit.Note.Editors.Active 'As pessoas mantenedoras mais ativas atualmente são:'>

<!ENTITY Credit.Note.Editors.Inactive 'Estas pessoas também se esforçaram muito
no gerenciamento de notas de usuários:'>

<!ENTITY listendand ' e'>

<!-- classkit and runkit entities -->

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

<!ENTITY note.runkit.internal-override '<note xmlns="http://docbook.org/ns/docbook"><simpara>Por padrão, apenas
funções criadas pelo usuário podem ser removidas, renomeadas ou modificadas. Para
sobrescrever funções internas, a configuração
<literal>runkit.internal_override</literal> deve ser habilitada 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
é usado para gerenciar chaves públicas em um servidor no qual o cliente
<emphasis>já está</emphasis> autenticado. Para autenticar em um servidor remoto
usando autenticação com chave pública, use a função
<function>ssh2_auth_pubkey_file</function>.</simpara></note>'>

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

<!-- XMLWriter Notes -->
<!ENTITY xmlwriter.xmlwriter.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>writer</parameter></term><listitem><para>Apenas para chamadas procedurais.
A instância de <classname>XMLWriter</classname> que está sendo modificada. Este objeto é retornado de uma chamada a <function>xmlwriter_open_uri</function> ou <function>xmlwriter_open_memory</function>.</para></listitem></varlistentry>'>

<!ENTITY xmlwriter.changelog.writer-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  O parâmetro <parameter>writer</parameter> agora espera uma instância de <classname>XMLWriter</classname>;
  anteriormente, um <type>resource</type> era esperado.
 </entry>
</row>'>

<!-- SOAP notes -->
<!ENTITY soap.wsdl.mode.only "<note xmlns='http://docbook.org/ns/docbook'><para>Esta função funciona apenas 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 identificador do 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 cabeçalhos adicionais (exemplo: receipt).</para></listitem></varlistentry>">
<!ENTITY stomp.note.transaction "<note xmlns='http://docbook.org/ns/docbook'><para>Um cabeçalho de transação pode ser especificado, indicando que a confirmação da mensagem deve fazer 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 um cabeçalho receipt. Isso fará com que os métodos não retornem nada até que o servidor confirme o recebimento da mensagem ou até que o tempo limite de leitura seja atingido.</simpara></tip>">

<!-- SVN notes -->
<!ENTITY svn.relativepath "<note xmlns='http://docbook.org/ns/docbook'><simpara>Os caminhos relativos serão resolvidos como se o diretório de trabalho atual fosse aquele que contém o binário do PHP. Para usar o diretório de trabalho do script de chamada, use <function>realpath</function> ou dirname(__FILE__).</simpara></note>">
<!ENTITY svn.referto.status 'Consulte as <link xmlns="http://docbook.org/ns/docbook" linkend="svn.constants.status">constantes de status</link> para obter os valores possíveis.'>
<!ENTITY svn.referto.type 'Consulte as <link xmlns="http://docbook.org/ns/docbook" linkend="svn.constants.type">constantes de tipo</link> para obter 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"><type>resource</type> dos dados de treinamento da 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 da rede neural.</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; em caso de sucesso ou &false; caso contrário.</para>'>
<!ENTITY fann.return.ann '<para xmlns="http://docbook.org/ns/docbook"> Retorna um <type>resource</type> de rede neural em caso de sucesso ou &false; em caso de erro.</para>'>
<!ENTITY fann.return.train '<para xmlns="http://docbook.org/ns/docbook">Retorna um <type>resource</type> de dados de treinamento em caso de sucesso ou &false; em caso de erro.</para>'>
<!ENTITY fann.note.function.fann-2.2 '<note xmlns="http://docbook.org/ns/docbook"><para>Esta função só estará disponível se a extensão fann tiver sido compilada usando a biblioteca libfann &gt;= 2.2.</para></note>'>

<!-- Imagick generic return types -->
<!ENTITY imagick.return.success 'Retorna &true; em caso de sucesso.'>
<!ENTITY imagick.imagick.throws 'Lança uma exceção ImagickException em caso de erro.'>

<!-- Imagick version infos -->
<!ENTITY imagick.method.available.0x629 'Este método estará disponível se a extensão Imagick tiver sido compilada com a ImageMagick versão 6.2.9 ou superior.'>
<!ENTITY imagick.method.available.0x631 'Este método estará disponível se a extensão Imagick tiver sido compilada com a ImageMagick versão 6.3.1 ou superior.'>
<!ENTITY imagick.method.available.0x632 'Este método estará disponível se a extensão Imagick tiver sido compilada com a ImageMagick versão 6.3.2 ou superior.'>
<!ENTITY imagick.method.available.0x636 'Este método estará disponível se a extensão Imagick tiver sido compilada com a ImageMagick versão 6.3.6 ou superior.'>
<!ENTITY imagick.method.available.0x637 'Este método estará disponível se a extensão Imagick tiver sido compilada com a ImageMagick versão 6.3.7 ou superior.'>
<!ENTITY imagick.method.available.0x638 'Este método estará disponível se a extensão Imagick tiver sido compilada com a ImageMagick versão 6.3.8 ou superior.'>
<!ENTITY imagick.method.available.0x639 'Este método estará disponível se a extensão Imagick tiver sido compilada com a ImageMagick versão 6.3.9 ou superior.'>
<!ENTITY imagick.method.available.0x640 'Este método estará disponível se a extensão Imagick tiver sido compilada com a ImageMagick versão 6.4.0 ou superior.'>
<!ENTITY imagick.method.available.0x644 'Este método estará disponível se a extensão Imagick tiver sido compilada com a ImageMagick versão 6.4.4 ou superior.'>
<!ENTITY imagick.method.available.0x645 'Este método estará disponível se a extensão Imagick tiver sido compilada com a ImageMagick versão 6.4.5 ou superior.'>
<!ENTITY imagick.method.available.0x647 'Este método estará disponível se a extensão Imagick tiver sido compilada com a ImageMagick versão 6.4.7 ou superior.'>
<!ENTITY imagick.method.available.0x649 'Este método estará disponível se a extensão Imagick tiver sido compilada com a ImageMagick versão 6.4.9 ou superior.'>
<!ENTITY imagick.method.available.0x657 'Este método estará disponível se a extensão Imagick tiver sido compilada com a ImageMagick versão 6.5.7 ou superior.'>

<!ENTITY imagick.method.not.available.0x700 'Este método não estará disponível se a extensão Imagick tiver sido compilada com a ImageMagick versão 7.0.0 ou superior.'>

<!ENTITY imagick.constant.available 'Esta constante estará disponível se a extensão Imagick tiver sido compilada com a ImageMagick versão'>

<!ENTITY imagick.deprecated.function-3-4-4 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Esta função tornou-se <emphasis>OBSOLETA</emphasis> a partir da Imagick 3.4.4. O uso desta função é fortemente desencorajado.</simpara></warning>'>

<!-- Imagick default channel information -->
<!ENTITY imagick.default.channel.info 'O padrão é <constant xmlns="http://docbook.org/ns/docbook">Imagick::CHANNEL_DEFAULT</constant>. Consulte esta 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 fuzz. Por exemplo, definir fuzz como 10 e a cor vermelha nas intensidades de 100 e 102, respectivamente, agora são interpretadas como a mesma cor.'>

<!-- Channel parameter -->
<!ENTITY imagick.parameter.channel 'Fornece qualquer constante de canal que seja válida no modo de canal. Para aplicar a mais de um canal, <link xmlns="http://docbook.org/ns/docbook" linkend="imagick.constants.channel">constantes de canal</link> devem ser combinadas usando operadores bit a bit. &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 caso de erro.'>

<!ENTITY imagick.bestfit.note '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  O comportamento do parâmetro <parameter>bestfit</parameter> mudou na Imagick 3.0.0.
  Antes desta versão, dadas as dimensões 400x400, uma imagem de dimensões 200x150 permaneceria
  intocada. Na Imagick 3.0.0 e superiores, a imagem será escalada para 400x300, pois
  este é o "melhor ajuste" para as dimensões fornecidas. Se o parâmetro <parameter>bestfit</parameter>
  for usado, tanto a largura quanto a altura devem ser informadas.
 </simpara>
</note>'>

<!ENTITY note.openssl.cnf '<note xmlns="http://docbook.org/ns/docbook">
 <simpara xmlns="http://docbook.org/ns/docbook">
  É preciso ter um arquivo <filename>openssl.cnf</filename> válido instalado
  para que esta função funcione corretamente.
  Consulte as notas na
  <link linkend="openssl.installation">seção de instalação</link>
  para obter mais informações.
 </simpara>
</note>'>
<!ENTITY note.openssl.param-notext '<para xmlns="http://docbook.org/ns/docbook">
 O parâmetro opcional <parameter>notext</parameter> afeta
 a verbosidade da saída; se for &false;, então informações adicionais legíveis
 para humanos serão incluídas na saída. O valor padrão de
 <parameter>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 variantes, os parâmetros para esta função
 podem ser um tipo nativo do PHP (inteiro, string, ponto flutuante, booleano ou
 &null;) ou uma instância de uma classe COM, VARIANT ou DOTNET. Tipos nativos do PHP
 serão convertidos em variantes usando as mesmas regras encontradas no construtor
 da classe <xref linkend="class.variant"/>. Objetos COM e DOTNET
 terão o valor de sua propriedade padrão obtido e usado como o valor da variante.
</para>
<para>
 As funções aritméticas variantes são wrappers para funções com nomes
 semelhantes na biblioteca COM; para mais informações sobre estas funções, consulte
 a biblioteca MSDN. As funções do PHP são nomeadas de forma ligeiramente diferente; por exemplo,
 <function>variant_add</function> no PHP corresponde a <literal>VarAdd()
 </literal> na documentação da MSDN.
</para>
</note>
'>

<!-- phar -->
<!ENTITY phar.write '<note xmlns="http://docbook.org/ns/docbook"><para>Este
método requer que a configuração <literal>phar.readonly</literal> do &php.ini; seja
definida como <literal>0</literal> para funcionar com objetos <classname>Phar</classname>.
Caso contrário, uma exceção <classname>PharException</classname> será lançada.</para></note>'>

<!ENTITY phar.note.performance '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  <function>Phar::addFile</function>, <function>Phar::addFromString</function> e <function>Phar::offsetSet</function>
  salvam um novo arquivo phar cada vez que são chamadas. Se o desempenho for uma preocupação,
  <function>Phar::buildFromDirectory</function> ou <function>Phar::buildFromIterator</function>
  devem ser usadas.
 </simpara>
</note>'>

<!ENTITY phardata.note.performance '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  <function>PharData::addFile</function>, <function>PharData::addFromString</function> e <function>PharData::offsetSet</function>
  salvam um novo arquivo phar cada vez que são chamadas. Se o desempenho for uma preocupação,
  <function>PharData::buildFromDirectory</function> ou <function>PharData::buildFromIterator</function>
  devem ser usadas.
 </simpara>
</note>'>

<!-- XML -->
<!ENTITY libxml.required '<para xmlns="http://docbook.org/ns/docbook">
 Esta extensão requer a extensão PHP <link linkend="book.libxml">libxml</link>.
 Isso significa que ao compilar o PHP é preciso passar a flag de configuração <option role="configure">--with-libxml</option>,
 ou antes do PHP 7.4, <option role="configure">--enable-libxml</option>,
 embora isso seja feito implicitamente pois a libxml está habilitada por padrão.</para>'>

<!-- XMLReader -->
<!ENTITY xmlreader.libxml20620.note '<caution xmlns="http://docbook.org/ns/docbook"><para>Esta função só estará disponível quando o PHP for compilado com a 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
um <constant>E_WARNING</constant> se a chamada a este método falhar
(ou seja, não implementado).</para>'>
<!ENTITY userstream.updates.context '<note xmlns="http://docbook.org/ns/docbook"><para>A
propriedade <varname linkend="streamwrapper.props.context">streamWrapper::$context</varname>
será atualizada se um contexto válido for passado para a função invocadora.</para></note>'>

<!-- Gmagick -->
<!ENTITY gmagick.gmagickexception.throw 'Lança uma exceção
<classname xmlns="http://docbook.org/ns/docbook">GmagickException</classname> em caso de erro.'>

<!-- Reflection -->
<!ENTITY reflection.export.return 'Se o parâmetro <parameter xmlns="http://docbook.org/ns/docbook">return</parameter>
for definido como &true;, então a exportação será retornada como uma <type xmlns="http://docbook.org/ns/docbook">string</type>,
caso contrário, &null; será retornado.'>

<!ENTITY reflection.export.param.return 'Definir como &true; retornará a exportação,
em vez de emiti-la. Definir como &false; (o padrão) fará o oposto.'>

<!ENTITY reflection.invoke.reference 'Se a função tiver argumentos que precisam
ser referências, então eles devem ser referências na lista de argumentos passada.'>

<!ENTITY reflection.export.param.name 'A reflexão a ser exportada.'>

<!ENTITY reflection.getattributes.param.name '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>name</parameter></term>
<listitem>
 <para>
  Filtra os resultados para incluir apenas instâncias de <classname>ReflectionAttribute</classname>
  para atributos correspondentes a este nome de classe.
 </para>
</listitem>
</varlistentry>'>

<!ENTITY reflection.getattributes.param.flags '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>flags</parameter></term>
<listitem>
 <para>
  Flags para determinar como filtrar os resultados, se <parameter>name</parameter>
  for fornecido.
 </para>
 <para>
  O padrão é <literal>0</literal>, que retornará apenas os resultados para atributos que
  são da classe <parameter>name</parameter>.
 </para>
 <para>
  A única outra opção disponível é usar <constant>ReflectionAttribute::IS_INSTANCEOF</constant>,
  que usará <literal>instanceof</literal> para filtragem.
 </para>
</listitem>
</varlistentry>'>

<!-- 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">A SPL fornece um conjunto de exceções padrão.</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>A SPL fornece várias classes para trabalhar com 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">A 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">A SPL fornece um conjunto de iteradores para percorrer objetos.</para>'>

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

<!-- ZIP -->
<!ENTITY zip.filename.separator '<note xmlns="http://docbook.org/ns/docbook"><simpara>Para portabilidade máxima, é recomendável sempre usar barras normais (<literal>/</literal>) como separador de diretório em nomes de arquivos ZIP.</simpara></note>'>

<!-- Win32Service -->
<!ENTITY win32service.false.error ', &false; se houver um problema com os parâmetros ou um <link xmlns="http://docbook.org/ns/docbook" linkend="win32service.constants.errors">Código de Erro Win32</link> em caso de falha.'>
<!ENTITY win32service.noerror.false.error 'retornava <constant xmlns="http://docbook.org/ns/docbook">WIN32_NO_ERROR</constant> em caso de 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. Deve ser especificado como um único caractere da lista abaixo.
</para>
<table xmlns="http://docbook.org/ns/docbook">
 <title>Tipos</title>
 <tgroup cols="2">
  <tbody>
   <row><entry>=</entry><entry>O tipo é retirado do MIB</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 definida ao compilar a biblioteca <acronym>SNMP</acronym>, os seguintes tipos também são válidos:
</para>
<table xmlns="http://docbook.org/ns/docbook">
 <title>Tipos</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 destes tipos usará o tipo ASN.1 correspondente óbvio. &apos;s&apos;, &apos;x&apos;, &apos;d&apos; e &apos;b&apos; são todas maneiras diferentes de especificar um valor OCTET STRING e
 o tipo sem sinal &apos;u&apos; também é usado para lidar com valores Gauge32.
</para>
'>
<!ENTITY snmp.set.type.values.equal.note '<para xmlns="http://docbook.org/ns/docbook">
 Se os arquivos MIB forem carregados na árvore MIB com "snmp_read_mib" ou ao especificar isso na configuração da libsnmp, &apos;=&apos; pode ser usado como
 o parâmetro <parameter>type</parameter> para todos os IDs de objeto, pois o tipo pode ser lido automaticamente a partir do MIB.
</para>
'>
<!ENTITY snmp.set.type.values.bitset.note '<para xmlns="http://docbook.org/ns/docbook">
 Note que existem duas maneiras de definir uma variável do tipo BITS como, por exemplo,
 "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>
   Usando o tipo "b" e uma lista de números binários. Este método não é recomendado, pois a consulta GET para o mesmo OID retornaria, por exemplo, 0xF8.
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   Usando o tipo "x" e um número hexadecimal, mas sem (!) o prefixo "0x" comum.
  </simpara>
 </listitem>
</itemizedlist>
<para xmlns="http://docbook.org/ns/docbook">
 Consulte a seção de exemplos para obter 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 habilitar o lançamento de exceções SNMPException quando ocorrer algum dos erros da biblioteca,
 o parâmetro <parameter>exceptions_enabled</parameter> da classe SNMP
 deve ser definido com um valor correspondente. Consulte a <link linkend="snmp.props.exceptions-enabled">
 explicação sobre <parameter>SNMP::$exceptions_enabled</parameter></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 é concluída.
Ela deve corresponder ao 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 dados personalizados passados para a requisição.</para></listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>result</parameter></term>
<listitem><para>valor de resultado específico da requisição; basicamente, o valor retornado pela chamada de sistema
correspondente.</para></listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>req</parameter></term>
<listitem><para>é um recurso de requisição opcional que pode ser usado com 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> ou &null;.
Se &null; for passado, o parâmetro <parameter
xmlns="http://docbook.org/ns/docbook">pri</parameter> internamente será definido como
<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 caminhos
relativos</simpara></warning>
'>

<!ENTITY trader.arg.array.of.real 'Array de valores reais.'>
<!ENTITY trader.arg.array.of.real.high 'Preço alto, array de valores reais.'>
<!ENTITY trader.arg.array.of.real.low 'Preço baixo, array de valores reais.'>
<!ENTITY trader.arg.array.of.real.close 'Preço de fechamento, 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 em outro candle.'>
<!ENTITY trader.arg.vfactor 'Fator de volume. Intervalo válido de 1 a 0.'>
<!ENTITY trader.arg.time.period 'Número de período. Intervalo válido de 2 a 100000.'>
<!ENTITY trader.arg.fast.period 'Número de período para o MA rápido. Intervalo válido de 2 a 100000.'>
<!ENTITY trader.arg.slow.period 'Número de período para o MA lento. Intervalo válido de 2 a 100000.'>
<!ENTITY trader.arg.signal.period 'Suavização da linha de sinal (número de período). Intervalo válido de 1 a 100000.'>
<!ENTITY trader.arg.fastk.period 'Período de tempo para a construção da linha Fast-K. Intervalo válido de 1 a 100000.'>
<!ENTITY trader.arg.fastd.period 'Suavização na construção da linha Fast-D. Intervalo válido de 1 a 100000, geralmente 3.'>
<!ENTITY trader.arg.slowk.period 'Suavização na construção da linha Slow-K. Intervalo válido de 1 a 100000, geralmente 3.'>
<!ENTITY trader.arg.slowd.period 'Suavização na construção da linha Slow-D. Intervalo válido de 1 a 100000.'>
<!ENTITY trader.arg.min.period 'Valor inferior ao mínimo que será modificado para período mínimo. Intervalo válido de 2 a 100000.'>
<!ENTITY trader.arg.max.period 'Valor superior ao mínimo que será modificado para período máximo. Intervalo válido de 2 a 100000.'>
<!ENTITY trader.arg.ma.type 'Tipo de Média Móvel. As constantes <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> devem ser usadas.'>
<!ENTITY trader.arg.fast.ma.type 'Tipo de Média Móvel para o MA rápido. As constantes <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> devem ser usadas.'>
<!ENTITY trader.arg.slow.ma.type 'Tipo de Média Móvel para o MA lento. As constantes <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> devem ser usadas.'>
<!ENTITY trader.arg.fastd.ma.type 'Tipo de Média Móvel para o Fast-D. As constantes <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> devem ser usadas.'>
<!ENTITY trader.arg.slowk.ma.type 'Tipo de Média Móvel para o Slow-K. As constantes <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> devem ser usadas.'>
<!ENTITY trader.arg.slowd.ma.type 'Tipo de Média Móvel para o Slow-D. As constantes <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> devem ser usadas.'>
<!ENTITY trader.arg.signal.ma.type 'Tipo de Média Móvel para a linha de sinal. As constantes <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> devem ser usadas.'>
<!ENTITY trader.arg.nbdevup 'Multiplicador de desvio para banda superior. Intervalo válido 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 'Multiplicador de desvio para a banda inferior. Intervalo válido 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 usado no algoritmo adaptativo. Intervalo válido de 0.01 a 0.99.'>
<!ENTITY trader.arg.slow.limit 'Limite inferior usado no algoritmo adaptativo. Intervalo válido de 0.01 a 0.99.'>

<!-- mongodb -->
<!ENTITY mongodb.changelog.tentative-return-types '
       <row xmlns="http://docbook.org/ns/docbook">
        <entry>mongodb 1.15.0 no PECL</entry>
        <entry>
         Os tipos de retorno para métodos são declarados como provisórios no PHP 8.0 e mais recentes,
         disparando 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.option.collation '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>collation</entry>
          <entry><type class="union"><type>array</type><type>object</type></type></entry>
          <entry>
           <para>
            <link xlink:href="&url.mongodb.docs.collation;" xmlns:xlink="http://www.w3.org/1999/xlink">Collation</link> permite que os usuários especifiquem regras específicas do idioma para comparação de strings, como regras para maiúsculas e minúsculas e acentos. Ao especificar a collation, o campo <literal>"locale"</literal> é obrigatório; todos os outros campos de collation são opcionais. Para obter descrições dos campos, veja o <link xlink:href="&url.mongodb.docs.collation;#collation-document" xmlns:xlink="http://www.w3.org/1999/xlink">Documento de Collation</link>.
           </para>
           <para>
            Se a collation não for especificada, mas a coleção tiver uma collation padrão, a operação usará a collation especificada para a coleção. Se nenhuma collation for especificada para a coleção ou para a operação, o MongoDB usará a comparação binária simples usada em versões anteriores para comparações de strings.
           </para>
           <para>
            Esta opção está disponível no MongoDB 3.4+ e resultará em uma exceção em tempo de execução se for especificada para uma versão de servidor mais antiga.
           </para>
          </entry>
         </row>
'>
<!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 (por exemplo, <literal>$$var</literal>).
           </para>
           <para>
            Esta opção está disponível no MongoDB 5.0+ e resultará em uma exceção em tempo de execução se for especificada para uma versão de servidor mais antiga.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.keyVaultClient '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>keyVaultClient</entry>
          <entry><classname>MongoDB\Driver\Manager</classname></entry>
          <entry>O Manager usado para rotear consultas de chave de dados para um cluster MongoDB separado. Por padrão, o Manager e o cluster atuais são usados.</entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.keyVaultNamespace '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>keyVaultNamespace</entry>
          <entry><type>string</type></entry>
          <entry>Um namespace totalmente qualificado (por exemplo, <literal>"nomeDoBancoDados.nomeDaColecao"</literal>) denotando a coleção que contém todas as chaves de dados usadas para criptografia e descriptografia. Esta opção é obrigatória.</entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.kmsProviders '
         <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
          <entry>kmsProviders</entry>
          <entry><type>array</type></entry>
          <entry>
           <para>
            Um documento contendo a configuração de um ou mais provedores KMS, que são usados para criptografar chaves de dados. Os provedores compatíveis incluem <literal>"aws"</literal>, <literal>"azure"</literal>, <literal>"gcp"</literal>, <literal>"kmip"</literal> e <literal>"local"</literal> e pelo menos um deve ser especificado.
           </para>
           <para>
            Se um documento vazio for especificado para <literal>"aws"</literal>,
            <literal>"azure"</literal>, ou <literal>"gcp"</literal>, o driver
            tentará configurar o provedor usando
            <link xlink:href="&url.mongodb.specs;/blob/master/source/client-side-encryption/client-side-encryption.rst#automatic-credentials">Credenciais Automáticas</link>.
           </para>
           <para>
            O formato para <literal>"aws"</literal> é o seguinte:
           </para>
           <programlisting role="javascript">
<![CDATA[
aws: {
    accessKeyId: <string>,
    secretAccessKey: <string>,
    sessionToken: <string opcional>
}
]]>
           </programlisting>
           <para>
            O formato para <literal>"azure"</literal> é o seguinte:
           </para>
           <programlisting role="javascript">
<![CDATA[
azure: {
    tenantId: <string>,
    clientId: <string>,
    clientSecret: <string>,
    identityPlatformEndpoint: <string opcional> // O padrão é "login.microsoftonline.com"
}
]]>
           </programlisting>
           <para>
            O formato para <literal>"gcp"</literal> é o seguinte:
           </para>
           <programlisting role="javascript">
<![CDATA[
gcp: {
    email: <string>,
    privateKey: <string base64>|<MongoDB\BSON\Binary>,
    endpoint: <string opcional> // O padrão é "oauth2.googleapis.com"
}
]]>
           </programlisting>
           <para>
            O formato para <literal>"kmip"</literal> é o seguinte:
           </para>
           <programlisting role="javascript">
<![CDATA[
kmip: {
    endpoint: <string>
}
]]>
           </programlisting>
           <para>
            O formato para <literal>"local"</literal> é o seguinte:
           </para>
           <programlisting role="javascript">
<![CDATA[
local: {
    // Chave mestra de 96 bytes usada para criptografar/descriptografar chaves de dados
    key: <string base64>|<MongoDB\BSON\Binary>
}
]]>
           </programlisting>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.masterKey-options-by-provider '
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title>Opções do provedor <literal>"aws"</literal></title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Opção</entry>
       <entry>Tipo</entry>
       <entry>Descrição</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>region</entry>
       <entry>string</entry>
       <entry>Obrigatória.</entry>
      </row>
      <row>
       <entry>key</entry>
       <entry>string</entry>
       <entry>Obrigatória. 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 servidor alternativo para o qual enviar requisições KMS. Pode incluir o número da porta.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title>Opções do provedor <literal>"azure"</literal></title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Opção</entry>
       <entry>Tipo</entry>
       <entry>Descrição</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>keyVaultEndpoint</entry>
       <entry>string</entry>
       <entry>Obrigatória. Servidor com porta opcional (por exemplo, "example.vault.azure.net").</entry>
      </row>
      <row>
       <entry>keyName</entry>
       <entry>string</entry>
       <entry>Obrigatória.</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 primária da chave.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title>Opções do provedor <literal>"gcp"</literal></title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Opção</entry>
       <entry>Tipo</entry>
       <entry>Descrição</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>projectId</entry>
       <entry>string</entry>
       <entry>Obrigatória.</entry>
      </row>
      <row>
       <entry>location</entry>
       <entry>string</entry>
       <entry>Obrigatória.</entry>
      </row>
      <row>
       <entry>keyRing</entry>
       <entry>string</entry>
       <entry>Obrigatória.</entry>
      </row>
      <row>
       <entry>keyName</entry>
       <entry>string</entry>
       <entry>Obrigatória.</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 primária da chave.</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>string</entry>
       <entry>Opcional. Servidor com porta opcional. O padrão é "cloudkms.googleapis.com".</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title>Opções do provedor <literal>"kmip"</literal></title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Opção</entry>
       <entry>Tipo</entry>
       <entry>Descrição</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>keyId</entry>
       <entry>string</entry>
       <entry>Opcional. Identificador único 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. Servidor 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 contendo a configuração TLS para um ou mais provedores KMS. Os 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: <string opcional>,
    tlsCertificateKeyFile: <string opcional>,
    tlsCertificateKeyFilePassword: <string opcional>,
    tlsDisableOCSPEndpointCheck: <booleano opcional>
}
]]>
           </programlisting>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.maxCommitTimeMS '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>maxCommitTimeMS</entry>
          <entry>integer</entry>
          <entry>
           <para>
            A quantidade máxima de tempo em milissegundos para permitir que um único
            comando <literal>commitTransaction</literal> seja executado.
           </para>
           <para>
            Se especificada, <literal>maxCommitTimeMS</literal> deve ser um inteiro
            de 32 bits com sinal com valor maior ou igual a zero.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.readConcern '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>readConcern</entry>
          <entry><classname>MongoDB\Driver\ReadConcern</classname></entry>
          <entry>
           <para>
            Um read concern a ser aplicado à operação.
           </para>
           <para>
            Esta opção está disponível no MongoDB 3.2+ e resultará em uma
            exceção em tempo de execução se for especificada para uma versão de servidor
            mais antiga.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.readPreference '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>readPreference</entry>
          <entry><classname>MongoDB\Driver\ReadPreference</classname></entry>
          <entry>
           <para>
            Uma preferência de leitura a ser usada para selecionar um servidor para a operação.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.session '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>session</entry>
          <entry><classname>MongoDB\Driver\Session</classname></entry>
          <entry>
           <para>
            Uma sessão para associar à operação.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.transactionReadWriteConcern '
     <warning xmlns="http://docbook.org/ns/docbook">
      <para>
       Se uma <literal>"session"</literal> que tem uma transação em andamento
       estiver sendo usada, uma opção <literal>"readConcern"</literal> ou
       <literal>"writeConcern"</literal> não pode ser especificada. Isso resultará em uma
       exceção <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>
       sendo lançada. Em vez disso, essas duas opções devem ser definidas ao criar
       a transação com
       <methodname>MongoDB\Driver\Session::startTransaction</methodname>.
      </para>
     </warning>
'>
<!ENTITY mongodb.option.writeConcern '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>writeConcern</entry>
          <entry><classname>MongoDB\Driver\WriteConcern</classname></entry>
          <entry>
           <para>
            Um write concern a ser aplicado à operação.
           </para>
          </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 totalmente qualificado (por exemplo, <literal>"nomeDoBancoDados.nomeDaColecao"</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 de dados no qual executar o comando.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.bulkwrite '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>bulk</parameter> (<classname>MongoDB\Driver\BulkWrite</classname>)</term>
    <listitem>
     <para>
      As gravações a serem executadas.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.command '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>command</parameter> (<classname>MongoDB\Driver\Command</classname>)</term>
    <listitem>
     <para>
      O comando a ser executado.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.encryptOpts '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>options</parameter></term>
    <listitem>
     <para>
      <table>
       <title>Opções de criptografia</title>
       <tgroup cols="3">
        <thead>
         <row>
          <entry>Opção</entry>
          <entry>Tipo</entry>
          <entry>Descrição</entry>
         </row>
        </thead>
        <tbody>
         <row>
          <entry>algorithm</entry>
          <entry><type>string</type></entry>
          <entry>
           <para>
            O algoritmo de criptografia a ser usado. Esta opção é obrigatória.
            Especifique uma das seguintes
            <link linkend="mongodb-driver-clientencryption.constants">constantes ClientEncryption</link>:
           </para>
           <simplelist>
            <member><constant>MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_DETERMINISTIC</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_RANDOM</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_UNINDEXED</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE_PREVIEW</constant></member>
           </simplelist>
          </entry>
         </row>
         <row>
          <entry>contentionFactor</entry>
          <entry><type>int</type></entry>
          <entry>
           <para>
            O fator de contenção para avaliar consultas com cargas indexadas e
            criptografadas.
           </para>
           <para>
            Esta opção só se aplica e só pode ser especificada quando
            <literal>algorithm</literal> for
            <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant>
            ou
            <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE_PREVIEW</constant>.
           </para>
          </entry>
         </row>
         <row>
          <entry>keyAltName</entry>
          <entry><type>string</type></entry>
          <entry>
           <para>
            Identifica um documento de coleção de cofres de chaves por
            <literal>keyAltName</literal>. Esta opção é mutuamente exclusiva
            com <literal>keyId</literal> e exatamente uma é necessária.
           </para>
          </entry>
         </row>
         <row>
          <entry>keyId</entry>
          <entry><classname>MongoDB\BSON\Binary</classname></entry>
          <entry>
           <para>
            Identifica uma chave de dados por <literal>_id</literal>. O valor é um UUID
            (subtipo binário 4). Esta opção é mutuamente exclusiva com
            <literal>keyAltName</literal> e exatamente uma é necessária.
           </para>
          </entry>
         </row>
         <row>
          <entry>queryType</entry>
          <entry><type>int</type></entry>
          <entry>
           <para>
            O tipo de consulta para avaliar consultas com cargas indexadas e
            criptografadas. Especifique uma das seguintes
            <link linkend="mongodb-driver-clientencryption.constants">constantes ClientEncryption</link>:
           </para>
           <simplelist>
            <member><constant>MongoDB\Driver\ClientEncryption::QUERY_TYPE_EQUALITY</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE_PREVIEW</constant></member>
           </simplelist>
           <para>Esta opção só se aplica e só pode ser especificada quando
             <literal>algorithm</literal> for
            <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant>
            ou <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE_PREVIEW</constant>.
           </para>
          </entry>
         </row>
         <row>
          <entry>rangeOpts</entry>
          <entry><type>array</type></entry>
          <entry>
           <para>
            Opções de índice para um campo de criptografia consultável compatível
            com consultas "rangePreview". As opções abaixo devem corresponder aos valores definidos
            nos <literal>encryptedFields</literal> da coleção de destino.
            Para tipos de campo double e decimal128 BSON, <literal>min</literal>,
            <literal>max</literal> e <literal>precision</literal> devem ser todos
            definidos ou nenhum definido.
           </para>
           <para>
            <table>
             <title>Opções de índice de intervalo</title>
             <tgroup cols="3">
              <thead>
               <row>
                <entry>Opção</entry>
                <entry>Tipo</entry>
                <entry>Descrição</entry>
               </row>
              </thead>
              <tbody>
               <row>
                <entry>min</entry>
                <entry><type>mixed</type></entry>
                <entry>Obrigatória se <literal>precision</literal> for definida.</entry>
               </row>
               <row>
                <entry>max</entry>
                <entry><type>mixed</type></entry>
                <entry>Obrigatória se <literal>precision</literal> for definida.</entry>
               </row>
               <row>
                <entry>sparsity</entry>
                <entry><type>int</type></entry>
                <entry>Obrigatória.</entry>
               </row>
               <row>
                <entry>precision</entry>
                <entry><type>int</type></entry>
                <entry>Opcional. Só pode ser definida para tipos de campo double ou decimal128 BSON.</entry>
               </row>
              </tbody>
             </tgroup>
            </table>
           </para>
          </entry>
         </row>
        </tbody>
       </tgroup>
      </table>
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.query '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>query</parameter> (<classname>MongoDB\Driver\Query</classname>)</term>
    <listitem>
     <para>
      A consulta a ser executada.
     </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">Configuração de mapeamento de tipos</link>.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.filter '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>filter</parameter> (<type class="union"><type>array</type><type>object</type></type>)</term>
    <listitem>
     <para>
      O <link xlink:href="&url.mongodb.docs;tutorial/query-documents/" xmlns:xlink="http://www.w3.org/1999/xlink">predicado de consulta</link>.
      Um predicado vazio corresponderá a todos os documentos da coleção.
     </para>
     <note>
      <simpara>
       Ao avaliar os critérios de consulta, o MongoDB compara os tipos e valores de acordo com suas próprias <link xlink:href="&url.mongodb.docs;reference/bson-type-comparison-order/" xmlns:xlink="http://www.w3.org/1999/xlink">regras de comparação para tipos BSON</link>, que diferem das regras de <link linkend="types.comparisons">comparação</link> e do <link linkend="language.types.type-juggling">malabarismo de tipos</link> do PHP. Ao corresponder a um tipo especial de BSON, os critérios de consulta devem usar a respectiva <link linkend="book.bson">classe BSON</link> (por exemplo, use <classname>MongoDB\BSON\ObjectId</classname> para corresponder a um <link xlink:href="&url.mongodb.docs.objectid;" xmlns:xlink="http://www.w3.org/1999/xlink">ObjectId</link>).
      </simpara>
     </note>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.returns.cursor '<para xmlns="http://docbook.org/ns/docbook">Retorna <classname>MongoDB\Driver\Cursor</classname> em caso de sucesso.</para>'>
<!ENTITY mongodb.returns.writeresult '<para xmlns="http://docbook.org/ns/docbook">Retorna <classname>MongoDB\Driver\WriteResult</classname> em caso de sucesso.</para>'>
<!ENTITY mongodb.throws.std '&mongodb.throws.argumentparsing;&mongodb.throws.connection;&mongodb.throws.authentication;'>
<!ENTITY mongodb.throws.session-readwriteconcern '<member xmlns="http://docbook.org/ns/docbook">Lança uma exceção <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname> se a opção <literal>"session"</literal> for usada com uma transação associada em combinação com uma opção <literal>"readConcern"</literal> ou <literal>"writeConcern"</literal>.</member>'>
<!ENTITY mongodb.throws.session-unacknowledged '<member xmlns="http://docbook.org/ns/docbook">Lança uma exceção <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname> se a opção <literal>"session"</literal> for usada em combinação com um write concern não confirmado.</member>'>
<!ENTITY mongodb.throws.bulkwriteexception '<member xmlns="http://docbook.org/ns/docbook">Lança uma exceção <classname>MongoDB\Driver\Exception\BulkWriteException</classname> em caso de qualquer falha de escrita (por exemplo, erro de escrita, falha ao aplicar um write concern).</member>'>
<!ENTITY mongodb.throws.argumentparsing '<member xmlns="http://docbook.org/ns/docbook">Lança uma exceção <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname> em caso de erro ao analisar argumentos.</member>'>
<!ENTITY mongodb.throws.authentication '<member xmlns="http://docbook.org/ns/docbook">Lança uma exceção <classname>MongoDB\Driver\Exception\AuthenticationException</classname> se a autenticação for necessária e falhar.</member>'>
<!ENTITY mongodb.throws.connection '<member xmlns="http://docbook.org/ns/docbook">Lança uma exceção <classname>MongoDB\Driver\Exception\ConnectionException</classname> se a conexão com o servidor falhar (por outros motivos além da autenticação).</member>'>
<!ENTITY mongodb.throws.bson.unexpected '<member xmlns="http://docbook.org/ns/docbook">Lança uma exceção <classname>MongoDB\Driver\Exception\UnexpectedValueException</classname> se a entrada não contiver exatamente um documento BSON. Os possíveis motivos incluem, mas não estão limitados a, BSON inválido, dados extras (depois de ler um documento BSON) ou um erro inesperado da <link xlink:href="&url.mongodb.libbson;" xmlns:xlink="http://www.w3.org/1999/xlink">libbson</link>.</member>'>


<!ENTITY mongodb.note.decimal128 '
   <note xmlns="http://docbook.org/ns/docbook">
    <simpara>
     <classname>MongoDB\BSON\Decimal128</classname> só é compatível com
     o MongoDB 3.4+. Tentar usar o tipo BSON com uma versão anterior do
     MongoDB resultará em erro.
    </simpara>
   </note>
'>
<!ENTITY mongodb.note.extended-json '
  <note xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <simpara>
    A saída é consistente com a função <function>MongoDB\BSON\toJSON</function>,
    que usa o formato JSON estendido legado específico do driver. Isso
    não corresponde necessariamente às representações JSON estendidas
    <link xlink:href="&url.mongodb.specs.extendedjson;#relaxed-extended-json-example">relaxadas</link>
    ou <link xlink:href="&url.mongodb.specs.extendedjson;#canonical-extended-json-example">canônicas</link>
    usadas por
    <function>MongoDB\BSON\toRelaxedExtendedJSON</function> e
    <function>MongoDB\BSON\toCanonicalExtendedJSON</function>, respectivamente.
   </simpara>
  </note>
'>
<!ENTITY mongodb.note.forking '
   <note xmlns="http://docbook.org/ns/docbook">
    <simpara>
     Em plataformas Unix, o driver do MongoDB é sensível a scripts que usam a
     chamada de sistema fork() sem chamar também exec(). Os usuários são aconselhados a não
     reusar instâncias de <classname>MongoDB\Driver\Manager</classname> em um
     processo filho bifurcado.
    </simpara>
   </note>
'>

<!ENTITY mongodb.note.uint32 '
  <note xmlns="http://docbook.org/ns/docbook">
   <simpara>
    Como o tipo inteiro do PHP possui sinal, alguns valores retornados por este
    método podem aparecer como números inteiros negativos em plataformas de 32 bits. O
    formatador <literal>"&#37;u"</literal> de <function>sprintf</function> pode ser
    usado para obter uma representação em string do valor decimal sem sinal.
   </simpara>
  </note>
'>

<!ENTITY mongodb.note.server.readpreference '
  <note xmlns="http://docbook.org/ns/docbook">
   <simpara>
    A opção <literal>"readPreference"</literal> não controla o servidor
    ao qual o driver emite a operação; ela sempre será executada
    neste objeto servidor. Em vez disso, ela pode ser usada ao emitir a operação para um
    servidor secundário (de uma conexão de conjunto de réplicas, não autônomas) ou nós mongo para
    garantir que o driver defina o protocolo de conexão de acordo ou adicione a
    preferência de leitura à operação, respectivamente.
   </simpara>
  </note>
'>

<!ENTITY mongodb.note.server.write '
  <note xmlns="http://docbook.org/ns/docbook">
   <simpara>
    É responsabilidade do invocador garantir que o servidor seja capaz
    de executar a operação de escrita. Por exemplo, executar uma operação de escrita
    em um servidor secundário (excluindo seu banco de dados "local") falhará.
   </simpara>
  </note>
'>

<!ENTITY mongodb.warning.duplicate-keys '
   <warning xmlns="http://docbook.org/ns/docbook">
    <simpara>
     Os documentos BSON tecnicamente podem conter chaves duplicadas porque os documentos são
     armazenados como uma lista de pares chave-valor; no entanto, as aplicações devem evitar
     a geração de documentos com chaves duplicadas, pois o comportamento do servidor e do driver
     pode ser indefinido. Como os objetos e arrays do 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 deve ser criada por meio de <function>radius_create_request</function> antes que esta função possa ser chamada.</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 resource RADIUS.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.options '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>options</parameter></term><listitem><para>Uma máscara de bits das opções de atributo. As opções disponíveis 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>A tag de atributo. Este parâmetro é ignorado, a menos que a opção <link linkend="constant.radius-option-tagged"><constant>RADIUS_OPTION_TAGGED</constant></link> esteja definida.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.vendor '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>vendor</parameter></term><listitem><para>O ID do fornecedor.</para></listitem></varlistentry>'>

<!-- posix snippets -->
<!ENTITY posix.parameter.fd '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>file_descriptor</parameter></term>
 <listitem>
  <para>
   O descritor de arquivo, que deve ser um
   <type>resource</type> de arquivo ou um <type>int</type>. Um <type>int</type>
   será interpretado como um descritor de arquivo que pode ser passado diretamente
   para a chamada de sistema subjacente.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY posix.rlimits '
<para xmlns="http://docbook.org/ns/docbook">
  Cada recurso tem um limite flexível e um limite rígido associado. O limite
  flexível é o valor que o kernel impõe ao recurso
  correspondente. O limite rígido funciona com um teto máximo para o limite flexível.
  Um processo sem privilégios pode apenas definir seu limite flexível para um valor
  entre 0 e o limite rígido e reduzir irreversivelmente seu limite rígido.
</para>
'>

<!-- strings snippets -->
<!ENTITY strings.parameter.encoding '
 <para xmlns="http://docbook.org/ns/docbook">
  Um argumento opcional que define a codificação usada na conversão de caracteres.
 </para>

 <para xmlns="http://docbook.org/ns/docbook">
  Se omitido, <parameter>encoding</parameter> assume como padrão o valor da
  opção de configuração <link linkend="ini.default-charset">default_charset
  </link>.
 </para>

 <para xmlns="http://docbook.org/ns/docbook">
  Embora este argumento seja tecnicamente opcional, especificar o valor correto
  para o código é altamente recomendável
  se a opção de configuração <link linkend="ini.default-charset">default_charset</link>
  puder ser definida incorretamente para a entrada fornecida.
 </para>
'>

<!ENTITY strings.parameter.format '
<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>format</parameter></term>
 <listitem>
  <para>
   A string de formato é composta de zero ou mais diretivas:
   caracteres comuns (excluindo <literal>&#37;</literal>) que são
   copiados diretamente para o resultado e <emphasis>especificações
   de conversão</emphasis>, cada uma das quais resulta na busca de seu
   próprio parâmetro.
  </para>

  <para>
   Uma especificação de conversão segue este protótipo:
   <literal>&#37;[argnum$][flags][width][.precision]especificador</literal>.
  </para>

  <formalpara>
   <title>Argnum</title>
   <para>
    Um número inteiro seguido por um cifrão <literal>$</literal>,
    para especificar qual o número de argumento a tratar na conversão.
   </para>
  </formalpara>

  <para>
   <table>
    <title>Flags</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Flag</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>-</literal></entry>
       <entry>
        Justificar à esquerda dentro da largura de campo especificada;
        A justificação à direita é o padrão.
       </entry>
      </row>
      <row>
       <entry><literal>+</literal></entry>
       <entry>
        Prefixa números positivos com um sinal de mais
        <literal>+</literal>; Por padrão, apenas números negativos
        são prefixados com um sinal negativo.
       </entry>
      </row>
      <row>
       <entry><literal> </literal>(espaço)</entry>
       <entry>
        Preenche o resultado com espaços.
        Este é o padrão.
       </entry>
      </row>
      <row>
       <entry><literal>0</literal></entry>
       <entry>
        Preenche números com zeros apenas à esquerda.
        Com os especificadores <literal>s</literal>, também pode
        preencher com zeros à direita.
       </entry>
      </row>
      <row>
       <entry><literal>&apos;</literal>(char)</entry>
       <entry>
        Preenche o resultado com o caractere (char).
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>

  <formalpara>
   <title>Width</title>
   <para>
    Um número inteiro que define em quantos caracteres (mínimo)
    esta conversão deve resultar, ou <literal>*</literal>.
    Se <literal>*</literal> for usado, a largura será fornecida
    como um valor inteiro adicional precedendo aquele formatado
    pelo especificador.
   </para>
  </formalpara>

  <formalpara>
   <title>Precision</title>
   <para>
    Um ponto <literal>.</literal> opcionalmente seguido por
    um número inteiro ou <literal>*</literal>,
    cujo significado depende do especificador:
    <itemizedlist>
     <listitem>
      <simpara>
       Para os especificadores <literal>e</literal>, <literal>E</literal>,
       <literal>f</literal> e <literal>F</literal>:
       este é o número de dígitos a serem impressos
       após o ponto decimal (por padrão, é 6).
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Para os especificadores <literal>g</literal>, <literal>G</literal>,
       <literal>h</literal> e <literal>H</literal>:
       este é o número máximo de dígitos
       significativos a serem impressos.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Para o especificador <literal>s</literal>: atua como um ponto de corte,
       definindo um limite máximo de caracteres para a string.
      </simpara>
     </listitem>
    </itemizedlist>
    <note>
     <simpara>
      Se o ponto for especificado sem um valor explícito para precisão,
      0 é assumido. Se <literal>*</literal> for usado, a precisão é
      fornecida como um valor inteiro adicional precedendo aquele formatado
      pelo especificador.
     </simpara>
    </note>
   </para>
  </formalpara>

  <para>
   <table>
    <title>Especificadores</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Especificador</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>&#37;</literal></entry>
       <entry>
        Um caractere literal de porcentagem. Nenhum argumento é necessário.
       </entry>
      </row>
      <row>
       <entry><literal>b</literal></entry>
       <entry>
        O argumento é tratado como um número inteiro e apresentado
        como um número binário.
       </entry>
      </row>
      <row>
       <entry><literal>c</literal></entry>
       <entry>
        O argumento é tratado como um número inteiro e apresentado
        como o caractere com aquele código ASCII.
       </entry>
      </row>
      <row>
       <entry><literal>d</literal></entry>
       <entry>
        O argumento é tratado como um número inteiro e apresentado
        como um número decimal (com sinal).
       </entry>
      </row>
      <row>
       <entry><literal>e</literal></entry>
       <entry>
        O argumento é tratado como notação científica (por exemplo, 1.2e+2).
       </entry>
      </row>
      <row>
       <entry><literal>E</literal></entry>
       <entry>
        Como o especificador <literal>e</literal>, mas usa
        letra maiúscula (por exemplo, 1.2E+2).
       </entry>
      </row>
      <row>
       <entry><literal>f</literal></entry>
       <entry>
        O argumento é tratado como um float e apresentado
        como um número de ponto flutuante (com reconhecimento da localidade).
       </entry>
      </row>
      <row>
       <entry><literal>F</literal></entry>
       <entry>
        O argumento é tratado como um float e apresentado
        como um número de ponto flutuante (sem reconhecimento da localidade).
       </entry>
      </row>
      <row>
       <entry><literal>g</literal></entry>
       <entry>
        <para>
         Formato geral.
        </para>
        <para>
         Deixa P igual à precisão se for diferente de zero, 6 se a precisão for omitida,
         ou 1 se a precisão for zero.
         Então, se uma conversão com estilo E tivesse um expoente de X:
        </para>
        <para>
         Se P > X ≥ −4, a conversão é com estilo f e precisão P − (X + 1).
         Caso contrário, a conversão é com estilo e e precisão P − 1.
        </para>
       </entry>
      </row>
      <row>
       <entry><literal>G</literal></entry>
       <entry>
        Como o especificador <literal>g</literal>, mas usa
        <literal>E</literal> e <literal>f</literal>.
       </entry>
      </row>
      <row>
       <entry><literal>h</literal></entry>
       <entry>
        Como o especificador <literal>g</literal>, mas usa <literal>F</literal>.
        Disponível a partir do PHP 8.0.0.
       </entry>
      </row>
      <row>
       <entry><literal>H</literal></entry>
       <entry>
        Como o especificador <literal>g</literal>, mas usa
        <literal>E</literal> e <literal>F</literal>. Disponível a partir do PHP 8.0.0.
       </entry>
      </row>
      <row>
       <entry><literal>o</literal></entry>
       <entry>
        O argumento é tratado como um número inteiro e apresentado
        como um número octal.
       </entry>
      </row>
      <row>
       <entry><literal>s</literal></entry>
       <entry>
        O argumento é tratado e apresentado como uma string.
       </entry>
      </row>
      <row>
       <entry><literal>u</literal></entry>
       <entry>
        O argumento é tratado como um número inteiro e apresentado
        como um número decimal sem sinal.
       </entry>
      </row>
      <row>
       <entry><literal>x</literal></entry>
       <entry>
        O argumento é tratado como um número inteiro e apresentado
        como um número hexadecimal (com letras minúsculas).
       </entry>
      </row>
      <row>
       <entry><literal>X</literal></entry>
       <entry>
        O argumento é tratado como um número inteiro e apresentado
        como um número hexadecimal (com letras maiúsculas).
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>

  <warning>
   <para>
    O especificador de tipo <literal>c</literal> ignora preenchimento e largura.
   </para>
  </warning>

  <warning>
   <para>
    Tentar usar uma combinação dos especificadores de string e largura com conjuntos de caracteres que requerem mais de um byte por caractere pode resultar em resultados inesperados.
   </para>
  </warning>

  <para>
   As variáveis serão forçadas a um tipo adequado para o especificador:
   <table>
    <title>Tratamento de Tipos</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Tipo</entry>
       <entry>Especificadores</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><type>string</type></entry>
       <entry><literal>s</literal></entry>
      </row>
      <row>
       <entry><type>int</type></entry>
       <entry>
        <literal>d</literal>,
        <literal>u</literal>,
        <literal>c</literal>,
        <literal>o</literal>,
        <literal>x</literal>,
        <literal>X</literal>,
        <literal>b</literal>
       </entry>
      </row>
      <row>
       <entry><type>float</type></entry>
       <entry>
        <literal>e</literal>,
        <literal>E</literal>,
        <literal>f</literal>,
        <literal>F</literal>,
        <literal>g</literal>,
        <literal>G</literal>,
        <literal>h</literal>,
        <literal>H</literal>
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
 </listitem>
</varlistentry>
'>

<!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
       as 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é o momento.
        </member>
        <member>
         <literal>s</literal> pára de ler em qualquer caractere de espaço em branco.
        </member>
        <member>
         <literal>*</literal> em vez de <literal>argnum$</literal> suprime
         a atribuição desta especificação de conversão.
        </member>
       </simplelist>
      </para>
     </listitem>
    </varlistentry>
'>

<!ENTITY strings.parameter.needle.non-string '
 <para xmlns="http://docbook.org/ns/docbook">
  Antes do PHP 8.0.0, se <parameter>needle</parameter> não for uma string, ela será convertida
  para um número inteiro e aplicada como o valor ordinal de um caractere.
  Este comportamento tornou-se obsoleto a partir do PHP 7.3.0 e depender dele é altamente
  desaconselhado. Dependendo do comportamento pretendido, o parâmetro
  <parameter>needle</parameter> deve ser explicitamente convertido em string
  ou uma chamada explícita para <function>chr</function> deve ser realizada.
 </para>
'>

<!ENTITY strings.changelog.needle-empty '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  O parâmetro <parameter>needle</parameter> agora aceita uma string vazia.
 </entry>
</row>'>
<!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 redução de todas as letras a maiúsculas ou minúsculas não depende mais da localidade definida com
   <function>setlocale</function>. Somente a redução de todas as letras ASCII a maiúsculas ou minúsculas será feita.
   Os bytes não ASCII serão comparados por seu valor de byte.
  </entry>
 </row>
'>

<!ENTITY strings.changelog.sprintf '
  <informaltable xmlns="http://docbook.org/ns/docbook">
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Esta função não retorna mais &false; em caso de falha.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Lança um erro <classname>ValueError</classname> se o número de argumentos for zero;
       anteriormente, esta função emitia um <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Lança um erro <classname>ValueError</classname> se <literal>[width]</literal> for menor que zero ou maior que <constant>PHP_INT_MAX</constant>;
       anteriormente, esta função emitia um <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Lança um erro <classname>ValueError</classname> se <literal>[precision]</literal> for menor que zero ou maior que <constant>PHP_INT_MAX</constant>;
       anteriormente, esta função emitia um <constant>E_WARNING</constant>.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Lança um erro <classname>ArgumentCountError</classname> quando menos argumentos do que o necessário são fornecidos;
       anteriormente, esta função emitia um <constant>E_WARNING</constant>.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
'>

<!ENTITY strings.errors.sprintf '
  <para xmlns="http://docbook.org/ns/docbook">
   A partir do PHP 8.0.0, um erro <classname>ValueError</classname> será lançado se o número de argumentos for zero.
   Antes do PHP 8.0.0, um <constant>E_WARNING</constant> era emitido.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   A partir do PHP 8.0.0, um erro <classname>ValueError</classname> será lançado se <literal>[width]</literal> for menor que zero ou maior que <constant>PHP_INT_MAX</constant>.
   Antes do PHP 8.0.0, um <constant>E_WARNING</constant> era emitido.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   A partir do PHP 8.0.0, um erro <classname>ValueError</classname> será lançado se <literal>[precision]</literal> for menor que zero ou maior que <constant>PHP_INT_MAX</constant>.
   Antes do PHP 8.0.0, um <constant>E_WARNING</constant> era emitido.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   A partir do PHP 8.0.0, um erro <classname>ArgumentCountError</classname> será lançado quando menos argumentos do que o necessário forem fornecidos.
   Antes do PHP 8.0.0, &false; era retornado e um <constant>E_WARNING</constant> era emitido.
  </para>
'>

<!ENTITY strings.errors.vsprintf '
  <para xmlns="http://docbook.org/ns/docbook">
   A partir do PHP 8.0.0, um erro <classname>ValueError</classname> será lançado se o número de argumentos for zero.
   Antes do PHP 8.0.0, um <constant>E_WARNING</constant> era emitido.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   A partir do PHP 8.0.0, um erro <classname>ValueError</classname> será lançado se <literal>[width]</literal> for menor que zero ou maior que <constant>PHP_INT_MAX</constant>.
   Antes do PHP 8.0.0, um <constant>E_WARNING</constant> era emitido.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   A partir do PHP 8.0.0, um erro <classname>ValueError</classname> será lançado se <literal>[precision]</literal> for menor que zero ou maior que <constant>PHP_INT_MAX</constant>.
   Antes do PHP 8.0.0, um <constant>E_WARNING</constant> era emitido.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   A partir do PHP 8.0.0, um erro <classname>ArgumentCountError</classname> será lançado quando menos argumentos do que o necessário forem fornecidos.
   Antes do PHP 8.0.0, &false; era retornado e um <constant>E_WARNING</constant> era emitido.
  </para>
'>

<!-- 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. A página do manual <xref linkend="filter.filters" />
    lista os filtros disponíveis.
   </para>
   <para>
    Se omitido, <constant>FILTER_DEFAULT</constant> será usado, que é
    equivalente a
    <link linkend="filter.filters.sanitize"><constant>FILTER_UNSAFE_RAW</constant></link>.
    Isso resultará em nenhuma filtragem ocorrendo por padrão.
   </para>
  </listitem>
 </varlistentry>
'>

<!-- csprng snippets -->
<!ENTITY csprng.sources '
<para xmlns="http://docbook.org/ns/docbook">
 As fontes de aleatoriedade usadas para esta função são as seguintes:
</para>
<itemizedlist xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <listitem>
  <para>
   Linux: <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   FreeBSD &gt;= 12 (PHP &gt;= 7.3): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   Windows (PHP &gt;= 7.2): <link xlink:href="&url.csprng.cng-api;">CNG-API</link>
  </para>
  <para>
   Windows: <link xlink:href="&url.csprng.crypt-gen-random;">CryptGenRandom</link>
  </para>
 </listitem>
 <listitem>
  <para>
   macOS (PHP &gt;= 8.2; &gt;= 8.1.9; &gt;= 8.0.22 se CCRandomGenerateBytes estiver disponível em tempo de compilação): CCRandomGenerateBytes()
  </para>
  <para>
   macOS (PHP &gt;= 8.1; &gt;= 8.0.2): arc4random_buf(), <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   NetBSD &gt;= 7 (PHP &gt;= 7.1; &gt;= 7.0.1): arc4random_buf(), <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   OpenBSD &gt;= 5.5 (PHP &gt;= 7.1; &gt;= 7.0.1): arc4random_buf(), <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   DragonflyBSD (PHP &gt;= 8.1): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   Solaris (PHP &gt;= 8.1): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <simpara>
   Qualquer combinação de sistema operacional e versão do PHP não mencionada anteriormente: <filename>/dev/urandom</filename>
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   Se nenhuma das fontes estiver disponível ou todas falharem em gerar
   aleatoriedade, então uma exceção <classname>Random\RandomException</classname>
   será lançada.
  </simpara>
 </listitem>
</itemizedlist>
'>
<!ENTITY csprng.errors '
 <listitem xmlns="http://docbook.org/ns/docbook">
  <simpara>
   Se uma fonte apropriada de aleatoriedade não puder ser encontrada,
   uma exceção <classname>Random\RandomException</classname> será lançada.
  </simpara>
 </listitem>
'>
<!ENTITY csprng.function.backport '
 <note xmlns="http://docbook.org/ns/docbook">
  <simpara>
   Embora esta função tenha sido adicionada ao PHP no PHP 7.0, uma
   <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.csprng.compat;">implementação no espaço do usuário</link>
   está disponível para o PHP 5.2 ao 5.6, inclusive.
  </simpara>
 </note>
'>

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

<!-- UOPZ snippets -->

<!ENTITY uopz.warn.removed.function-5-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Esta função foi
<emphasis>REMOVIDA</emphasis> na uopz 5.0.0 no PECL.</simpara></warning>'>

<!-- XML snippets -->
<!ENTITY xml.parser.param '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>parser</parameter></term>
 <listitem>
  <para>
   O analisador XML.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY xml.handler.description '<para xmlns="http://docbook.org/ns/docbook">
 Se &null; ou uma string vazia for passada, o manipulador será redefinido para seu estado padrão.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Se <parameter>handler</parameter> for um <type>callable</type>,
 o callable será definido como o manipulador.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Se <parameter>handler</parameter> for uma <type>string</type>,
 ela pode ser o nome de um método de um objet definido com
 <function>xml_set_object</function>.
</para>'>

<!ENTITY xml.handler.parser.param '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>parser</parameter></term>
 <listitem>
  <simpara>
   O analisador XML que chama o manipulador.
  </simpara>
 </listitem>
</varlistentry>'>

<!ENTITY xml.changelog.parser-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  O parâmetro <parameter>parser</parameter> agora espera uma instância de <classname>XMLParser</classname>;
  anteriormente, um <type>resource</type> <literal>xml</literal> válido era esperado.
 </entry>
</row>'>

<!-- Migration Guide snippets -->
<!ENTITY migration56.openssl.peer-verification '
   <para xmlns="http://docbook.org/ns/docbook">
    Todos os streams criptografados de cliente agora permitem a verificação de mesmo nível por padrão. Por
    padrão, será usada a coleção de CAs padrão do OpenSSL para verificar o certificado
    de mesmo nível. Na maioria dos casos, nenhuma alteração precisará ser feita para se comunicar
    com servidores com certificados SSL válidos, pois as distribuições geralmente
    configuram o OpenSSL com coleções de CAs bem conhecidos.
   </para>

   <para xmlns="http://docbook.org/ns/docbook">
    A coleção de CAs padrão pode ser substituída globalmente definindo
    a configuração openssl.cafile ou openssl.capath, ou
    por requisição usando as opções de contexto
    <link linkend="context.ssl.cafile"><parameter>cafile</parameter></link> ou
    <link linkend="context.ssl.capath"><parameter>capath</parameter></link>.
   </para>

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

<!-- 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
-->