ZF Zend Framework

Zend_File_Transfer wurde erstellt um verschiedene Adapter und auch Richtungen zu unterstützen. Es wurde designt um das Hochladen, Herunterladen und sogar das Weiterleiten (Hochladen mit einem Adapter und Herunterladen mit einem anderen Adapter zur gleichen Zeit) von Dateien zu erlauben. Aber mit Zend Framework 1.6 ist aktuell nur ein Adapter vorhanden, der Http Adapter.

Weil aktuell nur ein Adapter vorhanden ist, kann die Basisklasse aktuell noch nicht verwendet werden. Deshalb muß man, wenn man Zend_File_Transfer verwenden will, den Adapter direkt verwenden.

Zend_File_Transfer und dessen Adapter unterstützen verschiedene Optionen. Alle Optionen können gesetzt werden indem Sie entweder dem Constructor übergeben werden, oder durch Verwendung von setOptions($options). getOptions() gibt die aktuell gesetzten Optionen zurück. Anbei ist eine Liste aller unterstützten Optionen zu finden.

Zend_File_Transfer hat verschiedene Methoden die auf verschiedenste Annahmen prüfen welche nützlich sind wenn man Dateien bearbeiten will nachdem Sie empfangen wurden.

$upload = new Zend_File_Transfer();

// Gibt alle bekannten internen Dateiinformationen 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 verschiedene zusätzliche Informationen über Dateien zurückgeben. Die folgenden Methoden sind vorhanden:

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 Ihrem 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');

	Anmerkung
	Es ist zu beachten das sich der Dateinamen ändern kann wenn man die Datei empfängt (receive). Das kann geschehen durch den Fakt das beim Empfangen alle Filter ausgeführt werden. Deswegen sollte man getFileName() immer ausführen nachdem man die Dateien empfangen hat.

getHash() akzeptiert den Namen eines Hash Algorithmus als ersten Parameter. Für eine Liste von bekannten Algorithmen kann in PHP's hash_algos Methode gesehen werden. Wenn kein Algorithmus angegeben 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');

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