mirror of
https://github.com/php/doc-ru.git
synced 2026-03-23 23:32:16 +01:00
73 lines
3.6 KiB
XML
73 lines
3.6 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
||
<!-- EN-Revision: 53054bf8decc8648cf2e90a493692a161e2371af Maintainer: shein Status: ready -->
|
||
<!-- Reviewed: no -->
|
||
<book xml:id="book.filter" xmlns="http://docbook.org/ns/docbook">
|
||
<?phpdoc extension-membership="bundled" ?>
|
||
<title>Модуль фильтрации данных</title>
|
||
<titleabbrev>Filter</titleabbrev>
|
||
|
||
<preface xml:id="intro.filter">
|
||
&reftitle.intro;
|
||
<simpara>
|
||
Модуль предоставляет фильтры для проверки или очистки данных.
|
||
Фильтры полезны, когда источник содержит неизвестные или посторонние данные
|
||
наподобие данных пользовательского ввода,
|
||
которые поступили из <acronym>HTML</acronym>-формы.
|
||
</simpara>
|
||
<simpara>
|
||
В основе работы модуля лежат два типа фильтрации данных:
|
||
<emphasis>проверка</emphasis> и <emphasis>очистка</emphasis>.
|
||
</simpara>
|
||
<simpara>
|
||
Проверка определяет соответствие данных конкретным критериям.
|
||
Фильтры проверки обозначаются константами <constant>FILTER_VALIDATE_<replaceable>*</replaceable></constant>.
|
||
Фильтр <constant>FILTER_VALIDATE_EMAIL</constant>, например, проверяет,
|
||
соответствует ли входное значение допустимому адресу электронной почты, однако сами данные при этом
|
||
не изменяются.
|
||
</simpara>
|
||
<simpara>
|
||
Очистка удаляет из данных нежелательные конструкции,
|
||
поэтому изменяет входные данные: добавляет или удаляет символы.
|
||
Фильтры очистки обозначаются константами <constant>FILTER_SANITIZE_<replaceable>*</replaceable></constant>.
|
||
Константа <constant>FILTER_SANITIZE_EMAIL</constant>, например, удалит недопустимые
|
||
для адреса эл. почты символы. Обратите внимание, очистка проверяет только символы, но не структуру адреса.
|
||
</simpara>
|
||
<simpara>
|
||
Большая часть фильтров поддерживают дополнительные <emphasis>флаги</emphasis>,
|
||
которые изменяют поведение фильтра.
|
||
Флаги очистки обозначаются константами <constant>FILTER_FLAG_<replaceable>*</replaceable></constant>.
|
||
Передача флага <constant>FILTER_FLAG_PATH_REQUIRED</constant> с фильтром <constant>FILTER_VALIDATE_URL</constant>
|
||
потребует, чтобы <acronym>URL</acronym>-адрес содержал компонент пути:
|
||
часть <literal>/foo</literal> в адресе
|
||
<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
|
||
-->
|