mirror of
https://github.com/php/doc-pt_br.git
synced 2026-04-27 18:23:11 +02:00
leonardolara
80 lines
2.9 KiB
XML
80 lines
2.9 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!-- EN-Revision: 53054bf8decc8648cf2e90a493692a161e2371af Maintainer: ae Status: ready --><!-- CREDITS: felipe,ae,leonardolara -->
|
|
<book xml:id="book.filter" xmlns="http://docbook.org/ns/docbook">
|
|
<?phpdoc extension-membership="bundled" ?>
|
|
<title>Filtragem de dados</title>
|
|
<titleabbrev>Filter</titleabbrev>
|
|
|
|
<preface xml:id="intro.filter">
|
|
&reftitle.intro;
|
|
<simpara>
|
|
Esta extensão fornece filtros que podem ser usados para validar ou sanitizar dados.
|
|
Isto é especialmente útil quando a fonte contém dados desconhecidos (ou externos),
|
|
como dados enviados pelo usuário.
|
|
Por exemplo, esses dados podem vir de um formulário <acronym>HTML</acronym>.
|
|
</simpara>
|
|
<simpara>
|
|
Há dois tipos principais de filtragem:
|
|
<emphasis>validação</emphasis> e <emphasis>higienização</emphasis>.
|
|
</simpara>
|
|
<simpara>
|
|
Um filtro de validação é utilizado para verificar se os dados cumprem certos critérios.
|
|
Estes filtros são identificados pelas
|
|
constantes
|
|
<constant>FILTER_VALIDATE_<replaceable>*</replaceable></constant>.
|
|
Por exemplo, a constante <constant>FILTER_VALIDATE_EMAIL</constant>
|
|
pode ser usada para determinar se o dado é um endereço de e-mail válido.
|
|
Entretanto, ele nunca alterará os dados de entrada.
|
|
</simpara>
|
|
<simpara>
|
|
A sanitização, por outro lado, "limpará" os dados,
|
|
portanto pode alterar os dados de entrada adicionando ou removendo caracteres.
|
|
Estes filtros são identificados pelas
|
|
constantes
|
|
<constant>FILTER_SANITIZE_<replaceable>*</replaceable></constant>.
|
|
Por exemplo, o filtro <constant>FILTER_SANITIZE_EMAIL</constant>
|
|
removerá caracteres que são inadequados para um endereço de e-mail.
|
|
Entretanto, os dados sanitizados não são validados para verificar se o endereço
|
|
é válido.
|
|
</simpara>
|
|
<simpara>
|
|
A maioria dos filtros suporta <emphasis>sinalizadores</emphasis> opcionais que podem ajustar
|
|
o comportamento do filtro.
|
|
Estes sinalizadores são identificados pelas
|
|
constantes
|
|
<constant>FILTER_FLAG_<replaceable>*</replaceable></constant>.
|
|
Por exemplo, usar <constant>FILTER_FLAG_PATH_REQUIRED</constant> com um filtro de validação
|
|
<constant>FILTER_VALIDATE_URL</constant> irá
|
|
requerer que um <acronym>URL</acronym> tenha um caminho
|
|
(por exemplo, <literal>/foo</literal> em <literal>https://example.org/foo</literal>).
|
|
</simpara>
|
|
</preface>
|
|
|
|
&reference.filter.setup;
|
|
&reference.filter.constants;
|
|
&reference.filter.examples;
|
|
&reference.filter.reference;
|
|
|
|
</book>
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
mode: sgml
|
|
sgml-omittag:t
|
|
sgml-shorttag:t
|
|
sgml-minimize-attributes:nil
|
|
sgml-always-quote-attributes:t
|
|
sgml-indent-step:1
|
|
sgml-indent-data:t
|
|
indent-tabs-mode:nil
|
|
sgml-parent-document:nil
|
|
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
|
|
sgml-exposed-tags:nil
|
|
sgml-local-catalogs:nil
|
|
sgml-local-ecat-files:nil
|
|
End:
|
|
vim600: syn=xml fen fdm=syntax fdl=2 si
|
|
vim: et tw=78 syn=sgml
|
|
vi: ts=1 sw=1
|
|
-->
|
|
|