array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'en', ), 'this' => array ( 0 => 'book.filter.php', 1 => 'Filter', 2 => 'Data Filtering', ), 'up' => array ( 0 => 'refs.basic.vartype.php', 1 => 'Variable and Type Related Extensions', ), 'prev' => array ( 0 => 'function.ctype-xdigit.php', 1 => 'ctype_xdigit', ), 'next' => array ( 0 => 'filter.setup.php', 1 => 'Installing/Configuring', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/filter/book.xml', ), 'history' => array ( ), 'extra_header_links' => array ( 'rel' => 'alternate', 'href' => '/manual/en/feeds/book.filter.atom', 'type' => 'application/atom+xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Data Filtering

Introduction

This extension provides filters which can be used to validate or sanitize data. This is especially useful when the data source contains unknown (or foreign) data, like user supplied input. For example, this data may come from an HTML form.

There are two main types of filtering: validation and sanitization.

A validation filter is used to check if the data meets certain criteria. These filters are identified by the FILTER_VALIDATE_* constants. For example, the FILTER_VALIDATE_EMAIL filter can be used to determine if the data is a valid email address. However, it will never alter the input data.

Sanitization on the other hand will "clean up" the data, therefore it may alter the input data by adding or removing characters. These filters are identified by the FILTER_SANITIZE_* constants. For example, the FILTER_SANITIZE_EMAIL filter will remove characters that are inappropriate for an email address to contain. However, the sanitized data is not validated to check if it is a valid email address.

Most filters support optional flags that can tweak the behavior of the filter. These flags are identified by the FILTER_FLAG_* constants. For example, using the FILTER_FLAG_PATH_REQUIRED with the FILTER_VALIDATE_URL validation filter requires that the URL has a path (e.g. /foo in https://example.org/foo).