Zend_File_Transfer wurde designt um verschiedenste Adapter und auch Richtungen zu unterstützen. Mit Zend_File_Transfer kann man Dateien Hochladen, Herunterladen und sogar Weiterleiten (Hochladen mit einem Adapter und Herunterladen mit einem anderen Adapter zur gleichen Zeit).

Zend_File_Transfer und seine Adapter unterstützen verschiedene Optionen. Alle Optionen können gesetzt werden indem Sie entweder dem Constructor übergeben werden, oder durch Aufruf der setOptions($options). getOptions() gibt die Optionen zurück die aktuell gesetzt sind. Nachfolgend ist eine Liste aller unterstützten Optionen:

• ignoreNoFile: Wenn diese Option auf true gesetzt ist, ignorieren alle Prüfer Dateien die nicht vom Formular hochgeladen wurde. Der Standardwert ist false, was einen Fehler verursacht wenn die Datei nicht spezifiziert wurde.

Zend_File_Transfer hat verschiedene Methoden die auf verschiedenste Stati von spezifizierten Dateien prüfen. Diese sind nützlich wenn man Dateien bearbeiten will nachdem Sie empfangen wurden. Diese Methoden beinhalten:

• isValid($files = null): Diese Methode prüft ob die angegebene Datei gültig ist, basierend auf den Prüfungen welche dieser Datei angehängt sind. Wenn keine Dateien spezifiziert wurden, werden alle Dateien geprüft. Man kann isValid() aufrufen bevor receive() aufgerufen wird; in diesem Fall ruft receive() intern isValid() nicht mehr auf.

• isUploaded($files = null): Diese Methode prüft ob die spezifizierte Datei vom Benutzer hochgeladen wurde. Das ist nützlich wenn man eine oder mehrere Dateien definiert hat. Wenn keine Dateien spezifiziert wurden, werden alle Dateien geprüft.

• isReceived($files = null): Diese Methode prüft ob die spezifizierte Datei bereits empfangen wurde. Wenn keine Dateien angegeben wurden, werden alle Dateien geprüft.

$upload = new Zend_File_Transfer();

// Gibt alle bekannten internen Datei Informationen zurück
$files = $upload->getFileInfo();

foreach ($files as $file => $info) {
    // Datei hochgeladen ?
    if (!$upload->isUploaded($file)) {
        print "Warum hast Du die Datei nicht hochgeladen ?";
        continue;
    }

    // Prüfungen sind ok ?
    if (!$upload->isValid($file)) {
        print "Sorry, aber die Datei ist nicht das was wir wollten";
        continue;
    }
}

$upload->receive();

            

Zend_File_Transfer kann zusätzliche Informationen über Dateien zurückgeben. Die folgenden Methoden sind vorhanden:

• getFileName($file = null, $path = true): Diese Methode gibt den wirklichen Namen der übertragenen Datei zurück.

• getFileInfo($file = null): Diese Methode gibt die internen Informationen für die angegebene übertragene Datei zurück.

• getFileSize($file = null): Diese Methode gibt die echte dateigröße für die angegebene Datei zurück.

• getHash($hash = 'crc32', $files = null): Diese Methode gibt einen Hash des Inhalts einer angegebenen übertragenen Datei zurück.

getFileName() akzeptiert den Namen des Elements als ersten Parameter. Wenn kein Name angegeben wird, werden alle bekannten Dateinamen in einem Array zurückgegeben. Wenn die Datei eine MultiDatei ist, wird auch ein Array zurückgegeben. Wenn nur eine einzelne Datei vorhanden ist wird nur ein String zurückgegeben.

Standardmäßig werden Dateinamen mit dem kompletten Pfad zurückgegeben. Wenn man nur den Dateinamen ohne Pfad benötigt, kann der zweite Parameter $path gesetzt werden, welcher den Dateinamen ausschneidet wenn er auf false gesetzt wird.

$upload = new Zend_File_Transfer();
$upload->receive();

// Gibt die Dateinamen aller Dateien zurück
$names = $upload->getFileName();

// Gibt den Dateinamen des Formularelements 'foo' zurück
$names = $upload->getFileName('foo');

            

Hinweis: Es ist zu beachten das sich der Dateinamen ändern kann nachdem die Datei empfangen wurde (receive) weil alle Filter angewendet werden, sobald die Datei empfangen wurde. Deswegen sollte man getFileName() immer ausführen nachdem die Dateien empfangen wurden.

getFileSize() gibt standardmäßig die echte Dateigröße in SI Schreibweise zurück was bedeutet das man 2kB statt 2048 erhält. Wenn man die reine Größe benötigt muß man die useByteString Option auf false setzen.

$upload = new Zend_File_Transfer();
$upload->receive();

// Gibt die Größen aller Dateien als Array zurück wenn mehr als eine Datei hochgeladen wurde
$size = $upload->getFileSize();

// Wechsle die SI Schreibweise damit reine Nummern zurückgegeben werden
$upload->setOption(array('useByteString' => false));
$size = $upload->getFileSize();

            

getHash() akzeptiert den Namen eines Hash Algorithmus als ersten Parameter. Für eine Liste bekannter Algorithmen kann in » PHP's hash_algos Methode gesehen werden. Wenn kein Algorithmus spezifiziert wird, wird crc32 als Standardalgorithmus verwendet.

$upload = new Zend_File_Transfer();
$upload->receive();

// Gibt die Hashes von allen Dateien als Array zurück wenn mehr als eine Datei hochgeladen wurde
$hash = $upload->getHash('md5');

// Gibt den Has für das 'foo' Formularelement zurück
$names = $upload->getHash('crc32', 'foo');

            

Hinweis: Es ist zu beachten das der zurückgegebene Wert ein Array ist, wenn die Datei oder der Formularname mehr als eine Datei enthält.