Zend Framework 1.7.9 Manual

Die Verwendung von Filtern ist sehr einfach. Es gibt verschiedene Methoden für das Hinzufügen und Manipulieren von Filtern.

• addFilter($filter, $options = null, $files = null): Fügt den angegebenen Filter zu den Filterstapel hinzu (optional nur zu den Datei(en) die spezifiziert wurden). $filter kann entweder eine aktuelle Filterinstanz sein, oder ein Kurzname der den Filtertyp spezifiziert (z.B. 'Rename').

• addFilters(array $filters, $files = null): Fügt die angegebenen Filter zum Filterstapel hinzu. Jeder Eintrag kann entweder ein Filtertyp/-options Paar sein, oder ein Array mit dem Schlüssel 'filter' das den Filter spezifiziert (alle anderen Optionen werden als Optionen für die Instanzierung der Filter angenommen).

• setFilters(array $filters, $files = null): Überschreibt alle bestehenden Filter mit den spezifizierten Filtern. Die Filter sollten der Syntax folgen die für addFilters() definiert ist.

• hasFilter($name): Zeigt ob ein Filter registriert wurde.

• getFilter($name): Gibt einen vorher registrierten Filter zurück.

• getFilters($files = null): Gibt registrierte Filter zurück; wenn $files übergeben wurde, werden die Filter für die betreffende Datei oder das Set an Dateien zurückgegeben.

• removeFilter($name): Entfernt einen vorher registrierten Filter.

• clearFilters(): Löscht alle registrierten Filter.

$upload = new Zend_File_Transfer();

// Setzt einen neuen Zielpfad
$upload->addFilter('Rename', 'C:\picture\uploads');

// Setzt einen neuen Zielpfad und überschreibt bestehende Dateien
$upload->addFilter('Rename', array('target' => 'C:\picture\uploads', 'overwrite' => true));

$upload = new Zend_File_Transfer();

// Setzt einen neuen Zielpfad und begrenzt Ihn auf 'file2'
$upload->addFilter('Rename', 'C:\picture\uploads', 'file2');

Generell sollte einfach die addFilters() Methode verwendet werden, welche mehrmals aufgerufen werden kann.

$upload = new Zend_File_Transfer();

// Setzt mehrere Rename Filter
$upload->addFilter('Rename', 'C:\picture\newjpg', 'file1')
       ->addFilter('Rename', 'C:\picture\newgif', 'file2');

Note:

Es ist zu beachten das, auch wenn das mehrfache Setzen des gleichen Filters erlaubt ist, das zu Problemen führen kann wenn verschiedene Optionen für den gleichen Filter verwendet werden.

Der LowerCase Filter erlaubt es den Inhalt einer Datei auf Kleinschreibung zu ändern. Dieser Filter sollte nur mit Textdateien verwendet werden.

Bei der Initialisierung kann ein String angegeben werden welcher dann als Kodierung verwendet wird. Oder man kann die setEncoding() Methode verwenden um Sie im Nachhinein zu setzen.

$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('MimeType', 'text');

// Fügt einen Filter hinzu der hochgeladene Textdateien auf Kleinschreibung ändert
$upload->addFilter('LowerCase');

// Fügt einen Filter hinzu um die hochgeladene Datei auf Kleinschreibung zu ändern aber nur für uploadfile1
$upload->addFilter('LowerCase', null, 'uploadfile1');

// Fügt einen Filter für die Kleinschreibung hinzu wobei die Kodierung auf ISO-8859-1 gesetzt wird
$upload->addFilter('LowerCase', 'ISO-8859-1');

Note:

Da die Optionen für den LowerCase Filter optional sind muß man darauf achten das man als zweiten Parameter eine null (die Optionen) geben muß wenn man Ihn auf ein einzelnes Dateielement einschränken will.

Der Rename Filter erlaubt es das Ziel des Uploads zu Ändern, den Dateinamen sowie bereits bestehende Dateien zu überschreiben. Er unterstützt die folgenden Optionen:

• source: Der Name und das Ziel der alten Datei welche umbenannt werden soll.

• target: Das neue Verzeichnis, oder der Dateiname der Datei.

• overwrite: Definiert ob die alte Datei von der neuen überschrieben wird wenn diese bereits existiert. Der Standardwert ist false.

Zusätzlich kann die setFile() Methode verwendet werden um Dateien zu setzen, sie überschreibt alle vorher gesetzten Dateien, addFile() um eine neue Datei zu bereits bestehenden zu setzen, und getFile() um alle aktuell gesetzten Dateien zu erhalten. Um die Dinge zu vereinfachen, versteht dieser Filter verschiedene Schreibweisen und seine Methoden und der Contructor verstehen die gleichen Schreibweisen.

$upload = new Zend_File_Transfer_Adapter_Http();

// Setzt einen neuen Zielpfad für alle Dateien
$upload->addFilter('Rename', 'C:\mypics\new');

// Setzt einen neuen Zielpfad nur für uploadfile1
$upload->addFilter('Rename', 'C:\mypics\newgifs', 'uploadfile1');

Man kann verschiedene Schreibweisen verwenden. Anbei ist eine Tabelle in der eine Beschreibung und der Hintergrund für die verschiedenen unterstützten Schreibweisen zu finden ist. Es ist zu beachten das, wenn man den Adapter oder das Form Element verwendet, man nicht alle beschriebenen Schreibweisen verwenden kann.

Der UpperCase Filter erlaubt es den Inhalt einer Datei auf Großschreibung zu ändern. Dieser Filter sollte nur mit Textdateien verwendet werden.

Bei der Initialisierung kann ein String angegeben werden welcher dann als Kodierung verwendet wird. Oder man kann die setEncoding() Methode verwenden um Sie im Nachhinein zu setzen.

$upload = new Zend_File_Transfer_Adapter_Http();
$upload->addValidator('MimeType', 'text');

// Fügt einen Filter hinzu um die hochgeladene Textdatei auf Großschreibung zu ändern
$upload->addFilter('UpperCase');

// Fügt einen Filter hinzu um die hochgeladene Datei auf Großschreibung zu ändern aber nur für uploadfile1
$upload->addFilter('UpperCase', null, 'uploadfile1');

// Fügt einen Filter für die Großschreibung hinzu wobei die Kodierung auf ISO-8859-1 gesetzt wird
$upload->addFilter('UpperCase', 'ISO-8859-1');

Note:

Da die Optionen für den UpperCase Filter optional sind muß man darauf achten das man als zweiten Parameter eine null (die Optionen) geben muß wenn man Ihn auf ein einzelnes Dateielement einschränken will.