language-snippets.ent

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

<!ENTITY installation.enabled.disable 'Esta extensão está habilitada por padrão. Ela pode ser desabilitada usando a seguinte opção 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 motor <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), apesar do gigantesco período de 2<superscript>19937</superscript>-1 do Mt19937.
 </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 motores
  <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 motor <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 é
binary-safe.</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 familia de funções
func_*() devem 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 apropriadamente
os finais de linha ao ler arquivos em um computador Macintosh ou que foram criados
em um, habilitar a opção de configuração de 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 a partir 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 no <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 na plataforma Windows.</simpara></note>'>

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

<!ENTITY note.no-zts '<note xmlns="http://docbook.org/ns/docbook"><simpara>Esta função não está
disponível em interpretadores PHP compilados com 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 verifique 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. Isto 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 dentro de um
callback da função <function>ob_start</function>.</para></note>'>

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

<!ENTITY note.filesystem-time-res '<note xmlns="http://docbook.org/ns/docbook"><para>Note que a resolução de tempo pode 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ó estarão acessíveis e serão gerados 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 de retorno desta 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 <xref linkend="wrappers"/> 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
<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>Consulte 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 sobre esta
extensão, poderá 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
é altamente desaconselhado.</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
é altamente desaconselhado.</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
é altamente desaconselhado.</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
é altamente desaconselhado.</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
é altamente desaconselhado.</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
é altamente desaconselhado.</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.1.0 e foi <emphasis>REMOVIDO</emphasis> a partir do PHP 8.0.0. O uso deste recurso
é altamente desaconselhado.</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.1.0 e foi <emphasis>REMOVIDA</emphasis> a partir do PHP 8.0.0. O uso desta função
é altamente desaconselhado.</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
é altamente desaconselhado.</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
é altamente desaconselhado.</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
é altamente desaconselhado.</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
é altamente desaconselhado.</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
é altamente desaconselhado.</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
é altamente desaconselhado.</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 é altamente desaconselhado.</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. Por favor, leia nossa
<link xmlns="http://docbook.org/ns/docbook" 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 inclui avisos.
O PHP pode detectar servidores IIS defeituosos quando o stream
é aberto usando o wrapper <literal>https://</literal> e suprimirá os avisos.
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
 <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
é altamente desaconselhado.</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 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 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 descrito
<link xmlns="http://docbook.org/ns/docbook" 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,
consulte 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 'Consulte 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
interpretado 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.
  Use <function>get_mangled_object_vars</function> no &object; primeiro ou use <classname>ArrayIterator</classname>.
 </entry>
</row>
'>

<!ENTITY standard.changelog.binary-safe-string-comparison '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.2.0</entry>
 <entry>
  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 os <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 os <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ó está 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 imagens,
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ça 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 à 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 utiliza
       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>
        Observe 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 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 de retorno 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">
    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">
    Constante de estilo usada pela função <function>imagefilledarc</function>.
</simpara>'>

<!ENTITY gd.constants.gd2 '<simpara xmlns="http://docbook.org/ns/docbook">
    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 libgd. Eles precisam 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 para strings.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      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 para <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 começar a pesquisar na hierarquia
da caixa de entrada.</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 entrada. Se
<parameter>pattern</parameter> for passado como &apos;<literal>*</literal>&apos;, será retornada
uma lista de toda a hierarquia da caixa de entrada.
&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 entrada do nível
mais alto; Passar &apos;<literal>~/mail/&#37;</literal>&apos; em <literal>UW_IMAPD</literal> retornará todas as caixas de entrada 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, neste caso 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.
  Consulte também os <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; de <literal>conexão LDAP</literal> válida 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; de <literal>entrada de resultado do LDAP</literal> válida 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; de <literal>resultado do LDAP</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 de retorno 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_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_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 para 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 para a última operação de exclusão executada, ou seja, a operação
   de exclusão para o ú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">Por favor, 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 de 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. Consulte 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.allowstatic '<para xmlns="http://docbook.org/ns/docbook">Antes do PHP 8.0.0, este método
<emphasis>poderia</emphasis> ser chamado estaticamente, mas emitiria um erro <constant>E_DEPRECATED</constant>.
A partir do PHP 8.0.0, chamar este método estaticamente lança uma exceção <classname>Error</classname></para>'>
<!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 encontra 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á o da 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>'>


<!-- 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 de arquivo
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 de string <literal>"true"</literal>, <literal>"on"</literal> e <literal>"yes"</literal>
    são convertidos para &true;. <literal>"false"</literal>, <literal>"off"</literal>, <literal>"no"</literal>
    e <literal>"none"</literal> são considerados &false;. <literal>"null"</literal> é convertido para &null;
    no modo tipado. Além disso, todas as strings numéricas são convertidas para 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>[//]host_name[:port][/service_name]</emphasis>. Do Oracle
11<emphasis>g</emphasis> a sintaxe é:
<emphasis>[//]host_name[:port][/service_name][:server_type][/instance_name]</emphasis>.
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 especificados, 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
extençã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 está disponível quando o PHP é 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 está 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 para 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">Não há necessidade de instalação 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 <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 em vários drivers.</simpara>'>

<!ENTITY pdo.errors.exception-not-errmode '<note xmlns="http://docbook.org/ns/docbook"><simpara>Uma exceção é lançada mesmo quando o atributo <constant>PDO::ATTR_ERRMODE</constant> não é <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 xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl;">PECL</link>
não é distribuída junto com o PHP.'>

<!ENTITY pecl.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 não mantida 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 não mantida 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. Consulte também a seção
<link xmlns="http://docbook.org/ns/docbook" linkend="install.windows.building">Compilando no Windows</link>.
'>

<!ENTITY pecl.moved-ver 'Esta extensão foi movida para o repositório
<link xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.pecl;">PECL</link> e não é mais 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 <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 <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 retornará para <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 pretendido, o argumento deve ser convertido para &string;
ou uma chamada explícita para <function>chr</function> deve ser feita.</para></warning>'>

<!ENTITY ctype.result.empty-string '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.</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 (principalmente) úteis 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>Nomes de campos nesta 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 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, a extensão <link linkend="book.mysqli">MySQLi</link> ou <link linkend="ref.pdo-mysql">PDO_MySQL</link> deve ser usada.
Consulte 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 dsempenho. Para obter informações relacionadas, consulte
<link linkend="language.types.resource.self-destruct">liberação de recursos</link>.</para>'>

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

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

<!-- 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 recomendados utilizar o
threaded MPM em produção com o Apache 2. Utilize o prefork MPM, que é
MPM padrão no Apache 2.0 e 2.2.
Para mais informações veja o FAQ relacionado sobre o uso de
<link linkend="faq.installation.apache2">Apache2 com threaded MPM</link></para></warning>'>

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

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

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

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

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

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

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

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

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

<!ENTITY listendand ' e'>

<!-- classkit and runkit entities -->

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

<!ENTITY mongodb.parameter.namespace '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>namespace</parameter> (<type>string</type>)</term>
    <listitem>
     <para>
      Um namespace completo (por exemplo <literal>"databaseName.collectionName"</literal>).
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.db '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>db</parameter> (<type>string</type>)</term>
    <listitem>
     <para>
      O nome do banco a executar o comando.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.bulkwrite '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>bulk</parameter> (<type>MongoDB\Driver\BulkWrite</type>)</term>
    <listitem>
     <para>
      O <classname>MongoDB\Driver\BulkWrite</classname> a executar.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.command '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>command</parameter> (<type>MongoDB\Driver\Command</type>)</term>
    <listitem>
     <para>
      O <classname>MongoDB\Driver\Command</classname> a executar.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.query '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>query</parameter> (<type>MongoDB\Driver\Query</type>)</term>
    <listitem>
     <para>
      A <classname>MongoDB\Driver\Query</classname> a executar.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.typeMap '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>typeMap</parameter> (<type>array</type>)</term>
    <listitem>
     <para>
      <link linkend="mongodb.persistence.typemaps">O mapeamento de tipos (Type)</link>.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.filter '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>filter</parameter> (<type>array|object</type>)</term>
    <listitem>
     <para>
      O filtro de busca.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.returns.cursor '<para xmlns="http://docbook.org/ns/docbook">Retorna <classname>MongoDB\Driver\Cursor</classname> no sucesso.</para>'>
<!ENTITY mongodb.returns.writeresult '<para xmlns="http://docbook.org/ns/docbook">Retorna <classname>MongoDB\Driver\WriteResult</classname> no sucesso.</para>'>
<!ENTITY mongodb.throws.std '&mongodb.throws.argumentparsing;&mongodb.throws.connection;&mongodb.throws.authentication;'>
<!ENTITY mongodb.throws.bulkwriteexception '<member xmlns="http://docbook.org/ns/docbook">Lança <classname>MongoDB\Driver\Exception\BulkWriteException</classname> em qualquer erro de escrita (erro de escrita, falha ao aplicar um write concern)</member>'>
<!ENTITY mongodb.throws.argumentparsing '<member xmlns="http://docbook.org/ns/docbook">Lança <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname> no caso de erros ao interpretar parâmetros.</member>'>
<!ENTITY mongodb.throws.authentication '<member xmlns="http://docbook.org/ns/docbook">Lança <classname>MongoDB\Driver\Exception\AuthenticationException</classname> se a autenticação é necessária e falha.</member>'>
<!ENTITY mongodb.throws.connection '<member xmlns="http://docbook.org/ns/docbook">Lança <classname>MongoDB\Driver\Exception\ConnectionException</classname> se a conexão com o servidor falhar (por razões outras que autenticação).</member>'>
<!ENTITY mongodb.option.let '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>let</entry>
          <entry><type class="union"><type>array</type><type>object</type></type></entry>
          <entry>
           <para>
            Mapa de nomes e valores de parâmetros. Os valores devem ser expressões constantes ou fechadas que não fazem referência a campos do documento. Os parâmetros podem então ser acessados como variáveis em um contexto de expressão agregada (e.g. <literal>$$var</literal>).
           </para>
           <para>
            Esta opção está disponível no MongoDB 5.0+ e resultará em uma exceção no tempo de execução se for especificada para uma versão de servidor mais antiga.
           </para>
          </entry>
         </row>
'>

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

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

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