Die folgenden Optionen werden für Zend_Filter_Alnum unterstützt:

Das folgende Beispiel zeigt das Standardverhalten dieses Filters.

$filter = new Zend_Filter_Alnum();
$return = $filter->filter('This is (my) content: 123');
// Gibt 'Thisismycontent123' zurück

Das oben stehende Beispiel gibt 'Thisismycontent123' zurück. Wie man sehen kann werden alle Leerzeichen und auch die Klammern gefiltert.

Zend_Filter_Alnum kann auch Leerzeichen erlauben. Das kann nützlich sein wenn man spezielle Zeichen von einem Text entfernen will. Siehe das folgende Beispiel:

$filter = new Zend_Filter_Alnum(array('allowwhitespace' => true));
$return = $filter->filter('This is (my) content: 123');
// Gibt 'This is my content 123' zurück

Das obige Beispiel gibt 'This is my content 123' zurück. Wie man sieht werden nur die Klammern gefiltert wobei die Leerzeichen nicht angefasst werden.

Am allowWhiteSpace im Nachhinein zu ändern kann man setAllowWhiteSpace und getAllowWhiteSpace verwenden.

Die folgenden Optionen werden für Zend_Filter_Alpha unterstützt:

Ein einfaches Beispiel der Verwendung ist anbei:

$filter = new Zend_Filter_Alpha();

print $filter->filter('Das ist (mein) Inhalt: 123');

Das obige Beispiel gibt 'DasistmeinInhalt' zurück. Es sollte beachtet werden dass Leerzeichen und Klammern entfernt werden.

Zend_Filter_Alpha kann auch Leerzeichen erlauben. Dies kann nützlich sein wenn man spezielle Zeichen von einem Statz entfernen will. Siehe das folgende Beispiel:

$filter = new Zend_Filter_Alpha(array('allowwhitespace' => true));

print $filter->filter('Das ist (mein) Inhalt: 123');

Das oben stehende Beispiel gibt 'Das ist mein Inhalt ' zurück. Es ist zu beachten das alle Klammern, Doppelpunkte und Zahlen entfernt werden während die Leerzeichen bleiben.

Um allowWhiteSpace nach der Instanziierung zu ändern kann die Methode setAllowWhiteSpace() verwendet werden.

Um den aktuellen Wert von allowWhiteSpace zu erhalten kann die Methode getAllowWhiteSpace() verwendet werden.

Es gibt keine zusätzlichen Optionen für Zend_Filter_BaseName.

Ein einfaches Beispiel der Verwendung ist nachfolgend zu finden:

$filter = new Zend_Filter_BaseName();

print $filter->filter('/vol/tmp/filename');

Das gibt 'filename' zurück.

$filter = new Zend_Filter_BaseName();

print $filter->filter('/vol/tmp/filename.txt');

Das gibt 'filename.txt' zurück.

Standardmäßig arbeitet dieser Filter indem er Eingabe auf BOOLEAN Werte castet; in anderen Worte, er arbeitet in ähnlicher Weise wie der Aufruf von (boolean) $value.

$filter = new Zend_Filter_Boolean();
$value  = '';
$result = $filter->filter($value);
// gibt false zurück

Dies bedeuetet dass Zend_Filter_Boolean ohne die Angabe einer Konfiguration alle Eingabetypen akteptiert und ein BOOLEAN zurückgibt wie man es durch Typcasting zu BOOLEAN erhält.

Manchmal ist das Casten mit (boolean) nicht ausreichend. Zend_Filter_Boolean erlaubt es spezifische Typen zu konfigurieren welche konvertiert werden, und jene die ignoriert werden.

Die folgenden Typen können behandelt werden:

Alle anderen angegebenen Werte geben standardmäßig TRUE zurück.

Es gibt verschiedene Wege um auszuwählen welche der oben stehenden Typen gefiltert werden. Man kann ein oder mehrere Typen angeben und Sie hinzufügen, man kann ein Array angeben, man kann die Konstanten verwenden, oder man kann einen textuellen String angeben. Siehe die folgenden Beispiele:

// Konvertiert 0 zu false
$filter = new Zend_Filter_Boolean(Zend_Filter_Boolean::INTEGER);

// Konvertiert 0 und '0' zu false
$filter = new Zend_Filter_Boolean(
    Zend_Filter_Boolean::INTEGER + Zend_Filter_Boolean::ZERO
);

// Konvertiert 0 und '0' zu false
$filter = new Zend_Filter_Boolean(array(
    'type' => array(
        Zend_Filter_Boolean::INTEGER,
        Zend_Filter_Boolean::ZERO,
    ),
));

// Konvertiert 0 und '0' zu false
$filter = new Zend_Filter_Boolean(array(
    'type' => array(
        'integer',
        'zero',
    ),
));

Man kann auch eine Instanz von Zend_Config angeben um die gewünschten Typen zu setzen. Um Typen nach der Instanzierung zu setzen kann die Methode setType() verwendet werden.

Wie vorher erwähnt erkennt Zend_Filter_Boolean auch die lokalisierten Strings für "Ja" und "Nein". Das bedeutet das man den Kunden in einem Formular nach "Ja" oder "Nein" in seiner eigenen Sprache fragen kann und Zend_Filter_Boolean die Antworten zu richtigen boolschen Werten konvertieren wird.

Um das gewünschte Gebietsschema zu setzen kann man entweder die Option locale verwenden oder die Methode setLocale() verwenden.

$filter = new Zend_Filter_Boolean(array(
    'type'   => Zend_Filter_Boolean::ALL,
    'locale' => 'de',
));

// Gibt false zurück
echo $filter->filter('nein');

$filter->setLocale('en');

// Gibt true zurück
$filter->filter('yes');

Machmal ist es nützlich nur TRUE oder FALSE zu erkennen und alle anderen Werte ohne Änderung zurückzugeben. Zend_Filter_Boolean erlaubt dies indem die Option casting auf FALSE gesetzt wird.

In diesem Fall arbeitet Zend_Filter_Boolean wie in der folgenden Tabelle beschrieben, die zeigt welche Werte TRUE oder FALSE zurückgeben. Alle anderen angegebenen Werte werden ohne Änderung zurückgegeben wenn casting auf FALSE gesetzt wird.

Das folgende Beispiel zeigt das Verhalten wenn die Option casting verändert wird:

$filter = new Zend_Filter_Boolean(array(
    'type'    => Zend_Filter_Boolean::ALL,
    'casting' => false,
));

// Gibt false zurück
echo $filter->filter(0);

// Gibt true zurück
echo $filter->filter(1);

// Gibt den Wert zurück
echo $filter->filter(2);

Um einen Kompressions Filter zu erstellen muss man das Kompressions Format auswählen welches man verwenden will. Die folgende Beschreibung nimmt den Bz2 Adapter. Details für alle anderen Adapter werden nach dieser Sektion beschrieben.

Diese zwei Filter sind grundsätzlich identisch, da Sie das gleiche Backend verwenden. Zend_Filter_Compress sollte verwendet werden wenn man Elemente komprimieren will, und Zend_Filter_Decompress sollte verwendet werden wenn man Elemente dekomprimieren will.

Wenn man zum Beispiel einen String komprimieren will, müssen wir Zend_Filter_Compress instanziieren und den gewünschten Adapter angeben.

$filter = new Zend_Filter_Compress('Bz2');

Um einen anderen Adapter zu verwenden muss dieser einfach im Constructor spezifiziert werden.

Man kann auch ein Array von Optionen oder ein Zend_Config Objekt anbieten. Wenn man das tut sollte mindestens der Schlüssel "adapter" angegeben werden, und anschließend entweder der Schlüssel "options" oder "adapterOptions" (welches ein Array von Optionen ein sollte das dem Adapter bei der Instanziierung übergeben wird).

$filter = new Zend_Filter_Compress(array(
    'adapter' => 'Bz2',
    'options' => array(
        'blocksize' => 8,
    ),
));

Fast die gleiche Verwendung ist die Dekomprimierung eines Strings. Wir müssen in diesem Fall nur den Dekompressions Filter verwenden.

$filter = new Zend_Filter_Decompress('Bz2');

Um einen komprimierten String zu erhalten muss der originale String angegeben werden. Der gefilterte Wert ist die komprimierte Version des originalen Strings.

$filter     = new Zend_Filter_Compress('Bz2');
$compressed = $filter->filter('Uncompressed string');
// Gibt den komprimierten String zurück

Dekomprimierung funktioniert auf die gleiche Weise.

$filter     = new Zend_Filter_Decompress('Bz2');
$compressed = $filter->filter('Compressed string');
// Gibt den dekomprimierten String zurück

Die Erstellung einer Archivedatei arbeitet fast auf die gleiche Weise wie die Komprimierung eines Strings. Trotzdem benötigen wir in diesem Fall einen zusätzlichen Parameter welcher den Namen des Archivs enthält welches wir erstellen wollen.

$filter     = new Zend_Filter_Compress(array(
    'adapter' => 'Bz2',
    'options' => array(
        'archive' => 'filename.bz2',
    ),
));
$compressed = $filter->filter('Uncompressed string');
// Gibt bei Erfolg true zurück und erstellt die Archiv Datei

Im obigen Beispeil wird der unkomprimierte String komprimiert, und wird dann in die angegebene Archiv Datei geschrieben.

Wenn man eine Datei komprimieren will, dann muss man den Namen der Datei mit dessen Pfad angeben.

$filter     = new Zend_Filter_Compress(array(
    'adapter' => 'Bz2',
    'options' => array(
        'archive' => 'filename.bz2'
    ),
));
$compressed = $filter->filter('C:\temp\compressme.txt');
// Gibt bei Erfolg true zurück und erstellt die Archiv Datei

Man kann auch ein Verzeichnis statt einem Dateinamen spezifizieren. In diesem Fall wird das gesamte Verzeichnis mit allen seinen Dateien und Unterverzeichnissen in das Archiv komprimiert.

$filter     = new Zend_Filter_Compress(array(
    'adapter' => 'Bz2',
    'options' => array(
        'archive' => 'filename.bz2'
    ),
));
$compressed = $filter->filter('C:\temp\somedir');
// Gibt bei Erfolg true zurück und erstellt die Archiv Datei

Die Dekomprimierung einer Archivdatei arbeitet fast wie dessen Komprimierung. Man muss entweder die Eigenschaft archive spezifizieren, oder den Dateinamen des Archivs angeben wenn man die Datei dekomprimiert.

$filter     = new Zend_Filter_Decompress('Bz2');
$compressed = $filter->filter('filename.bz2');
// Gibt bei Erfolg true zurück und dekomprimiert die Archiv Datei

Einige Adapter unterstützen die Dekomprimierung des Archivs in ein anderes Unterverzeichnis. In diesem Fall kann der Parameter target spezifiziert werden.

$filter     = new Zend_Filter_Decompress(array(
    'adapter' => 'Zip',
    'options' => array(
        'target' => 'C:\temp',
    )
));
$compressed = $filter->filter('filename.zip');
// Gibt bei Erfolg true zurück und dekomprimiert die Archiv Datei
// in das angegebene Zielverzeichnis

Der Bz2 Adapter kann folgendes komprimieren und dekomprimieren:

Dieser Adapter verwendet PHP's Bz2 Erweiterung.

Um die Komprimierung anzupassen unterstützt dieser Adapter die folgenden Optionen:

Alle Optionen können bei der Instanziierung oder durch Verwendung der betreffenden Methode verwendet werden. Zum Beispiel sind die zu 'Blocksize' gehörenden Methoden getBlocksize() und setBlocksize(). Man kann auch die setOptions() Methode verwenden welche alle Optionen als Array akzeptiert.

Der Gz Adapter kann folgendes komprimieren und dekomprimieren:

Dieser Adapter verwendet PHP's Zlib Erweiterung.

Um die Komprimierung anzupassen unterstützt dieser Adapter die folgenden Optionen:

Alle Optionen können bei der Instanziierung oder durch Verwendung der betreffenden Methode verwendet werden. Zum Beispiel sind die zu 'Level' gehörenden Methoden getLevel() und setLevel(). Man kann auch die setOptions() Methode verwenden welche alle Optionen als Array akzeptiert.

Der Lzf Adapter kann folgendes komprimieren und dekomprimieren:

Dieser Adapter verwendet PHP's Lzf Erweiterung.

Es sind keine Optionen vorhanden um diesen Adapter anzupassen.

Der Rar Adapter kann folgendes komprimieren und dekomprimieren:

Dieser Adapter verwendet PHP's Rar Erweiterung.

Um die Komprimierung anzupassen unterstützt dieser Adapter die folgenden Optionen:

Alle Optionen können bei der Instanziierung oder durch Verwendung der betreffenden Methode verwendet werden. Zum Beispiel sind die zu 'Target' gehörenden Methoden getTarget() und setTarget(). Man kann auch die setOptions() Methode verwenden welche alle Optionen als Array akzeptiert.

Der Rar Adapter kann folgendes komprimieren und dekomprimieren:

Dieser Adapter verwendet PEAR's Archive_Tar Komponente.

Um die Komprimierung anzupassen unterstützt dieser Adapter die folgenden Optionen:

Alle Optionen können bei der Instanziierung oder durch Verwendung der betreffenden Methode verwendet werden. Zum Beispiel sind die zu 'Target' gehörenden Methoden getTarget() und setTarget(). Man kann auch die setOptions() Methode verwenden welche alle Optionen als Array akzeptiert.

Der Rar Adapter kann folgendes komprimieren und dekomprimieren:

Dieser Adapter verwendet PHP's Zip Erweiterung.

Um die Komprimierung anzupassen unterstützt dieser Adapter die folgenden Optionen:

Alle Optionen können bei der Instanziierung oder durch Verwendung der betreffenden Methode verwendet werden. Zum Beispiel sind die zu 'Target' gehörenden Methoden getTarget() und setTarget(). Man kann auch die setOptions() Methode verwenden welche alle Optionen als Array akzeptiert.

Für die Entschlüsselung von Inhalten die vorher mit Mcrypt verschlüsselt wurden muß man die Optionen wissen mit denen die Verschlüsselung aufgerufen wurde.

Es gibt einen wichtigen Unterschied. Wenn man bei der Verschlüsselung keinen Vektor angegeben hat, muß man Ihn nach der Verschlüsselung des Inhalts holen indem die getVector() Methode am Verschlüsselungs-Filter aufgerufen wird. Ohne den richtigen Vektor ist man nicht in der Lage den Inhalt zu entschlüsseln.

Sobald man alle Optionen angegeben hat ist die Entschlüsselung so einfach wie die Verschlüsselung.

// Verwende die Standardmäßigen Blowfish Einstellungen
$filter = new Zend_Filter_Decrypt('myencryptionkey');

// Setze den Vektor mit dem der Inhalt verschlüsselt wurde
$filter->setVector('myvector');

$decrypted = $filter->filter('encoded_text_normally_unreadable');
print $decrypted;

Entschlüsselung mit OpenSSL ist so einfach die Verschlüsseln. Aber man benötigt alle Daten von der Person die den Inhalt verschlüsselt hat.

Für die Entschlüsselung mit OpenSSL benötigt man:

// Verwende openssl und gib einen privaten Schlüssel an
$filter = new Zend_Filter_Decrypt(array(
    'adapter' => 'openssl',
    'private' => '/path/to/mykey/private.pem'
));

// natürlich kann man den Umschlagschlüssel auch bei der Instanziierung angeben
$filter->setEnvelopeKey(array(
    '/key/from/encoder/first.pem',
    '/key/from/encoder/second.pem'
));

Optional könnte es notwendig sein die Passphrase für die Entschlüsselung der Schlüssel selbst anzugeben indem die setPassphrase() Methode verwendet wird.

// Verwende openssl und gib einen privaten Schlüssel an
$filter = new Zend_Filter_Decrypt(array(
    'adapter' => 'openssl',
    'private' => '/path/to/mykey/private.pem'
));

// natürlich kann man den Umschlagschlüssel auch bei der Instanziierung angeben
$filter->setEnvelopeKey(array(
    '/key/from/encoder/first.pem',
    '/key/from/encoder/second.pem'
));
$filter->setPassphrase('mypassphrase');

Zum Schluß kann der Inhalt entschlüsselt werden. Unser komplettes Beispiel für den vorher verschlüsselten Inhat sieht nun wie folgt aus.

// Verwende openssl und gib einen privaten Schlüssel an
$filter = new Zend_Filter_Decrypt(array(
    'adapter' => 'openssl',
    'private' => '/path/to/mykey/private.pem'
));

// natürlich kann man den Umschlagschlüssel auch bei der Instanziierung angeben
$filter->setEnvelopeKey(array(
    '/key/from/encoder/first.pem',
    '/key/from/encoder/second.pem'
));
$filter->setPassphrase('mypassphrase');

$decrypted = $filter->filter('encoded_text_normally_unreadable');
print $decrypted;

Es gibt keine zusätzlichen Optionen für Zend_Filter_Digits.

Ein einfaches Beispiel der Verwendung ist nachfolgend zu finden:

$filter = new Zend_Filter_Digits();

print $filter->filter('October 2009');

Dies gibt "2009" zurück.

$filter = new Zend_Filter_Digits();

print $filter->filter('HTML 5 für Dummies');

Dies gibt "5" zurück.

Es gibt keine zusätzlichen Optionen für Zend_Filter_Dir.

Ein einfaches Beispiel der Verwendung ist nachfolgend zu finden:

$filter = new Zend_Filter_Dir();

print $filter->filter('/etc/passwd');

Dies gibt "/etc" zurück.

$filter = new Zend_Filter_Dir();

print $filter->filter('C:/Temp/x');

Dies gibt "C:/Temp" zurück.

Wenn man die Mcrypt Erweiterung installiert hat, kann man den Mcrypt Adapter verwenden. Dieser Adapter unterstützt bei der Initialisierung die folgenden Optionen:

Wenn man einen String statt einem Array übergibt, wird dieser String als key Option verwendet.

Man kan die Verschlüsselungswerte auch im Nachhinein mit den Methoden getEncryption() und setEncryption() erhalten und setzen.

Man kann den Verschlüsselungs Vektor durch den Aufruf von getVector() und setVector() erhalten und setzen. Ein engegebener String wird, je nach benötigter Vektorgröße des verwendeten Algorithmus, abgeschnitten oder aufgefüllt.

// Verwendet die standardmäßigen Blowfish Einstellungen
$filter = new Zend_Filter_Encrypt('myencryptionkey');

// Setzt einen eigenen Vektor, andernfalls muß man getVector()
// ausrufen und diesen Vektor für spätere Entschlüsselung speichern
$filter->setVector('myvector');
// $filter->getVector();

$encrypted = $filter->filter('text_to_be_encoded');
print $encrypted;

// Für Entschlüsselung siehe den Decrypt Filter

Wenn man die OpenSSL Erweiterung installiert hat, kann man den OpenSSL Adapter verwenden. Dieser Adapter unterstützt bei der Instanziierung die folgenden Optionen:

Man kann öffentliche Schlüssel auch im Nachhinein mit den Methoden getPublicKey() und setPublicKey() erhalten und setzen. Auch der private Schlüssel kann mit den entsprechenden Methoden getPrivateKey() und setPrivateKey() geholt und gesetzt werden.

// Verwende openssl und gib einen privaten Schlüssel an
$filter = new Zend_Filter_Encrypt(array(
    'adapter' => 'openssl',
    'private' => '/path/to/mykey/private.pem'
));

// natürlich kann man die öffentlichen Schlüssel auch
// bei der Instanziierung angeben
$filter->setPublicKey(array(
    '/public/key/path/first.pem',
    '/public/key/path/second.pem'
));

Wenn man auch die Schlüssel selbst verschlüsseln will, muß man eine Passphrase mit der setPassphrase() Methode angeben. Wenn man Inhalte entschlüsseln will, die mit einer Passphrase verschlüsselt wurden, muß man nicht nur den öffentlichen Schlüssel, sondern auch die Passphrase um den verschlüsselten Schlüssel zu entschlüsseln.

// Verwende openssl und gib einen privaten Schlüssel an
$filter = new Zend_Filter_Encrypt(array(
    'adapter' => 'openssl',
    'private' => '/path/to/mykey/private.pem'
));

// Natürlich kann man die öffentlichen Schlüssel
// auch bei der Instanziierung angeben
$filter->setPublicKey(array(
    '/public/key/path/first.pem',
    '/public/key/path/second.pem'
));
$filter->setPassphrase('mypassphrase');

Zum Schluß muß man, wenn OpenSSL verwendet wird, dem Empfänger den verschlüsselten Inhalt, die Passphrase, wenn eine angegeben wurde, und den Umschlagschlüssel für die Entschlüsselung angeben.

Das bedeutet, das man die Umschlagschlüssel nach der Verschlüsselung mit der getEnvelopeKey() Methode holen muß.

Unser komplettes Beispiel für die Verschlüsselung von Inhalten mit OpenSSL schaut wie folgt aus.

// Verwende openssl und gib einen privaten Schlüssel an
$filter = new Zend_Filter_Encrypt(array(
    'adapter' => 'openssl',
    'private' => '/path/to/mykey/private.pem'
));

// natürlich kann man die öffentlichen Schlüssel
// auch bei der Instaiziierung angeben
$filter->setPublicKey(array(
    '/public/key/path/first.pem',
    '/public/key/path/second.pem'
));
$filter->setPassphrase('mypassphrase');

$encrypted = $filter->filter('text_to_be_encoded');
$envelope  = $filter->getEnvelopeKey();
print $encrypted;

// Für die Entschlüsselung siehe beim Decrypt Filter

// Verwende openssl und gib einen privaten Schlüssel an
$filter = new Zend_Filter_Encrypt(array(
    'adapter' => 'openssl',
    'private' => '/path/to/mykey/private.pem',
    'public'  => '/public/key/path/public.pem',
    'package' => true
));

$encrypted = $filter->filter('text_to_be_encoded');
print $encrypted;

// Für die Entschlüsselung siehe beim Decrypt Filter

// Verwende nur den grundsätzlichen Komprimierungsadapter
$filter1 = new Zend_Filter_Encrypt(array(
    'adapter'     => 'openssl',
    'private'     => '/path/to/mykey/private.pem',
    'public'      => '/public/key/path/public.pem',
    'package'     => true,
    'compression' => 'bz2'
));

// Verwende den Basis Komprimierungsadapter
$filter2 = new Zend_Filter_Encrypt(array(
    'adapter'     => 'openssl',
    'private'     => '/path/to/mykey/private.pem',
    'public'      => '/public/key/path/public.pem',
    'package'     => true,
    'compression' => array('adapter' => 'zip', 'target' => '\usr\tmp\tmp.zip')
));

Die folgenden Optionen werden für Zend_Filter_HtmlEntities unterstützt:

Siehe das folgende Beispiel für das Standardverhalten dieses Filters.

$filter = new Zend_Filter_HtmlEntities();

print $filter->filter('<');

Zend_Filter_HtmlEntities erlaubt es den verwendete Hochkomma Stil zu verändern. Dies kan nützlich sein wenn man doppelte, einfache oder beide Typen von Hochkommas un-gefiltert lassen will. Siehe das folgende Beispiel:

$filter = new Zend_Filter_HtmlEntities(array('quotestyle' => ENT_QUOTES));

$input  = "Ein 'einfaches' und " . '"doppeltes"';
print $filter->filter($input);

Das obige Beispiel gibt Ein 'einfaches' und "doppeltes" zurück. Es ist zu beachten dass sowohl 'einfache' als auch "doppelte" Hochkommas gefiltert werden.

$filter = new Zend_Filter_HtmlEntities(array('quotestyle' => ENT_COMPAT));

$input  = "Ein 'einfaches' und " . '"doppeltes"';
print $filter->filter($input);

Das obige Beispiel gibt Ein 'einfaches' und "doppeltes" zurück. Es ist zu beachten dass "doppelte" Hochkommas gefiltert werden während 'einfache' Hochkommas nich verändert werden.

$filter = new Zend_Filter_HtmlEntities(array('quotestyle' => ENT_NOQUOTES));

$input  = "Ein 'einfaches' und" . '"doppeltes"';
print $filter->filter($input);

Das obige Beispiel gibt Ein 'einfaches' und "doppeltes" zurück. Es ist zu beachten dass "doppelte" oder 'einfache' Hochkommas verändert werden.

Um die Option quotestyle nach der Instanzierung zu erhalten oder zu ändern, können die zwei Methoden setQuoteStyle() und getQuoteStyle() verwendet werden. setQuoteStyle() akzeptiert einen $quoteStyle Parameter. Die folgenden Konstanten werden akzeptiert: ENT_COMPAT, ENT_QUOTES, ENT_NOQUOTES

$filter = new Zend_Filter_HtmlEntities();

$filter->setQuoteStyle(ENT_QUOTES);
print $filter->getQuoteStyle(ENT_QUOTES);

Um die Option charset nach der Instanzierung zu erhalten oder zu ändern, können die zwei Methoden setCharSet() und getCharSet() verwendet werden. setCharSet() akzeptiert einen $charSet Parameter. Siehe "http://php.net/htmlentities" für eine Liste der unterstützten Zeichensets.

$filter = new Zend_Filter_HtmlEntities();

$filter->setQuoteStyle(ENT_QUOTES);
print $filter->getQuoteStyle(ENT_QUOTES);

Um die Option doublequote nach der Instanzierung zu erhalten oder zu ändern, können die zwei Methoden setDoubleQuote() und getDoubleQuote() verwendet werden. setDoubleQuote() akzeptiert einen boolschen Parameter $doubleQuote.

$filter = new Zend_Filter_HtmlEntities();

$filter->setQuoteStyle(ENT_QUOTES);
print $filter->getQuoteStyle(ENT_QUOTES);

Es gibt keine zusätzlichen Optionen für Zend_Filter_Int.

Ein einfaches Beispiel der Verwendung ist nachfolgend zu finden:

$filter = new Zend_Filter_Int();

print $filter->filter('-4 ist weniger als 0');

Das gibt '-4' zurück.

Jede angegebene Zahl wie Integer, Float oder Realzahlen können normalisiert werden. Es ist zu beachten das Zahlen in der Wissenschaftlichen Schreibweise, aktuell nicht von diesem Filter behandelt werden können.

Wie funktioniert diese Normalisierung also im Detail für Nummern:

// Den Filter initiieren
$filter = new Zend_Filter_LocalizedToNormalized();
$filter->filter('123.456,78');
// Gibt den Wert '123456.78' zurück

Nehmen wir an das wir das Gebietsschema 'de' als Anwendungsweites Gebietsschema gesetzt haben. Zend_Filter_LocalizedToNormalized nimmt das gesetzte Gebietsschema und verwendet es um zu erkennen welche Art der Eingabe angegeben wurde. In unserem Beispiel wurde ein Wert mit Nachkommastellen angegeben. Jetzt gibt der Filter die normalisierte Repräsentation für diesen Wert als String zurück.

Man kann auch kontrollieren wie die normalisierte Nummer auszusehen hat. Hierfür kann man alle Optionen angeben die auch von Zend_Locale_Format verwendet werden. Die üblichsten sind:

Für Details darüber, wie diese Optionen verwendet werden, sollte man in der Kapitel Zend_Locale sehen.

Anbei ist ein Beispiel welches Nachkommastellen definiert damit man sehen kann wie Optionen arbeiten:

// Nummerischer Filter
$filter = new Zend_Filter_LocalizedToNormalized(array('precision' => 2));

$filter->filter('123.456');
// Gibt den Wert '123456.00' zurück

$filter->filter('123.456,78901');
// Gibt den Wert '123456.79' zurück

Eingaben für Datum und Zeitwerte können auch normalisiert werden. Alle angegebenen Datums- und Zeitwerte werden als Array zurückgegeben, wobei jeder Teil des Datums mit einem eigenen Schlüssel angegeben wird.

// Den Filter initiieren
$filter = new Zend_Filter_LocalizedToNormalized();
$filter->filter('12.April.2009');
// Gibt array('day' => '12', 'month' => '04', 'year' => '2009') zurück

Angenommen wir haben wieder das Gebietsschema 'de' gesetzt. Die Eingaben werden jetzt automatisch als Datum erkannt und man erhält ein benanntes Array zurück.

Natürlich kann man auch kontrollieren wie die Datumseingaben auszusehen haben indem die Optionen date_format und locale verwendet werden.

// Datumsfilter
$filter = new Zend_Filter_LocalizedToNormalized(
    array('date_format' => 'ss:mm:HH')
);

$filter->filter('11:22:33');
// Gibt array('hour' => '33', 'minute' => '22', 'second' => '11') zurück

Jede angegebene Zahl wie Integer, Float oder Realzahlen können lokalisiert werden. Es ist zu beachten das Zahlen in der Wissenschaftlichen Schreibweise, aktuell nicht von diesem Filter behandelt werden können.

Wie funktioniert diese Lokalisierung also im Detail für Nummern:

// Den Filter initiieren
$filter = new Zend_Filter_NormalizedToLocalized();
$filter->filter(123456.78);
// Gibt den Wert '123.456,78' zurück

Nehmen wir an das wir das Gebietsschema 'de' als Anwendungsweites Gebietsschema gesetzt haben. Zend_Filter_NormalizedToLocalized nimmt das gesetzte Gebietsschema und verwendet es um zu erkennen welche Art der Eingabe man haben will. In unserem Beispiel wurde ein Wert mit Nachkommastellen angegeben. Jetzt gibt der Filter die lokalisierte Repräsentation für diesen Wert als String zurück.

Man kann auch kontrollieren wie die lokalisierte Nummer auszusehen hat. Hierfür kann man alle Optionen angeben die auch von Zend_Locale_Format verwendet werden. Die üblichsten sind:

Für Details darüber, wie diese Optionen verwendet werden, sollte man in der Kapitel Zend_Locale sehen.

Anbei ist ein Beispiel welches Nachkommastellen definiert damit man sehen kann wie Optionen arbeiten:

// Nummerischer Filter
$filter = new Zend_Filter_NormalizedToLocalized(array('precision' => 2));

$filter->filter(123456);
// Gibt den Wert '123.456,00' zurück

$filter->filter(123456.78901);
// Gibt den Wert '123.456,79' zurück

Normalisierte Datums- und Zeitwerte können auch lokalisiert werden. Alle angegebenen Datums- und Zeitwerte werden als String, im Format das vom gesetzten Gebietsschema definiert ist, zurückgegeben.

// Den Filter initiieren
$filter = new Zend_Filter_NormalizedToLocalized();
$filter->filter(array('day' => '12', 'month' => '04', 'year' => '2009');
// Gibt '12.04.2009' zurück

Angenommen wir haben wieder das Gebietsschema 'de' gesetzt. Die Eingaben werden jetzt automatisch als Datum erkannt und man erhält ein benanntes Array zurück.

Natürlich kann man auch kontrollieren wie die Datumseingaben auszusehen haben indem die Optionen date_format und locale verwendet werden.

// Datumsfilter
$filter = new Zend_Filter_LocalizedToNormalized(
    array('date_format' => 'ss:mm:HH')
);

$filter->filter(array('hour' => '33', 'minute' => '22', 'second' => '11'));
// Gibt '11:22:33' zurück

Standardmäßig arbeitet dieser Filter wie PHP's empty() Methode; in anderen Worten, wenn empty() ein boolsches TRUE zurückgibt, dann wird ein NULL Wert zurückgegeben.

$filter = new Zend_Filter_Null();
$value  = '';
$result = $filter->filter($value);
// Gibt null statt einem leeren String zurück

Das bedeutet das Zend_Filter_Null, ohne die Angabe irgendeiner Konfiguration, alle Eingabetypen akteptiert und in den selben Fällen NULL zurückgibt wie empty().

Jeder andere Wert ist zurückgegeben wie er ist, ohne irgendwelche Änderungen.

Manchmal ist es nicht genug basieren auf empty() zu filtern. Hierfür erlaubt es Zend_Filter_Null die Typen zu konfigurieren welche konvertiert werden und jene die nicht konvertiert werden.

Die folgenden Typen können behandelt werden:

Es gibt verschiedene Wege um zu wählen welche der obigen Typen gefiltert werden und welche nicht. Man kann einen oder mehrere Typen angeben und diese addieren, man kann ein Array angeben, man kann Konstanten verwenden, oder man kann einen textuellen String angeben. Siehe die folgenden Beispiele:

// Konvertiert false zu null
$filter = new Zend_Filter_Null(Zend_Filter_Null::BOOLEAN);

// Konvertiert false und 0 zu null
$filter = new Zend_Filter_Null(
    Zend_Filter_Null::BOOLEAN + Zend_Filter_Null::INTEGER
);

// Konvertiert false und 0 zu null
$filter = new Zend_Filter_Null( array(
    Zend_Filter_Null::BOOLEAN,
    Zend_Filter_Null::INTEGER
));

// Konvertiert false und 0 zu null
$filter = new Zend_Filter_Null(array(
    'boolean',
    'integer',
));

Man kann auch eine Instanz von Zend_Config angeben um die gewünschten Typen zu setzen. Um Typen im nachhinein zu setzen kann setType() verwendet werden.

Die folgenden Optionen werden für Zend_Filter_StringTrim unterstützt:

Ein einfaches Beispiel der Verwendung ist nachfolgend zu finden:

$filter = new Zend_Filter_StringTrim();

print $filter->filter(' Das ist (mein) Inhalt: ');

Das obige Beispiel gibe 'Das ist (mein) Inhalt:' zurück. Es sollte beachtet werden dass alle Leerzeichen entfernt wurden.

$filter = new Zend_Filter_StringTrim(':');
// oder new Zend_Filter_StringTrim(array('charlist' => ':'));

print $filter->filter(' Das ist (mein) Inhalt:');

Das obige Beispiel gibt 'Das ist (mein) Inhalt' zurück. Es sollte beachtet werden dass Leerzeichen und Doppelpunkte entfernt werden. Man kann auch eine Instanz von Zend_Config oder ein Array mit einem 'charlist' Schlüssel angeben. Un die gewünschte Liste der Zeichen nach der Instanzierung zu setzen kann die Methode setCharList() verwendet werden. getCharList() gibt die Werte zurück welche für die Zeichenliste gesetzt sind.