Prüfungen einzubinden ist sehr einfach. Es gibt verschiedene Methoden für das Hinzufügen und Manipulieren von Prüfungen:

$upload = new Zend_File_Transfer();

// Setzt eine Dateigröße von 20000 Bytes
$upload->addValidator('Size', false, 20000);

// Setzt eine Dateigröße von mindestens 20 Bytes und maximal 20000 Bytes
$upload->addValidator('Size', false, array('min' => 20, 'max' => 20000));

// Setzt eine Dateigröße von mindestens 20 Bytes und Maximal
// 20000 Bytes und eine Dateianzahl in einem Schritt
$upload->setValidators(array(
    'Size'  => array('min' => 20, 'max' => 20000),
    'Count' => array('min' => 1, 'max' => 3),
));

$upload = new Zend_File_Transfer();

// Setzt die Dateigröße auf 20000 Bytes und limitiert Sie nur auf 'file2'
$upload->addValidator('Size', false, 20000, 'file2');

Normal sollte die addValidators() Methode verwendet werden, welche mehrmals aufgerufen werden kann.

$upload = new Zend_File_Transfer();

// Setzt die Dateigröße auf 20000 Bytes
$upload->addValidator('Size', false, 20000)
       ->addValidator('Count', false, 2)
       ->addValidator('Filessize', false, 25000);

Letztendlich können Dateien einfach geprüft werden indem isValid() verwendet wird.

$upload = new Zend_File_Transfer();

// Setzt die Dateigröße auf 20000 Bytes
$upload->addValidator('Size', false, 20000)
       ->addValidator('Count', false, 2)
       ->addValidator('Filessize', false, 25000);

if (!$upload->isValid()) {
    print "Prüfung fehlgeschlagen";
}

Wenn Prüfungen fehlgeschlagen sind, ist es eine gute Idee Informationen über die gefundenen Probleme zu erhalten. Um diese Information zu erhalten können die Methoden getMessages(), welche alle Prüfmeldungen als Array zurückgibt, getErrors() welche alle Fehlercodes zurückgibt, und hasErrors() welche TRUE zurückgibt sobald ein Prüffehler gefunden wurde, verwendet werden.

Die Count Prüfung checkt die Anzahl der Dateien die angegeben wurde. Sie unterstützt die folgenden Schlüssel für Optionen:

Wenn diese Prüfung mit einem String oder Integer initiiert wird, wird Sie als max verwendet. Es können aber auch die Methoden setMin() und setMax() verwendet werden um beide Optionen im Nachhinein zu setzen und getMin() und getMax() um die aktuell gesetzten Werte zu erhalten.

$upload = new Zend_File_Transfer();

// Die Anzahl der Dateien auf maximal 2 limitieren
$upload->addValidator('Count', false, 2);

// Die Anzahl der Dateien auf maximal 5 und mindestens 1 Datei limitieren
$upload->addValidator('Count', false, array('min' =>1, 'max' => 5));

Die Crc32 Prüfung checkt den Inhalt einer übertragenen Datei durch hashen. Diese Prüfung verwendet die Hash Erweiterung von PHP mit dem Crc32 Algorithmus. Sie unterstützt die folgenden Optionen:

$upload = new Zend_File_Transfer();

// Prüft ob der Inhalt der hochgeladenen Datei den angegebenen Hash hat
$upload->addValidator('Hash', false, '3b3652f');

// Begrenzt diese Prüfung auf zwei unterschiedliche Hashes
$upload->addValidator('Crc32', false, array('3b3652f', 'e612b69'));

Die ExcludeExtension Prüfung checkt die Dateierweiterung der angegebenen Dateien. Sie unterstützt die folgenden Optionen:

Dieser Prüfer akzeptiert mehrere Erweiterungen entweder als komma-getrennten String, oder als ein Array. Man kann auch die setExtension(), addExtension() und getExtension() Methoden verwenden um Erweiterungen zu setzen und zu erhalten.

In einigen Fällen ist es nützlich auch auf Klein/Großschreibung zu testen. Deshalb erlaubt der Constructor einen zweiten Parameter $case der, wenn er auf TRUE gesetzt wird, die Erweiterungen abhängig von der Klein- oder Großschreibung prüft.

$upload = new Zend_File_Transfer();

// Dateien mit der Erweiterung php oder exe nicht erlauben
$upload->addValidator('ExcludeExtension', false, 'php,exe');

// Dateien mit der Erweiterung php oder exe nicht erlauben
// aber die Array Schreibweise verwenden
$upload->addValidator('ExcludeExtension', false, array('php', 'exe'));

// Prüft abhängig von der Groß-/Kleinschreibung
$upload->addValidator('ExcludeExtension',
                      false,
                      array('php', 'exe', 'case' => true));

Die ExcludeMimeType Prüfung checkt den MIME Typ von übertragenen Dateien. Sie unterstützt die folgenden Optionen:

Diese Prüfung akzeptiert viele MIME Typ entweder als Komma-getrennter String, oder als Array. Man kan auch die Methoden setMimeType(), addMimeType(), und getMimeType() verwenden um MIME Typen zu setzen und zu erhalten.

$upload = new Zend_File_Transfer();

// Verweigert den MIME Typ gif für alle gegebenen Dateien
$upload->addValidator('ExcludeMimeType', 'image/gif');

// Verweigert den MIME Typ gif und jpeg für alle gegebenen Dateien
$upload->setValidator('ExcludeMimeType', array('image/gif',
                                               'image/jpeg');

// Verweigert die MIME Typ Gruppe image für alle Dateien
$upload->setValidator('ExcludeMimeType', 'image');

Das obige Beispiel zeigt das es auch möglich ist Gruppen von MIME Typen zu verweigern. Um, zum Beispiel, alle Bilder zu verweigern, muß nur 'image' als MIME Typ verwendet werden. Das kann für alle Gruppen von MIME Typen wie 'image', 'audio', 'video', 'test', und so weiter verwendet werden.

Die Exists Prüfung checkt ob Dateien die spezifiziert werden existieren. Sie unterstützt die folgenden Optionen:

Diese Prüfung akzeptiert mehrere Verzeichnisse, entweder als Komma-getrennter String, oder als Array. Es können aber auch die Methoden setDirectory(), addDirectory(), und getDirectory() verwendet werden um die Verzeichnisse zu setzen und zu erhalten.

$upload = new Zend_File_Transfer();

// Das temporäre Verzeichnis für die Prüfung hinzufügen
$upload->addValidator('Exists', false, '\temp');

// Zwei Verzeichnisse hinzufügen indem die Array Schreibweise verwendet wird
$upload->addValidator('Exists',
                      false,
                      array('\home\images', '\home\uploads'));

Die Extension Prüfung checkt die Dateierweiterung der angegebenen Dateien. Sie unterstützt die folgenden Optionen:

Dieser Prüfer akzeptiert mehrere Erweiterungen entweder als komma-getrennten String, oder als ein Array. Man kann auch die setExtension(), addExtension() und getExtension() Methoden verwenden um Erweiterungs Werte zu setzen und zu erhalten.

In einigen Fällen ist es nützlich auch auf Klein/Großschreibung zu testen. Hierfür nimmt der Constructor einen zweiten Parameter $case der, wenn er auf TRUE gesetzt wird, die Erweiterungen abhängig von der Klein- oder Großschreibung prüft.

$upload = new Zend_File_Transfer();

// Limitiert die Erweiterungen auf jpg und png Dateien
$upload->addValidator('Extension', false, 'jpg,png');

// Limitiert die Erweiterungen auf jpg und png Dateien,
// verwendet aber die Array Schreibweise
$upload->addValidator('Extension', false, array('jpg', 'png'));

// Abhängig von der Klein/Großschreibung prüfen
$upload->addValidator('Extension', false, array('mo', 'png', 'case' => true));
if (!$upload->isValid('C:\temp\myfile.MO')) {
    print 'Nicht gültig da MO und mo Kleinschreibungsmäßig nicht passen';
}

Die FilesSize Prüfung checkt die komplette Größe aller übertragenen Dateien. Sie unterstützt die folgenden Optionen:

Diese Prüfung kann auch mit einem String initiiert werden, der dann verwendet wird um die max Option zu setzen. Man kann auch die Methoden setMin() und setMax() verwenden um beide Optionen nach den Contrucor zu setzen, zusammen mit getMin() und getMax() um die Werte zu erhalten die vorher gesetzt wurden.

Die Größe selbst wird auch in der SI Schreibweise akzeptiert wie Sie die meisten Betriebsystemen verwenden. Statt 20000 bytes kann auch 20kB angeben werden. Alle Einheiten werden mit dem Basiswert 1024 konvertiert. Die folgenden Einheiten werden akzeptiert: kB, MB, GB, TB, PB und EB. Beachte das 1kB gleich 1024 Bytes ist, 1MB gleich 1024kB, und so weiter.

$upload = new Zend_File_Transfer();

// Limitiert die Größe aller Dateien die hochgeladen werden auf 40000 Bytes
$upload->addValidator('FilesSize', false, 40000);

// Limitiert die Größe aller Dateien die hochgeladen
// werden auf maximal 4MB und minimal 10kB
$upload->addValidator('FilesSize',
                      false,
                      array('min' => '10kB', 'max' => '4MB'));

// Wie zuvor, gibt aber die reine Dateigröße
// statt einem benutzerfreundlichen String zurück
$upload->addValidator('FilesSize',
                      false,
                      array('min' => '10kB',
                            'max' => '4MB',
                            'bytestring' => false));

Die ImageSize Prüfung checkt die Größe von Bildern. Sie unterstützt die folgenden Optionen:

Die Methoden setImageMin() und setImageMax() setzen auch beide Minimal- und Maximalwerte im Nachhinein, während die getMin() und getMax() Methoden die aktuell gesetzten Werte zurückgeben.

Der Bequemlichkeit halber gibt es auch eine setImageWidth() und setImageHeight() Methode welche die Mindest- und Maximalhöhe und -Breite der Bilddatei setzen. Sie haben auch passende getImageWidth() und getImageHeight() Methoden um die aktuell gesetzten Werte zu erhalten.

Um die Prüfung einer betreffenden Dimension zu gestatten, muß die relevante Option einfach nicht gesetzt werden.

$upload = new Zend_File_Transfer();

// Begrenzt die Größe eines Bildes auf eine Höhe von 100-200
// und eine Breite von 40-80 Pixel
$upload->addValidator('ImageSize', false,
                      array('minwidth' => 40,
                            'maxwidth' => 80,
                            'minheight' => 100,
                            'maxheight' => 200
                     );

// Setzt die Breite der Prüfung zurück
$upload->setImageWidth(array('minwidth' => 20, 'maxwidth' => 200));

Die IsCompressed Prüfung checkt ob eine übertragene Datei komprimiert ist wie zum Beispiel Zip oder Arc. Diese Prüfung basiert auf der MimeType Prüfung und unterstützt die gleichen Methoden und Optionen. Diese Prüfung kann mit den dort beschriebenen Methoden auf gewünschte Komprimierungstypen limitiert werden.

$upload = new Zend_File_Transfer();

// Checkt ob die hochgeladene Datei komprimiert ist
$upload->addValidator('IsCompressed', false);

// Limitiert diese Prüfung auf Zip Dateien
$upload->addValidator('IsCompressed', false, array('application/zip'));

// Limitiert diese Prüfung auf Zip Dateien,
// und verwendet eine einfachere Schreibweise
$upload->addValidator('IsCompressed', false, 'zip');

Die IsImage Prüfung checkt ob eine übertragene Datei eine Bilddatei ist, wie zum Beispiel Gif oder Jpeg. Diese Prüfung basiert auf der MimeType Prüfung und unterstützt die gleichen Methoden und Optionen. Diese Prüfung kann mit den dort beschriebenen Methoden auf gewünschte Bildarten limitiert werden.

$upload = new Zend_File_Transfer();

// Checkt ob die hochgeladene Datei ein Bild ist
$upload->addValidator('IsImage', false);

// Limitiert diese Prüfung auf Gif Dateien
$upload->addValidator('IsImage', false, array('application/gif'));

// Limitiert diese Prüfung auf Jpeg Dateien,
// verwendet eine einfachere Schreibweise
$upload->addValidator('IsImage', false, 'jpeg');

Die Hash Prüfung checkt den Inhalt einer übertragenen Datei indem Sie gehasht wird. Diese Prüfung verwendet die Hash Erweiterung von PHP. Sie unterstützt die folgenden Optionen:

$upload = new Zend_File_Transfer();

// Prüft ob der Inhalt der hochgeladenen Datei den angegebenen Hash enthält
$upload->addValidator('Hash', false, '3b3652f');

// Begrenzt diese Prüfung auf zwei unterschiedliche Hashes
$upload->addValidator('Hash', false, array('3b3652f', 'e612b69'));

// Setzt einen anderen Algorithmus gegen den geprüft wird
$upload->addValidator('Hash',
                      false,
                      array('315b3cd8273d44912a7',
                            'algorithm' => 'md5'));

Die Md5 Prüfung checkt den Inhalt einer übertragenen Datei durch hashen. Diese Prüfung verwendet die Hash Erweiterung von PHP mit dem Md5 Algorithmus. Sie unterstützt die folgenden Optionen:

$upload = new Zend_File_Transfer();

// Prüft ob der Inhalt der hochgeladenen Datei den angegebenen Hash hat
$upload->addValidator('Md5', false, '3b3652f336522365223');

// Begrenzt diese Prüfung auf zwei unterschiedliche Hashes
$upload->addValidator('Md5',
                      false,
                      array('3b3652f336522365223',
                            'eb3365f3365ddc65365'));

Die MimeType Prüfung checkt den MIME Typ von übertragenen Dateien. Sie unterstützt die folgenden Optionen:

Diese Prüfung akzeptiert viele MIME Typen entweder als Komma-getrennter String, oder als Array. Man kan auch die Methoden setMimeType(), addMimeType(), und getMimeType() verwenden um MIME Typen zu setzen und zu erhalten.

Man kann mit der 'magicfile' Option auch die Magicdatei setzen die von Fileinfo verwendet werden soll. Zusätzlich gibt es die komfortablen setMagicFile() und getMagicFile() Methoden die das spätere Setzen und Empfangen des Magicfile Parameters erlauben. Diese Methoden sind seit dem Zend Framework 1.7.1 vorhanden.

$upload = new Zend_File_Transfer();

// Begrenzt den MIME Typ aller gegebenen Dateien auf Gif Bilder
$upload->addValidator('MimeType', 'image/gif');

// Begrenzt den MIME Typ alle gegebenen Dateien auf Gif und Jpeg Dateien
$upload->addValidator('MimeType', array('image/gif', 'image/jpeg');

// Begrenzt den MIME Typ aller Dateien auf die Gruppe image
$upload->addValidator('MimeType', 'image');

// Ein anderes magicfile verwenden
$upload->addValidator('MimeType',
                      false,
                      array('image',
                            'magicfile' => '/path/to/magicfile.mgx'));

Das obige Beispiel zeigt das es auch möglich ist den akzeptierten MIME Typ auf eine Gruppe von MIME Typen zu begrenzen. Um alle Bilder zu erlauben kann einfach 'image' als MIME Typ verwendet werden. Das kann für alle Gruppen von MIME Typen wie 'image', 'audio', 'video', 'test', und so weiter gemacht werden.

Die NotExists Prüfung checkt ob Dateien die angegeben werden existieren. Sie unterstützt die folgenden Optionen:

Diese Prüfung akzeptiert mehrere Verzeichnisse, entweder als Komma-getrennter String, oder als Array. Es können aber auch die Methoden setDirectory(), addDirectory(), und getDirectory() verwendet werden um die Verzeichnisse zu setzen und zu erhalten.

$upload = new Zend_File_Transfer();

// Das temporäre Verzeichnis für die Prüfung hinzufügen
$upload->addValidator('NotExists', '\temp');

// Zwei Verzeichnisse durch Verwendung der Array Schreibweise hinzufügen
$upload->addValidator('NotExists',
                      array('\home\images',
                            '\home\uploads')
                     );

Die Sha1 Prüfung checkt den Inhalt einer übertragenen Datei durch hashen. Diese Prüfung verwendet die Hash Erweiterung von PHP mit dem Sha1 Algorithmus. Sie unterstützt die folgenden Optionen:

$upload = new Zend_File_Transfer();

// Prüft ob der Inhalt der hochgeladenen Datei den angegebenen Hash hat
$upload->addValidator('Sha1', false, '3b3652f336522365223');

// Begrenzt diese Prüfung auf zwei unterschiedliche Hashes
$upload->addValidator('Sha1',
                      false, array('3b3652f336522365223',
                                   'eb3365f3365ddc65365'));

Die Size Prüfung checkt die Größe von einzelnen Dateien. Sie unterstützt die folgenden Optionen:

Man kann diese Prüfung auch nur mit einem String initialisieren, der dann verwendet wird um die max Option zu setzen. Man kann auch die Methoden setMin() und setMax() verwenden um beide Optionen nach der Instanziierung setzen, zusammen mit getMin() und getMax() um die Werte zu setzen die vorher gesetzt wurden.

Die Größe selbst wird auch in der SI Schreibweise akzeptiert wie Sie von den meisten Betriebsystemen verwendet wird. Statt 20000 bytes kann man auch 20kB angeben. Alle Einheiten werden konvertiert wobei 1024 als Basiswert verwendet wird. Die folgenden Einheiten werden akzeptiert: kB, MB, GB, TB, PB und EB. Beachte das 1kB identisch mit 1024 Bytes ist, 1MB identisch mit 1024kB ist, und so weiter.

$upload = new Zend_File_Transfer();

// Limitiert die Größe einer Datei auf 40000 Bytes
$upload->addValidator('Size', false, 40000);

// Limitiert die Größe der angegebenen Datei auf maximal 4MB und  minimal 10kB
// Gibt auch im Fall eines Fehlers die reine Zahl statt einer
// Benutzerfreundlichen zurück
$upload->addValidator('Size',
                      false,
                      array('min' => '10kB',
                            'max' => '4MB',
                            'bytestring' => false));

Die WordCount Prüfung checkt die Anzahl von Wörtern in angegebenen Dateien. Sie Unterstützt die folgenden Optionen:

Wenn man diese Prüfung mit einem String oder Integer initiiert, wird der Wert als max verwendet. Oder man verwendet die setMin() und setMax() Methoden um beide Optionen im Nachhinein zu Setzen und getMin() sowie getMax() um die aktuell gesetzten Werte zu erhalten.

$upload = new Zend_File_Transfer();

// Begrenzt die Anzahl der Wörter in Dateien auf maximal 2000
$upload->addValidator('WordCount', false, 2000);

// Begrenzt die Anzahl der Wörter in Dateien auf maximal 5000
// und mindestens 1000 Wörter
$upload->addValidator('WordCount', false, array('min' => 1000, 'max' => 5000));