# Migration von vorhergehenden Versionen

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

## Migrieren von 1.6 zu 1.7 oder neuer

### Setzen von Sprachen

Wenn man die automatische Erkennung von Sprachen verwendet, oder Sprachen manuell auf `Zend_Translate` setzt kann es sein das man von Zeit zu Zeit eine Notiz geworfen bekommen die über nicht hinzugefügte oder leere Übersetzungen schreibt. In einigen vorhergehenden Releases wurde in einigen Fällen auch eine Exception geworfen.

Der Grund ist, das wenn ein Benutzer eine nicht existierende Sprache anfragt, man einfach keinen Weg hat um festzustellen was falsch ist. Deswegen haben wir diese Notizen hinzugefügt die einem in den eigenen Logs zeigen das der Benutzer eine Sprache angefragt hat die man nicht unterstützt. Es ist zu beachten das der Code, selbst wenn eine Notiz getriggert wird, weiterhin ohne Probleme arbeitet.

Aber wenn man einen eigenen Fehler oder Exception Handler, wie XDebug, verwendet wird man alle Notizen zurückerhalten, selbst wenn man das nicht gewollt hat. Das ist der Fall, weil diese Handler alle Einstellungen von PHP selbst überschreiben.

Um diese Notizen wegzubekommen kann man einfach die neue Option 'disableNotices' auf true setzen. Der Standardwert ist false.

#### Setzen von Sprachen ohne das man Notizen erhält

Nehmen wir an das wir 'en' vorhanden haben und unser Benutzer 'fr' anfragt was nicht in unserem Portfolio der übersetzten Sprachen ist.

    $language = new Zend_Translate('gettext',
                                   '/path/to/translations',
                                   'auto');

In diesem Fall werden wir eine Notiz darüber erhalten das die Sprache 'fr' nicht vorhanden ist. Durch das einfache Hinzufügen der Option wird die Notiz abgeschaltet.

    $language = new Zend_Translate('gettext',
                                   '/path/to/translations',
                                   'auto',
                                   array('disableNotices' => true));