# Migrer à partir des versions précédentes

L'API de `Zend_Translate` a changé au cours du temps. Si vous avez commencé à utiliser `Zend_Translate` et ses sous-composants avec les versions précédentes, suivez les lignes directrices ci-dessous pour migrer vos scripts et ainsi utiliser la nouvelle API.

## Migrer de la version 1.6 vers 1.7 ou plus récent

### Paramétrer les langues

Lors de l'utilisation de la détection automatique des langues, ou du réglage manuel des langues de `Zend_Translate`, vous avez peut-être remarqué que de temps en temps une notice est envoyée concernant le non-ajout de traductions vides. Dans certaines versions précédentes, une exception était levée dans certains cas.

Ceci intervient quand un utilisateur requête une langue non existante, vous n'avez alors aucun moyen simple de détecter ce qui ne va pas. Nous avons donc ajouté ces notices qui apparaîtront dans votre historisation et qui vous diront qu'un utilisateur a requêté une langue que vous ne supportez pas. Notez bien que votre code, même si une notice est déclenchée, fonctionnera sans problèmes.

Mais quand vous utilisez votre propre gestionnaire d'erreur ou d'exception, comme xDebug, toutes les notices vous seront retournées, même si ce n'est pas votre intention initiale. Ceci est du au fait, que ces gestionnaires surchargent tous les réglages internes de PHP.

Pour vous affranchir de ces notices, vous pouvez simplement paramétrer la nouvelle option `disableNotices` à `TRUE`, sa valeur par défaut étant `FALSE`.

#### Paramétrer les langues sans avoir de notices

Assumons que "`fr`" soit disponible et qu'un utilisateur requête pour "`de`" qui ne fait pas partie de votre portefeuille de traductions.

    $language = new Zend_Translate('gettext',
                                   '/chemin/vers/les/traductions',
                                   'auto');

Dans ce cas nous aurons une notice indiquant la non-disponibilité de la langue "`de`". Ajoutez simplement l'option et les notices seront désactivées.

    $language = new Zend_Translate('gettext',
                                   '/chemin/vers/les/traductions',
                                   'auto',
                                   array('disableNotices' => true));