Zend_Filter_Input dostarcza proste metody, które zapewniają poważne potraktowanie filtrowania danych przychodzących. Jej przeznaczenie jest różnorodne, ponieważ zaspokaja ona potrzeby trzech różnych grup ludzi:

Jest wiele różnych zdań na temat filtrowania danych przychodzących i jest wiele różnych metod, których programiści mogą użyć. Filtrowanie whitelist, filtrowanie blacklist, wyrażenia regularne, wyrażenia warunkowe oraz natywne funkcje PHP są tylko kilkoma przykładami filtrowania danych przychodzących. Zend_Filter_Input łączy te metody w jedno API o jednolitym działaniu oraz o sztywnych konwencjach nazewnictwa. Wszystkie metody działają według prostej zasady - jeśli dane są prawidłowe, są one zwracane, w przeciwnym wypadku zwracana jest wartość FALSE. Jest to maksymalnie proste.

    <?php
    
    $filterPost = new Zend_Filter_Input($_POST);
    
    if ($alphaName = $filterPost->testAlpha('name')) {
        /* $alphaName zawiera tylko litery. */
    } else {
        /* $alphaName ma wartość FALSE. */
    }
    
    ?>
            

    <?php
    
    $filterPost = new Zend_Filter_Input($_POST);
    $alphaName = $filterPost->testAlpha('name');
    
    if ($alphaName !== FALSE) {
        /* $alphaName zawiera tylko litery. */
    } else {
        /* $alphaName === FALSE */
    }
    
    ?>
            

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

    <?php
    
    /* $_POST['comment'] = '<b>Kocham PHP!</b>'; */
    
    $filterPost = new Zend_Filter_Input($_POST);
    $taglessComment = $filterPost->noTags('comment');
    
    /* $taglessComment = 'Kocham PHP!'; */
    
    ?>
            

Zend_Filter_Input łączy kilka różnych podejść do filtrowania danych przychodzących w jedno API o jednolitym działaniu oraz o sztywnych konwencjach nazewnictwa. (zobacz Sekcja 7.2.1, „Wprowadzenie”).

Obsługiwane są dwa typy składni. W domyślnym sposobie do konstruktora przekazywany jest pojedynczy argument - tablica która ma być filtrowana:

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

Zend_Filter_Input zmienia wartość tablicy, która została przekazana ($_POST) na NULL, więc bezpośredni dostęp do niej nie jest już możliwy. (Dostęp do niefiltrowanych danych jest jedynie możliwe za pomocą metody getRaw(), która jest dużo łatwiejsza do kontrolowania)

W sposobie opcjonalnym, wartość FALSE jest przekazywana jako drugi argument do konstruktora:

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

Użycie filtra jest identyczne, ale Zend_Filter_Input nie ustawia wartości oryginalnej tablicy ($_POST) na NULL, więc dalej jest możliwy bezpośredni dostęp do danych. Ten sposób nie jest polecany, polecany jest sposób pierwszy.

Zend_Filter_Input jest zaprojektowany głównie w celu filtrowania tablic. Duża część danych wejściowych pochodzi z superglobalnych tablic PHP ($_GET, $_POST, $_COOKIE, itp.), a tablice także są najczęstszą strukturą używaną do przechowywania danych wejściowych pochodzących z innych źródeł. Jeśli potrzebujesz filtrować wartości skalarne (nietablicowe) zobacz Rozdział 7, Zend_Filter.

Ścisłe filtrowanie whitelist (preferowane):

    <?php
    
    $filterPost = new Zend_Filter_Input($_POST);
    
    if ($email = $filterPost->testEmail('email')) {
        /* $email jest prawidłowym adresem email. */
    } else {
        /* $email nie jest prawidłowym adresem email. */
    }
    
    ?>
        

Ścisłe filtrowanie blind:

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

Ścisłe filtrowanie blacklist:

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

Nieścisłe filtrowanie whitelist:

    <?php
    
    $filterPost = new Zend_Filter_Input($_POST, FALSE);
    
    if ($email = $filterPost->testEmail('email')) {
        /* $email jest prawidłowym adresem email. */
    } else {
        /* $email nie jest prawidłowym adresem email. */
    }
    
    ?>
        

Nieścisłe filtrowanie blind:

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

Nieścisłe filtrowanie blacklist:

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