Zend_Filter_Input предоставляет простые средства, способствующие жесткому и сруктурированному подходу к фильтрации входных данных. Его назначение многостороннее, поскольку он удовлетворяет нужды трех различных групп людей:

Есть множество подходов к фильтрации входных данных и средств, применяемых разработчиками PHP. Фильтрация по "белому списку", по "черному списку", регулярные выражения, условные операторы, встроенные функции PHP - только несколько примеров из всего разнообразия подходов к фильтрации входных данных. Zend_Filter_Input объединяет все эти средства в единый API с единообразным поведением и строгим соглашением по наименованию. Все эти методы следуют простому правилу - если данные являются допустимыми, то они возвращаются, иначе возвращается FALSE. Экстремально просто.

    <?php
    
    $filterPost = new Zend_Filter_Input($_POST);
    
    if ($alphaName = $filterPost->testAlpha('name')) {
        /* $alphaName содержит только алфавитные символы. */
    } else {
        /* $alphaName имеет значение FALSE. */
    }
    
    ?>
            

    <?php
    
    $filterPost = new Zend_Filter_Input($_POST);
    $alphaName = $filterPost->testAlpha('name');
    
    if ($alphaName !== FALSE) {
        /* $alphaName содержит только алфавитные символы. */
    } else {
        /* $alphaName === FALSE */
    }
    
    ?>
            

    <?php
    
    /* $_POST['username'] = 'John123Doe'; */
    
    $filterPost = new Zend_Filter_Input($_POST);
    $alphaUsername = $filterPost->getAlpha('username');
    
    /* $alphaUsername = 'JohnDoe'; */
    
    ?>
            

<?php
    
/* $_POST['comment'] = '<b>I love PHP!</b>'; */

$filterPost = new Zend_Filter_Input($_POST);
$taglessComment = $filterPost->noTags('comment');

/* $taglessComment = 'I love PHP!'; */
    
?>

Zend_Filter_Input объединяет различные подходы к фильтрации входных данных в единый API с единообразным поведением и строгим соглашением по наименованию (смотрите Раздел 7.2.1, «Введение»). Эти характеристики ставят Zend_Filter_Input на один уровень с существующими решениями, но не оказывают дальнейшей поддержки тем, кто требует большей структурности или жесткого подхода. Тем не менее, по умолчанию Zend_Filter_Input осуществляет контролируемый доступ к входным данным.

Поддерживаются два синтаксиса. В подходе по умолчанию (строгом) единственный аргумент, передаваемый конструктору, - массив для фильтрации:

    <?php
    
    $filterPost = new Zend_Filter_Input($_POST);
    $email = $filterPost->testEmail('email');
    
    ?>
        

Zend_Filter_Input устанавливает значение переданного массива ($_POST) в NULL, поэтому дальнейший прямой доступ становится невозможным. (Необработанные данные доступны только через метод getRaw(), который намного легче контролировать и/или сделать недействительным.)

В дополнительном (нестрогом) подходе конструктору в качестве второго аргумента передается FALSE:

    <?php
    
    $filterPost = new Zend_Filter_Input($_POST, FALSE);
    $email = $filterPost->testEmail('email');
    
    ?>
        

Использование фильтра будет таким же, за исключеним того, что Zend_Filter_Input не устанавливает значение исходного массива ($_POST) в NULL, так что разработчики по-прежнему могут иметь прямой доступ. Этот подход лишен привлекательности строгого подхода.

Zend_Filter_Input спроектирован для работы с массивами. Многие источники входных данных уже предусмотрены в суперглобальных массивах ($_GET, $_POST, $_COOKIE и т.д.), массивы часто используются в качестве конструкции для хранения входных данных из других источников. Если вам нужно фильтровать отдельные значения, см. Глава 7, Zend_Filter.

Строгая фильтрация по "белому списку" (предпочтительная):

    <?php
    
    $filterPost = new Zend_Filter_Input($_POST);
    
    if ($email = $filterPost->testEmail('email')) {
        /* $email имеет допустимый формат. */
    } else {
        /* $email имеет недопустимый формат. */
    }
    
    ?>
        

Строгая "слепая" фильтрация:

    <?php
    
    $filterPost = new Zend_Filter_Input($_POST);
    $alphaName = $filterPost->getAlpha('name');
    
    ?>
        

Строгая фильтрация по "черному списку":

    <?php
    
    $filterPost = new Zend_Filter_Input($_POST);
    $taglessComment = $filterPost->noTags('comment');
    
    ?>
        

Нестрогая фильтрация по "белому списку":

    <?php
    
    $filterPost = new Zend_Filter_Input($_POST, FALSE);
    
    if ($email = $filterPost->testEmail('email')) {
        /* $email имеет допустимый формат. */
    } else {
        /* $email имеет недопустимый формат. */
    }
    
    ?>
        

Нестрогая "слепая" фильтрация:

    <?php
    
    $filterPost = new Zend_Filter_Input($_POST, FALSE);
    $name = $filterPost->getAlpha('name');
    
    ?>
        

Нестрогая фильтрация по "черному списку":

    <?php
    
    $filterPost = new Zend_Filter_Input($_POST, FALSE);
    $comment = $filterPost->noTags('comment');
    
    ?>