svn: /phpdoc/pt_BR/trunk/reference/filter/ filters.xml

Added: phpdoc/pt_BR/trunk/reference/filter/filters.xml
===================================================================
--- phpdoc/pt_BR/trunk/reference/filter/filters.xml	                        (rev 0)
+++ phpdoc/pt_BR/trunk/reference/filter/filters.xml	2019-07-18 14:23:45 UTC (rev 347763)
@@ -0,0 +1,793 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 346911 Maintainer: none Status: ready --><!-- CREDITS: @everaldofilho -->
+<chapter xml:id="filter.filters" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <title>Tipos de filtros</title>
+
+ <!--Validate filters: {{{-->
+ <section xml:id="filter.filters.validate">
+  <title>Filtros de validação</title>
+   <para>
+    <table>
+     <title>Listagem de filtros para validação</title>
+     <tgroup cols="5">
+      <thead>
+       <row>
+        <entry>ID</entry>
+        <entry>Nome</entry>
+        <entry>Opções</entry>
+        <entry>Flags</entry>
+        <entry>Descrição</entry>
+       </row>
+      </thead>
+      <tbody>
+       <row>
+        <entry><constant>FILTER_VALIDATE_BOOLEAN</constant></entry>
+        <entry>"boolean"</entry>
+        <entry>
+         <parameter>default</parameter>
+        </entry>
+        <entry>
+          <constant>FILTER_NULL_ON_FAILURE</constant>
+        </entry>
+        <entry>
+         <para>
+          Retorna &true; para "1", "true", "on" e "yes".
+          Retorna &false; caso contrário.
+         </para>
+         <para>
+          Se <constant>FILTER_NULL_ON_FAILURE</constant> está definido, &false; é
+          retornado apenas para "0", "false", "off", "no", e "", e
+          &null; é retornado para todos os valores não booleanos.
+         </para>
+        </entry>
+       </row>
+       <row>
+        <entry><constant>FILTER_VALIDATE_DOMAIN</constant></entry>
+        <entry>"validate_domain"</entry>
+        <entry>
+         <parameter>default</parameter>
+        </entry>
+        <entry>
+         <constant>FILTER_FLAG_HOSTNAME</constant>
+        </entry>
+        <entry>
+         <para>
+          Valida se os comprimentos do nome de domínio são validos
+         </para>
+         <para>
+          Valida nomes de domínio contra RFC 1034, RFC 1035, RFC 952,
+          RFC 1123, RFC 2732, RFC 2181, and RFC 1123. Flag opcional
+          <constant>FILTER_FLAG_HOSTNAME</constant> adiciona capacidade de
+          validar especificamente nomes de host (eles devem começar com um
+          caractere alfanumérico e conter apenas alfanuméricos ou
+          hifens).
+         </para>
+        </entry>
+       </row>
+       <row>
+        <entry><constant>FILTER_VALIDATE_EMAIL</constant></entry>
+        <entry>"validate_email"</entry>
+        <entry>
+         <parameter>default</parameter>
+        </entry>
+        <entry>
+         <constant>FILTER_FLAG_EMAIL_UNICODE</constant>
+        </entry>
+        <entry>
+         <para>
+          Valida se o valor é um endereço de e-mail válido.
+         </para>
+         <para>
+          Em geral, isso valida os endereços de e-mail com relação à sintaxe
+          RFC 822, com as exceções que comentários e espaço em branco dobrável
+          e nomes de domínio sem ponto
+          não são suportados.
+         </para>
+        </entry>
+       </row>
+       <row>
+        <entry><constant>FILTER_VALIDATE_FLOAT</constant></entry>
+        <entry>"float"</entry>
+        <entry>
+         <parameter>default</parameter>,
+         <parameter>decimal</parameter>
+        </entry>
+        <entry>
+         <constant>FILTER_FLAG_ALLOW_THOUSAND</constant>
+        </entry>
+        <entry>Valida valor como float, e converte para float em caso de sucesso.</entry>
+       </row>
+       <row>
+        <entry><constant>FILTER_VALIDATE_INT</constant></entry>
+        <entry>"int"</entry>
+        <entry>
+         <parameter>default</parameter>,
+         <parameter>min_range</parameter>,
+         <parameter>max_range</parameter>
+        </entry>
+        <entry>
+         <constant>FILTER_FLAG_ALLOW_OCTAL</constant>,
+         <constant>FILTER_FLAG_ALLOW_HEX</constant>
+        </entry>
+        <entry>Valida o valor como inteiro, opcionalmente do intervalo especificado e converte em int em caso de sucesso.</entry>
+       </row>
+       <row>
+        <entry><constant>FILTER_VALIDATE_IP</constant></entry>
+        <entry>"validate_ip"</entry>
+        <entry>
+         <parameter>default</parameter>
+        </entry>
+        <entry>
+         <constant>FILTER_FLAG_IPV4</constant>,
+         <constant>FILTER_FLAG_IPV6</constant>,
+         <constant>FILTER_FLAG_NO_PRIV_RANGE</constant>,
+         <constant>FILTER_FLAG_NO_RES_RANGE</constant>
+        </entry>
+        <entry>
+         Valida o valor como endereço IP, opcionalmente apenas IPv4 ou IPv6 ou não
+         de intervalos privados ou reservados.
+        </entry>
+       </row>
+       <row>
+        <entry><constant>FILTER_VALIDATE_MAC</constant></entry>
+        <entry>"validate_mac_address"</entry>
+        <entry>
+         <parameter>default</parameter>
+        </entry>
+        <entry></entry>
+        <entry>Valida o valor como endereço MAC.</entry>
+       </row>
+       <row>
+        <entry><constant>FILTER_VALIDATE_REGEXP</constant></entry>
+        <entry>"validate_regexp"</entry>
+        <entry>
+         <parameter>default</parameter>,
+         <parameter>regexp</parameter>
+        </entry>
+        <entry></entry>
+        <entry>
+         Valida o valor contra <parameter>regexp</parameter>, um
+         <link linkend="book.pcre">Perl-compatible</link> expressão regular.
+        </entry>
+       </row>
+       <row>
+        <entry><constant>FILTER_VALIDATE_URL</constant></entry>
+        <entry>"validate_url"</entry>
+        <entry>
+         <parameter>default</parameter>
+        </entry>
+        <entry>
+         <constant>FILTER_FLAG_SCHEME_REQUIRED</constant>,
+         <constant>FILTER_FLAG_HOST_REQUIRED</constant>,
+         <constant>FILTER_FLAG_PATH_REQUIRED</constant>,
+         <constant>FILTER_FLAG_QUERY_REQUIRED</constant>
+        </entry>
+        <entry>Valida o valor como URL (de acordo com <link xlink:href="&url.rfc;2396">&url.rfc;2396</link>), opcionalmente com componentes requeridos. Cuidado, uma URL válido pode não especificar o protocolo HTTP <literal>http://</literal> Assim, a validação adicional pode ser necessária para determinar a URL utiliza um protocolo esperado, e.g. <literal>ssh://</literal> ou <literal>mailto:</literal>. Note que a função só encontrará URLs ASCII válidas; nomes de domínio internacionalizados (contendo caracteres não ASCII) vai falhar.</entry>
+       </row>
+      </tbody>
+     </tgroup>
+    </table>
+   </para>
+   <note>
+    <para>
+     A partir do PHP 5.4.11, os números +0 e -0 são validados tanto como inteiros quanto
+     como floats (usando <constant>FILTER_VALIDATE_FLOAT</constant> e
+     <constant>FILTER_VALIDATE_INT</constant>).Antes do PHP 5.4.11 eles só
+      validado como floats (usando <constant>FILTER_VALIDATE_FLOAT</constant>).
+    </para>
+    <para>
+     Quando <parameter>default</parameter> está definido para a opção, <parameter>default</parameter> é usado se o valor não for validado.
+    </para>
+   </note>
+
+  <simplesect role="changelog">
+   &reftitle.changelog;
+   <para>
+    <informaltable>
+     <tgroup cols="2">
+      <thead>
+       <row>
+        <entry>&Version;</entry>
+        <entry>&Description;</entry>
+       </row>
+      </thead>
+      <tbody>
+       <row>
+        <entry>7.0.0</entry>
+        <entry>
+         Adicionado <constant>FILTER_FLAG_HOSTNAME</constant>
+        </entry>
+       </row>
+       <row>
+        <entry>5.5.0</entry>
+        <entry>
+         Adicionado <constant>FILTER_VALIDATE_MAC</constant>
+        </entry>
+       </row>
+       <row>
+        <entry>5.2.1</entry>
+        <entry>
+         <constant>FILTER_VALIDATE_URL</constant> agora implicitamente usa
+         <constant>FILTER_FLAG_SCHEME_REQUIRED</constant> e
+         <constant>FILTER_FLAG_HOST_REQUIRED</constant>.
+        </entry>
+       </row>
+      </tbody>
+     </tgroup>
+    </informaltable>
+   </para>
+  </simplesect>
+
+ </section>
+ <!--}}}-->
+
+ <!-- Sanitize filters: {{{-->
+ <section xml:id="filter.filters.sanitize">
+  <title>Filtros de Sanitize (Limpeza)</title>
+   <para>
+    <table>
+     <title>Lista de filtros para sanitização (Limpeza)</title>
+     <tgroup cols="5">
+      <thead>
+       <row>
+        <entry>ID</entry>
+        <entry>Nome</entry>
+        <entry>Flags</entry>
+        <entry>Descrição</entry>
+       </row>
+      </thead>
+      <tbody>
+       <row>
+        <entry><constant>FILTER_SANITIZE_EMAIL</constant></entry>
+        <entry>"email"</entry>
+        <entry></entry>
+        <entry>
+          Remova todos os caracteres, exceto letras, dígitos e
+         <literal>!#$%&amp;'*+-=?^_`{|}~@.[]</literal>.
+        </entry>
+       </row>
+       <row>
+        <entry><constant>FILTER_SANITIZE_ENCODED</constant></entry>
+        <entry>"encoded"</entry>
+        <entry>
+         <constant>FILTER_FLAG_STRIP_LOW</constant>,
+         <constant>FILTER_FLAG_STRIP_HIGH</constant>,
+         <constant>FILTER_FLAG_STRIP_BACKTICK</constant>,
+         <constant>FILTER_FLAG_ENCODE_LOW</constant>,
+         <constant>FILTER_FLAG_ENCODE_HIGH</constant>
+        </entry>
+        <entry>URL-encode string, opcionalmente tira ou codifica caracteres especiais.</entry>
+       </row>
+       <row>
+        <entry><constant>FILTER_SANITIZE_MAGIC_QUOTES</constant></entry>
+        <entry>"magic_quotes"</entry>
+        <entry></entry>
+        <entry>Aplique <function>addslashes</function>.</entry>
+       </row>
+       <row>
+        <entry><constant>FILTER_SANITIZE_NUMBER_FLOAT</constant></entry>
+        <entry>"number_float"</entry>
+        <entry>
+         <constant>FILTER_FLAG_ALLOW_FRACTION</constant>,
+         <constant>FILTER_FLAG_ALLOW_THOUSAND</constant>,
+         <constant>FILTER_FLAG_ALLOW_SCIENTIFIC</constant>
+        </entry>
+        <entry>
+         Remove todos os caracteres, exceto dígitos, <literal>+-</literal> e
+         opcionalmente <literal>.,eE</literal>.
+        </entry>
+       </row>
+       <row>
+        <entry><constant>FILTER_SANITIZE_NUMBER_INT</constant></entry>
+        <entry>"number_int"</entry>
+        <entry></entry>
+        <entry>
+         Remove todos os caracteres, exceto os dígitos, sinal de mais e menos.
+        </entry>
+       </row>
+       <row>
+        <entry><constant>FILTER_SANITIZE_SPECIAL_CHARS</constant></entry>
+        <entry>"special_chars"</entry>
+        <entry>
+         <constant>FILTER_FLAG_STRIP_LOW</constant>,
+         <constant>FILTER_FLAG_STRIP_HIGH</constant>,
+         <constant>FILTER_FLAG_STRIP_BACKTICK</constant>,
+         <constant>FILTER_FLAG_ENCODE_HIGH</constant>
+        </entry>
+        <entry>
+         HTML-escape <literal>'"&lt;&gt;&amp;</literal> e caracteres com
+         valor ASCII menor que 32, opcionalmente, tira ou codifica outros
+         caracteres especiais.
+        </entry>
+       </row>
+       <row>
+        <entry><constant>FILTER_SANITIZE_FULL_SPECIAL_CHARS</constant></entry>
+        <entry>"full_special_chars"</entry>
+        <entry>
+         <constant>FILTER_FLAG_NO_ENCODE_QUOTES</constant>,
+        </entry>
+        <entry>
+         Equivalente a chamar <function>htmlspecialchars</function> junto com <constant>ENT_QUOTES</constant>. Citações de codificação podem
+         ser desabilitadas <constant>FILTER_FLAG_NO_ENCODE_QUOTES</constant>. Como <function>htmlspecialchars</function>, este
+         filtro está ciente do <link linkend="ini.default-charset">default_charset</link> e se uma sequência de bytes for detectada
+         cria um caractere inválido no conjunto de caracteres atual e, em seguida, a cadeia inteira é rejeitada, resultando em uma cadeia de caracteres de comprimento igual a 0
+         Ao usar esse filtro como um filtro padrão, consulte o aviso abaixo sobre como definir os sinalizadores padrão como 0
+        </entry>
+       </row>
+       <row>
+        <entry><constant>FILTER_SANITIZE_STRING</constant></entry>
+        <entry>"string"</entry>
+        <entry>
+         <constant>FILTER_FLAG_NO_ENCODE_QUOTES</constant>,
+         <constant>FILTER_FLAG_STRIP_LOW</constant>,
+         <constant>FILTER_FLAG_STRIP_HIGH</constant>,
+         <constant>FILTER_FLAG_STRIP_BACKTICK</constant>,
+         <constant>FILTER_FLAG_ENCODE_LOW</constant>,
+         <constant>FILTER_FLAG_ENCODE_HIGH</constant>,
+         <constant>FILTER_FLAG_ENCODE_AMP</constant>
+        </entry>
+        <entry>Retira tags, opcionalmente, tira ou codifica caracteres especiais.</entry>
+       </row>
+       <row>
+        <entry><constant>FILTER_SANITIZE_STRIPPED</constant></entry>
+        <entry>"stripped"</entry>
+        <entry></entry>
+        <entry>Alias do filtro "string".</entry>
+       </row>
+       <row>
+        <entry><constant>FILTER_SANITIZE_URL</constant></entry>
+        <entry>"url"</entry>
+        <entry></entry>
+        <entry>
+         Remove todos os caracteres, exceto letras, dígitos e
+         <literal>$-_.+!*'(),{}|\\^~[]`&lt;&gt;#%";/?:@&amp;=</literal>.
+        </entry>
+       </row>
+       <row>
+        <entry><constant>FILTER_UNSAFE_RAW</constant></entry>
+        <entry>"unsafe_raw"</entry>
+        <entry>
+         <constant>FILTER_FLAG_STRIP_LOW</constant>,
+         <constant>FILTER_FLAG_STRIP_HIGH</constant>,
+         <constant>FILTER_FLAG_STRIP_BACKTICK</constant>,
+         <constant>FILTER_FLAG_ENCODE_LOW</constant>,
+         <constant>FILTER_FLAG_ENCODE_HIGH</constant>,
+         <constant>FILTER_FLAG_ENCODE_AMP</constant>
+        </entry>
+        <entry>
+         Não faz nada, opcionalmente descasque ou codifique caracteres especiais. este
+         filtro também é alias do <constant>FILTER_DEFAULT</constant>.
+        </entry>
+       </row>
+      </tbody>
+     </tgroup>
+    </table>
+   </para>
+   <warning>
+     <para>
+       Ao usar um desses filtros como um filtro padrão através do seu arquivo ini
+       ou através da configuração do seu servidor web, os sinalizadores padrão são definidos para
+       <constant>FILTER_FLAG_NO_ENCODE_QUOTES</constant>.  Você precisa definir explicitamente
+       filter.default_flags para 0 ter aspas codificadas por padrão. Assim:
+       <example>
+         <title>Configurando o filtro padrão para agir como htmlspecialchars</title>
+         <programlisting role="php">
+<![CDATA[
+filter.default = full_special_chars
+filter.default_flags = 0
+]]>
+         </programlisting>
+       </example>
+     </para>
+   </warning>
+
+  <simplesect role="changelog">
+   &reftitle.changelog;
+   <para>
+    <informaltable>
+     <tgroup cols="2">
+      <thead>
+       <row>
+        <entry>&Version;</entry>
+        <entry>&Description;</entry>
+       </row>
+      </thead>
+      <tbody>
+       <row>
+        <entry>5.2.11/5.3.1</entry>
+        <entry>
+         Barras (<literal>/</literal>) são removidos por
+         <constant>FILTER_SANITIZE_EMAIL</constant>. Antes eles eram mantidos.
+        </entry>
+       </row>
+      </tbody>
+     </tgroup>
+    </informaltable>
+   </para>
+  </simplesect>
+
+ </section>
+ <!--}}}-->
+
+ <!-- Other filters: {{{-->
+ <section xml:id="filter.filters.misc">
+  <title>Outros filtros</title>
+   <para>
+    <table>
+     <title>Lista de filtros diversos</title>
+     <tgroup cols="5">
+      <thead>
+       <row>
+        <entry>ID</entry>
+        <entry>Nome</entry>
+        <entry>Opções</entry>
+        <entry>Flags</entry>
+        <entry>Descrição</entry>
+       </row>
+      </thead>
+      <tbody>
+       <row>
+        <entry><constant>FILTER_CALLBACK</constant></entry>
+        <entry>"callback"</entry>
+        <entry><type>callable</type> função ou método</entry>
+        <entry>Todas as flags são ignoradas</entry>
+        <entry>Chama a função definida pelo usuário para filtrar os dados.</entry>
+       </row>
+      </tbody>
+     </tgroup>
+    </table>
+   </para>
+ </section>
+ <!--}}}-->
+
+ <!-- Filter flags: {{{-->
+ <section xml:id="filter.filters.flags">
+  <title>Filtro flags</title>
+
+  <para>
+   <table>
+    <title>Lista de sinalizadores de filtro</title>
+    <tgroup cols="3">
+     <thead>
+      <row>
+       <entry>ID</entry>
+       <entry>Usado com</entry>
+       <entry>Descrição</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry><constant>FILTER_FLAG_STRIP_LOW</constant></entry>
+       <entry>
+        <constant>FILTER_SANITIZE_ENCODED</constant>,
+        <constant>FILTER_SANITIZE_SPECIAL_CHARS</constant>,
+        <constant>FILTER_SANITIZE_STRING</constant>,
+        <constant>FILTER_UNSAFE_RAW</constant>
+       </entry>
+       <entry>
+        Retira caracteres que têm um valor numérico &lt;32.
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_FLAG_STRIP_HIGH</constant></entry>
+       <entry>
+        <constant>FILTER_SANITIZE_ENCODED</constant>,
+        <constant>FILTER_SANITIZE_SPECIAL_CHARS</constant>,
+        <constant>FILTER_SANITIZE_STRING</constant>,
+        <constant>FILTER_UNSAFE_RAW</constant>
+       </entry>
+       <entry>
+        Retira caracteres que têm um valor numérico &gt;127.
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_FLAG_STRIP_BACKTICK</constant></entry>
+       <entry>
+        <constant>FILTER_SANITIZE_ENCODED</constant>,
+        <constant>FILTER_SANITIZE_SPECIAL_CHARS</constant>,
+        <constant>FILTER_SANITIZE_STRING</constant>,
+        <constant>FILTER_UNSAFE_RAW</constant>
+       </entry>
+       <entry>
+        Retira crase dos caracteres.
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_FLAG_ALLOW_FRACTION</constant></entry>
+       <entry>
+        <constant>FILTER_SANITIZE_NUMBER_FLOAT</constant>
+       </entry>
+       <entry>
+        Permite um ponto (<literal>.</literal>) como um separador fracionário em
+        números.
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_FLAG_ALLOW_THOUSAND</constant></entry>
+       <entry>
+        <constant>FILTER_SANITIZE_NUMBER_FLOAT</constant>,
+        <constant>FILTER_VALIDATE_FLOAT</constant>
+       </entry>
+       <entry>
+        Permite uma vírgula (<literal>,</literal>) como um separador de milhares em
+        números.
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_FLAG_ALLOW_SCIENTIFIC</constant></entry>
+       <entry>
+        <constant>FILTER_SANITIZE_NUMBER_FLOAT</constant>
+       </entry>
+       <entry>
+        Permite um <literal>e</literal> ou <literal>E</literal> para fins científicos
+        notação em números.
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_FLAG_NO_ENCODE_QUOTES</constant></entry>
+       <entry>
+        <constant>FILTER_SANITIZE_STRING</constant>
+       </entry>
+       <entry>
+        Se este flag estiver presente, Aspas simples (<literal>'</literal>) e duplas
+        (<literal>"</literal>) duplas não serão codificadas.
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_FLAG_ENCODE_LOW</constant></entry>
+       <entry>
+        <constant>FILTER_SANITIZE_ENCODED</constant>,
+        <constant>FILTER_SANITIZE_STRING</constant>,
+        <constant>FILTER_SANITIZE_RAW</constant>
+       </entry>
+       <entry>
+        Codifica todos os caracteres com um valor numérico &lt;32.
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_FLAG_ENCODE_HIGH</constant></entry>
+       <entry>
+        <constant>FILTER_SANITIZE_ENCODED</constant>,
+        <constant>FILTER_SANITIZE_SPECIAL_CHARS</constant>,
+        <constant>FILTER_SANITIZE_STRING</constant>,
+        <constant>FILTER_SANITIZE_RAW</constant>
+       </entry>
+       <entry>
+        Codifica todos os caracteres com um valor numérico &gt;127.
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_FLAG_ENCODE_AMP</constant></entry>
+       <entry>
+        <constant>FILTER_SANITIZE_STRING</constant>,
+        <constant>FILTER_SANITIZE_RAW</constant>
+       </entry>
+       <entry>
+        Codifica e comercial (<literal>&amp;</literal>).
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_NULL_ON_FAILURE</constant></entry>
+       <entry>
+        <constant>FILTER_VALIDATE_BOOLEAN</constant>
+       </entry>
+       <entry>
+        Retorna &null; para valores booleanos não reconhecidos.
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_FLAG_ALLOW_OCTAL</constant></entry>
+       <entry>
+        <constant>FILTER_VALIDATE_INT</constant>
+       </entry>
+       <entry>
+        Considera entradas começando com zero (<literal>0</literal>) como
+        números octal. Isso só permite que os dígitos seguintes sejam
+        <literal>0-7</literal>.
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_FLAG_ALLOW_HEX</constant></entry>
+       <entry>
+        <constant>FILTER_VALIDATE_INT</constant>
+       </entry>
+       <entry>
+        Atenciosamente entradas começando com <literal>0x</literal> ou
+        <literal>0X</literal> como números hexadecimais. Isso só permite
+        que os caracteres seguintes sejam <literal>a-fA-F0-9</literal>.
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_FLAG_EMAIL_UNICODE</constant></entry>
+       <entry>
+        <constant>FILTER_VALIDATE_EMAIL</constant>
+       </entry>
+       <entry>
+        Permite que a parte local do endereço de e-mail contenha caracteres Unicode.
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_FLAG_IPV4</constant></entry>
+       <entry>
+        <constant>FILTER_VALIDATE_IP</constant>
+       </entry>
+       <entry>
+        Permite que o endereço IP esteja no formato IPv4.
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_FLAG_IPV6</constant></entry>
+       <entry>
+        <constant>FILTER_VALIDATE_IP</constant>
+       </entry>
+       <entry>
+        Permite que o endereço IP esteja no formato IPv6.
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_FLAG_NO_PRIV_RANGE</constant></entry>
+       <entry>
+        <constant>FILTER_VALIDATE_IP</constant>
+       </entry>
+       <entry>
+        <para>
+         Falha na validação para os seguintes intervalos de IPv4 privados:
+         <literal>10.0.0.0/8</literal>, <literal>172.16.0.0/12</literal> e
+         <literal>192.168.0.0/16</literal>.
+        </para>
+        <para>
+         Falha na validação dos endereços IPv6 que começam com
+         <literal>FD</literal> ou <literal>FC</literal>.
+        </para>
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_FLAG_NO_RES_RANGE</constant></entry>
+       <entry>
+        <constant>FILTER_VALIDATE_IP</constant>
+       </entry>
+       <entry>
+        <para>
+         Falha na validação para os seguintes intervalos de IPv4 reservados:
+        <literal>0.0.0.0/8</literal>, <literal>169.254.0.0/16</literal>,
+        <literal>127.0.0.0/8</literal> e <literal>240.0.0.0/4</literal>.
+        </para>
+        <para>
+         Falha na validação para os seguintes intervalos reservados de IPv6:
+         <literal>::1/128</literal>, <literal>::/128</literal>,
+         <literal>::ffff:0:0/96</literal> e <literal>fe80::/10</literal>.
+        </para>
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_FLAG_SCHEME_REQUIRED</constant></entry>
+       <entry>
+        <constant>FILTER_VALIDATE_URL</constant>
+       </entry>
+       <entry>
+        Requer que a <acronym>URL</acronym> contenha uma parte do esquema.
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_FLAG_HOST_REQUIRED</constant></entry>
+       <entry>
+        <constant>FILTER_VALIDATE_URL</constant>
+       </entry>
+       <entry>
+        Requer que a <acronym>URL</acronym> contenha uma parte do host.
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_FLAG_PATH_REQUIRED</constant></entry>
+       <entry>
+        <constant>FILTER_VALIDATE_URL</constant>
+       </entry>
+       <entry>
+        Requer que o <acronym>URL</acronym> contenha uma parte do caminho.
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_FLAG_QUERY_REQUIRED</constant></entry>
+       <entry>
+        <constant>FILTER_VALIDATE_URL</constant>
+       </entry>
+       <entry>
+        Requer que o <acronym>URL</acronym> contenha uma string de consulta.
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_REQUIRE_SCALAR</constant></entry>
+       <entry>
+       </entry>
+       <entry>
+        Requer que o valor seja scalar.
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_REQUIRE_ARRAY</constant></entry>
+       <entry>
+       </entry>
+       <entry>
+        Requer que o valor seja uma array.
+       </entry>
+      </row>
+      <row>
+       <entry><constant>FILTER_FORCE_ARRAY</constant></entry>
+       <entry>
+       </entry>
+       <entry>
+        Se o valor é um scalar, é tratado como array com o valor scalar
+        como único elemento.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </table>
+  </para>
+
+  <simplesect role="changelog">
+   &reftitle.changelog;
+   <para>
+    <informaltable>
+     <tgroup cols="2">
+      <thead>
+       <row>
+        <entry>&Version;</entry>
+        <entry>&Description;</entry>
+       </row>
+      </thead>
+      <tbody>
+       <row>
+        <entry>7.3.0</entry>
+        <entry>
+         O uso explícito de <constant>FILTER_FLAG_SCHEME_REQUIRED</constant>
+         e <constant>FILTER_FLAG_HOST_REQUIRED</constant> tornou-se obsoleta.
+        </entry>
+       </row>
+       <row>
+        <entry>7.1.0</entry>
+        <entry>
+         <constant>FILTER_FLAG_EMAIL_UNICODE</constant> foi adicionado.
+        </entry>
+       </row>
+       <row>
+        <entry>5.3.2</entry>
+        <entry>
+         <constant>FILTER_FLAG_STRIP_BACKTICK</constant> foi adicionado.
+        </entry>
+       </row>
+       <row>
+        <entry>5.2.10</entry>
+        <entry>
+         <constant>FILTER_FLAG_NO_RES_RANGE</constant> suporta também endereços IPv6.
+        </entry>
+       </row>
+      </tbody>
+     </tgroup>
+    </informaltable>
+   </para>
+  </simplesect>
+ </section>
+ <!--}}}-->
+</chapter>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=marker fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->