# Migration von vorhergehenden Versionen

Die API von `Zend_File_Transfer` wurde von Zeit zu Zeit verändert. Wenn man bereits angefangen hat `Zend_File_Transfer` und dessen Subkomponenten in vorhergehenden Versionen zu verwenden sollte man den anbei beschriebenen Richtlinien folgen um eigene Skripts auf die neue API zu migrieren.

## Migration von 1.9 zu 1.10 oder neuer

### MimeType Prüfung

Aus Sicherheitsgründen haben wir den standardmäßigen Fallback Mechanismus der `MimeType`, `ExcludeMimeType`, `IsCompressed` und `IsImage` Prüfungen ausgeschaltet. Das bedeutet, wenn die fileInfo oder magicMime Erweiterungen nicht gefunden werden können, dann wird die Prüfung immer fehlschlagen.

Wenn es notwendig ist das man für die Prüfung die HTTP Felder verwendet welche vom Benutzer geschickt werden, dann kann man dieses Feature einschalten indem die `enableHeaderCheck()` Methode verwendet wird.

#### Sicherheits Hinweis

Man sollte beachten, das wenn man sich auf die HTTP Felder verlässt, die vom Benutzer geschickt werden, das ein Sicherheits Risiko ist. Diese können einfach geändert werden und könnten es einem Benutzer erlauben eine schädliche Datei zu schicken.

#### Die Verwendung der HTTP Felder erlauben

    // Bei der Initiierung
    $valid = new Zend_File_Transfer_Adapter_Http(array('headerCheck' => true);

    // oder im Nachhinein
    $valid->enableHeaderCheck();

## Migration von 1.6 zu 1.7 oder neuer

### Änderungen bei der Verwendung von Filtern und Prüfungen

Wie von Benutzern erwähnt, arbeiteten die Prüfungen von `Zend_File_Transfer` nicht in Verbindung mit `Zend_Config` zusammen, durch den Fakt das Sie keine benannten Arrays verwendet haben.

Deswegen wurden alle Filter und Prüfungen für `Zend_File_Transfer` überarbeitet. Wärend die alten Signaturen weiterhin funktionieren, wurden sie als veraltet markiert, und werfen eine PHP Notiz mit der Aufforderung das zu beheben.

Die folgende Liste zeigt die Änderungen und was für die richtige Verwendung der Parameter getan werden muß.

#### Filter: Rename

- Alte API der Methode: `Zend_Filter_File_Rename($oldfile, $newfile, $overwrite)`

- Neue API der Methode: `Zend_Filter_File_Rename($options)` wobei $options die folgenden Schlüssel für das Array akzeptiert: source identisch mit $oldfile, target identisch mit $newfile, overwrite identisch mit $overwrite

##### Änderungen für den Rename Filter von 1.6 zu 1.7

    // Beispiel für 1.6
    $upload = new Zend_File_Transfer_Adapter_Http();
    $upload->addFilter('Rename',
                       array('/path/to/oldfile', '/path/to/newfile', true));

    // Gleiches Beispiel für 1.7
    $upload = new Zend_File_Transfer_Adapter_Http();
    $upload->addFilter('Rename',
                       array('source' => '/path/to/oldfile',
                             'target' => '/path/to/newfile',
                             'overwrite' => true));

#### Prüfung: Count

- Alte API der Methode: `Zend_Validate_File_Count($min, $max)`

- Neue API der Methode: `Zend_Validate_File_Count($options)` wobei $options die folgenden Schlüssel für das Array akzeptiert: min identisch mit $min, max identisch mit $max,

##### Änderungen für die Count Prüfung von 1.6 zu 1.7

    // Beispiel für 1.6
    $upload = new Zend_File_Transfer_Adapter_Http();
    $upload->addValidator('Count',
                          array(2, 3));

    // Gleiches Beispiel für 1.7
    $upload = new Zend_File_Transfer_Adapter_Http();
    $upload->addValidator('Count',
                          false,
                          array('min' => 2,
                                'max' => 3));

#### Prüfung: Extension

- Alte API der Methode: `Zend_Validate_File_Extension($extension, $case)`

- Neue API der Methode: `Zend_Validate_File_Extension($options)` wobei $options die folgenden Schlüssel für das Array akzeptiert: * identisch mit $extension und kann jeden anderen Schlüssel haben case identisch mit $case,

##### Änderungen für die Extension Prüfung von 1.6 zu 1.7

    // Beispiel für 1.6
    $upload = new Zend_File_Transfer_Adapter_Http();
    $upload->addValidator('Extension',
                          array('jpg,gif,bmp', true));

    // Gleiches Beispiel für 1.7
    $upload = new Zend_File_Transfer_Adapter_Http();
    $upload->addValidator('Extension',
                          false,
                          array('extension1' => 'jpg,gif,bmp',
                                'case' => true));

#### Prüfung: FilesSize

- Alte API der Methode: `Zend_Validate_File_FilesSize($min, $max, $bytestring)`

- Neue API der Methode: `Zend_Validate_File_FilesSize($options)` wobei $options die folgenden Schlüssel für das Array akzeptiert: min identisch mit $min, max identisch mit $max, bytestring identisch mit $bytestring

Zustätzlich wurde die Signatur der `useByteString()` Methode geändert. Sie kann nur verwendet werden um zu testen ob die Prüfung ByteStrings in den erzeugten Meldungen verwendet oder ncht. Um den Wert dieses Flags zu setzen muß die `setUseByteString()` Methode verwendet werden.

##### Änderungen für die FilesSize Prüfung von 1.6 zu 1.7

    // Beispiel für 1.6
    $upload = new Zend_File_Transfer_Adapter_Http();
    $upload->addValidator('FilesSize',
                          array(100, 10000, true));

    // Gleiches Beispiel für 1.7
    $upload = new Zend_File_Transfer_Adapter_Http();
    $upload->addValidator('FilesSize',
                          false,
                          array('min' => 100,
                                'max' => 10000,
                                'bytestring' => true));

    // Beispiel für 1.6
    $upload->useByteString(true); // Flag setzen

    // Gleiches Beispiel für 1.7
    $upload->setUseByteSting(true); // Flag setzen

#### Prüfung: Hash

- Alte API der Methode: `Zend_Validate_File_Hash($hash, $algorithm)`

- Neue API der Methode: `Zend_Validate_File_Hash($options)` wobei $options die folgenden Schlüssel für das Array akzeptiert: * identisch mit $hash und kann jeden anderen Schlüssel haben algorithm identisch mit $algorithm,

##### Änderungen für die Hash Prüfung von 1.6 zu 1.7

    // Beispiel für 1.6
    $upload = new Zend_File_Transfer_Adapter_Http();
    $upload->addValidator('Hash',
                          array('12345', 'md5'));

    // Gleiches Beispiel für 1.7
    $upload = new Zend_File_Transfer_Adapter_Http();
    $upload->addValidator('Hash',
                          false,
                          array('hash1' => '12345',
                                'algorithm' => 'md5'));

#### Prüfung: ImageSize

- Alte API der Methode: `Zend_Validate_File_ImageSize($minwidth, $minheight, $maxwidth, $maxheight)`

- Neue API der Methode: `Zend_Validate_File_FilesSize($options)` wobei $options die folgenden Schlüssel für das Array akzeptiert: minwidth identisch mit $minwidth, maxwidth identisch mit $maxwidth, minheight identisch mit $minheight, maxheight identisch mit $maxheight,

##### Änderungen für die ImageSize Prüfung von 1.6 zu 1.7

    // Beispiel für 1.6
    $upload = new Zend_File_Transfer_Adapter_Http();
    $upload->addValidator('ImageSize',
                          array(10, 10, 100, 100));

    // Gleiches Beispiel für 1.7
    $upload = new Zend_File_Transfer_Adapter_Http();
    $upload->addValidator('ImageSize',
                          false,
                          array('minwidth' => 10,
                                'minheight' => 10,
                                'maxwidth' => 100,
                                'maxheight' => 100));

#### Prüfung: Size

- Alte API der Methode: `Zend_Validate_File_Size($min, $max, $bytestring)`

- Neue API der Methode: `Zend_Validate_File_Size($options)` wobei $options die folgenden Schlüssel für das Array akzeptiert: min identisch mit $min, max identisch mit $max, bytestring identisch mit $bytestring

##### Änderungen für die Size Prüfung von 1.6 zu 1.7

    // Beispiel für 1.6
    $upload = new Zend_File_Transfer_Adapter_Http();
    $upload->addValidator('Size',
                          array(100, 10000, true));

    // Gleiches Beispiel für 1.7
    $upload = new Zend_File_Transfer_Adapter_Http();
    $upload->addValidator('Size',
                          false,
                          array('min' => 100,
                                'max' => 10000,
                                'bytestring' => true));

## Migration von 1.6.1 zu 1.6.2 oder neuer

### Änderungen bei der Verwendung von Prüfungen

Wie von Benutzern festgestellt wurde, haben die Prüfungen von `Zend_File_Transfer` nicht auf die gleiche Art und Weise funktioniert wie standardmäßigen von `Zend_Form`. `Zend_Form` erlaubt die Verwendung eines `$breakChainOnFailure` Parameters der die Prüfung für alle weitere Prüfer unterbricht wenn ein Prüffehler aufgetreten ist.

Deshalb wurde dieser Parameter bei allen bestehenden Prüfungen von `Zend_File_Transfer` hinzugefügt.

- Alte API der Methode: `addValidator($validator, $options, $files)`.

- Neue API der Methode: `addValidator($validator, $breakChainOnFailure, $options, $files)`.

Um also eigene Skripte auf die neue API zu migrieren, muß einfach ein `FALSE` nach der Definition der gewünschten Prüfung hinzugefügt werden.

#### Wie man eigene Dateiprüfungen von 1.6.1 auf 1.6.2 ändert

    // Beispiel für 1.6.1
    $upload = new Zend_File_Transfer_Adapter_Http();
    $upload->addValidator('FilesSize', array('1B', '100kB'));

    // Selbes Beispiel für 1.6.2 und neuer
    // Beachte das hinzugefügte boolsche false
    $upload = new Zend_File_Transfer_Adapter_Http();
    $upload->addValidator('FilesSize', false, array('1B', '100kB'));