Der nächste Schritt besteht in der Erstellung der Übersetzungsdateien für die verschiedenen Sprachen welche übersetzt werden sollen. Jeder Adapter wird auf seine eigene Weise, wie hier beschrieben, erstellt aber es gibt ein paar generelle Features die für alle Adapter relevant sind.

Zuerst muß entschieden werden wo die Übersetzung Dateien zu speichern sind. Bei der Verwendung von Zend_Translate gibt es keinerlei Einschränkungen. Aber die folgenden Strukturen bevorzugt verwendet werden:

• Einzeln strukturierte Quellen

  /application/
  /languages/
  /languages/lang.en
  /languages/lang.de
  /library/
  

  Positiv: Alle Quell Dateien, für jede Sprache, werden in einem einzelnen Verzeichnis gespeichert. Keine Aufteilung der betreffenden Dateien.

• Sprachlich stukturierte Quellen

  /application/
  /languages/
  /languages/en/
  /languages/en/first.en
  /languages/en/second.en
  /languages/de/
  /languages/de/first.de
  /languages/de/second.de
  /library/
  

  Positiv: Jede Sprache wird in Ihrem eigenen Verzeichnis gespeichert. Einfache Übersetzung, da jedes Übersetzungsteam nur ein einzelnes Verzeichnis zu übersetzen hat. Und die Verwendung Verwendung von mehreren Dateien genauso transparent.

• Applikations strukturierte Quellen

  /application/
  /application/languages/
  /application/languages/first.en
  /application/languages/first.de
  /application/languages/second.en
  /application/languages/second.de
  /library/
  

  Positiv: Alle Quelldateien, für jede Sprache, werden in einem einzelnen Verzeichnis gespeichert. Keine Aufteilung der betreffenden Dateien.

  Negativ: Die Benutzung von mehreren Datein für die selbe Sprache kann problematisch sein.

• Gettext strukturierte Quellen

  /application/
  /languages/
  /languages/de/
  /languages/de/LC_MESSAGES/
  /languages/de/LC_MESSAGES/first.mo
  /languages/de/LC_MESSAGES/second.mo
  /languages/en/
  /languages/en/LC_MESSAGES/
  /languages/en/LC_MESSAGES/first.mo
  /languages/en/LC_MESSAGES/second.mo
  /library/
  

  Positiv: Bestehende Gettext Quellen können, ohne Veränderung der Struktur, benutzt werden.

  Negativ: Die Benutzung von Sub-Sub Verzeichnissen ist für Personen, die Gettext noch nie benutzt haben, verwirrend.

• Datei strukturierte Quellen

  /application/
  /application/models/
  /application/models/MyModel.php
  /application/models/MyModel.de
  /application/models/MyModel.en
  /application/controllers/
  /application/controllers/MyController.php
  /application/controllers/MyController.de
  /application/controllers/MyController.en
  /library/
  

  Positiv: Übersetzungsdateien sind in der Nähr Ihrer Quelle zu finden.

  Negativ: Zu viele und auch kleine Übersetzungsdateien führen zu einer schwierigen und langwierigen Übersetzung. Es muß auch jede Datei als Übersetzungsquelle hinzugefügt werden.

Einzeln strukturierte und sprachlich strukturierte Quell Dateien sind für Zend_Translate am besten benutzbar.

Also jetzt, da bekannt ist welche Struktur verwendet wird, müssen die einzelnen Übersetzungs Dateien erstellt werden.

Array Quelldateien sind einfache Arrays. Sie müssen aber per Hand definiert werden, da es hierfür keine Tools gibt die helfen könnten. Weil Sie so einfach zu handhaben sind, ist Ihre Verwendung auch der schnellste Weg um zu testen ob Nachrichten innerhalb des Codes wie erwartet arbeiten. Er ist generell der beste Adapter um mit Mehrsprachigkeit zu beginnen wenn man keine diesbezüglichen Kenntnisse hat.

$english = array(
    'message1' => 'message1',
    'message2' => 'message2',
    'message3' => 'message3');

$german = array(
    'message1' => 'Nachricht1',
    'message2' => 'Nachricht2',
    'message3' => 'Nachricht3');

$translate = new Zend_Translate('array', $english, 'en');
$translate->addTranslation($deutsch, 'de');

Seit Release 1.5 wird es auch unterstützt, Arrays die in externen Dateien vorhanden sind einzubauen. Es ist der Dateiname anzugeben und Zend_Translate wird diesen automatisch einbauen und nach dem Array schauen. Siehe das folgende Beispiel für Details:

// myarray.php
<?php
return array(
    'message1' => 'Nachricht1',
    'message2' => 'Nachricht2',
    'message3' => 'Nachricht3');

// controller
$translate = new Zend_Translate('array', '/path/to/myarray.php', 'de');

Hinweis: Bei Dateien die kein Array zurückgeben wird das inkludieren fehlschlagen. Auch jegliche Ausgabe innerhalb dieser Dateien wird ignoriert und unterdrückt.

Gettext Quellen werden durch GNU's Gettext Bibliothek erstellt. Es gibt einige kostenlose Tools welche den Code parsen können und hierbei die gewünschten Gettext Quellen erstellen. Diese haben die Endung *.mo und sind binäre Dateien. Ein Open Source Tool für die Erstellung der Quellen ist » poEdit. Dieses Tool unterstützt auch beim Übersetzungs-Prozesses selbst.

// Wir nehmen an das die mo Datien erstellt und übersetzt wurden
$translate = new Zend_Translate('gettext', '/path/to/english.mo', 'en');
$translate->addTranslation('/path/to/german.mo', 'de');

Wie man sieht wird dieser Adapter auf exakt die gleiche Art und Weise verwendet mit einer kleinen Änderung: dem Wechsel von array zu gettext. Alle anderen Punkte werden in jedem anderen Adapter auf exakt die gleiche Weise verwendet. Mit diesem Gettext Adapter muß nicht mehr auf die geforderte Standard Verzeichnis Struktur von Gettext geachtet werden. Auch nicht auf bindtextdomain und textdomain. Nur der Pfad und der Dateiname muß dem Adapter übergeben werden.

Hinweis: Man sollte immer UTF-8 als Quell Encoding verwenden. Man könnte sonst Probleme bekommen wenn man zwei verschiedene Encodings verwendet. Wenn z.B. eine Quelldatei mit ISO-8815-11 und eine andere mit CP815 encoded ist. Man kann immer nur ein Encoding für alle Quell Dateien verwenden, und hierbei würde eine der gewünschten Sprachen nicht korrekt angezeigt werden.
UTF-8 ist ein portables Format welches alle Sprachen unterstützt. Wenn UTF-8 für alle Sprachen verwendet wird, eliminiert man die Probleme mit inkompatiblen Encodings.

Viele Gettext Editoren fügen Informationen über den Adapter als Übersetzung eines leeren Strings hinzu. Das ist der Grund warum leere Strings nicht übersetzt werden wenn der Gettext Adapter verwendet wird. Stattdessen wird er von der Übersetzungstabelle gelöscht und von der getAdapterInfo() Methode angeboten. Sie gibt die Adapterinformationen für alle hinzugefügten Gettextdateien als Array zurück wobei der Dateiname als Schlüssel verwendet wird.

// Informationen des Adapters bekommen
$translate = new Zend_Translate('gettext', '/path/to/english.mo', 'en');
print_r($translate->getAdapterInfo());

TMX Quellen sind der neue Industrie Standard. Sie haben den Vorteil das sie XML Dateien sind und deswegen mit jedem Texteditor lesbar und natürlich auch von Menschen. Man kann TMX Dateien entweder per Hand erstellen oder man verwendet spezielle Tools dafür. Allerdings sind die meisten erhältlichen Tools die Erstellung von TMX Quellen nicht frei erhältlich.

<?xml version="1.0" ?>
<!DOCTYPE tmx SYSTEM "tmx14.dtd">
<tmx version="1.4">
 <header creationtoolversion="1.0.0" datatype="winres" segtype="sentence"
         adminlang="en-us" srclang="de-at" o-tmf="abc"
         creationtool="XYZTool" >
 </header>
 <body>
  <tu tuid='message1'>
   <tuv xml:lang="de"><seg>Nachricht1</seg></tuv>
   <tuv xml:lang="en"><seg>message1</seg></tuv>
  </tu>
  <tu tuid='message2'>
   <tuv xml:lang="en"><seg>message2</seg></tuv>
   <tuv xml:lang="de"><seg>Nachricht2</seg></tuv>
  </tu>

$translate = new Zend_Translate('tmx', 'path/to/mytranslation.tmx', 'en');

TMX Dateien können mehrere Sprachen in der selben Datei enthalten. Alle anderen in der Quelle enthaltenen Sprachen werden automatisch hinzugefügt und müssen nicht durch einen extra Aufruf von addLanguage() ergänzt werden.

Wenn man nur spezielle Sprache aus der Quelle übersetzen will, kann die Option 'defined_language' auf true gesetzt werden. Mit dieser Option können gewünschte Sprachen explizit mit addLanguage() hinzugefügt werden. Der Standardwert für diese Option fügt alle Sprachen hinzu.

CSV Quellen sind sehr klein und von Menschen lesbar. Wenn ein Kunde selbst übersetzen will, ist die Verwendung des CSV Adapters warscheinlich die beste Wahl.

#Example csv file
message1;Nachricht1
message2;Nachricht2

$translate = new Zend_Translate('csv', '/path/to/mytranslation.csv', 'de');
$translate->addTranslation('/path/to/other.csv', 'fr');

Es gibt drei verschiedene Optionen für den CSV Adapter. Es können 'delimiter', 'limit' und 'enclosure' gesetzt werden.

Das Standard Trennzeichen für CSV Strings ist ';, aber es muß nicht dieses Zeichen sein. Mit der Option 'delimiter' kann ein anderes verwendet werden.

Das Standardlimit für eine Zeile in einer CSV Datei ist '0'. Das bedeutet dass das Ende der CSV Zeile automatisch gesucht wird. Wenn 'limit' auf irgendeinen Wert gesetzt wird, dann wird die CSV Datei schneller gelesen, aber jede Zeile die dieses Limit überschreitet wird abgeschnitten.

Das standardmäßige Anführungszeichen für die Verwendung mit CSV Dateien ist '"'. Man kann ein anderes Setzen indem die Option 'enclosure' verwendet wird.

# Example CSV file
"message,1",Nachricht1
message2,"Nachricht,2"
"message3,",Nachricht3

$translate = new Zend_Translate(
    'csv',
    '/path/to/mytranslation.csv',
    'de',
    array('delimiter' => ','));

$translate->addTranslation('/path/to/other.csv', 'fr');

INI Quelldateien sind menschlich lesbar aber normalerweise nicht sehr klein da Sie neben der Übersetzung auch andere Daten enthalten. Wenn Sie Daten haben die von Ihrem Kunden zu bearbeitet sind, verwenden Sie den INI Adapter.

[Test]
;TestPage Comment
Message_1="Nachricht 1 (de)"
Message_2="Nachricht 2 (de)"
Message_3="Nachricht :3 (de)"

$translate = new Zend_Translate('ini', '/path/to/mytranslation.ini', 'de');
$translate->addTranslation('/path/to/other.ini', 'it');

INI Dateien haben diverse Einschränkungen. Wenn ein Wert in einer INI Datei irgendein nicht alphanummerisches Zeichen enthält, muß er in doppelte Anführungszeichen (") eingeklammert werden. Es gibt auch reservierte Wörter welche nicht als Schlüssel für INI Dateien verwendet werden dürfen. Diese enthalten: null, yes, no, true und false. Die Werte null, no und false führen zu "", yes und true resultieren in 1. Die Zeichen {}|&~![()" dürfen nirgendwo im Schlüssel verwendet werden und haben im Wert eine spezielle Bedeutung. Diese sollten nicht verwendet werden da Sie zu unerwartetem Verhalten führen.

Optionen können bei allen Adaptoren verwendet werden. Natürlich sind die Optionen für alle Adaptoren verschieden. Die Optionen können bei Erstellung des Objekts miterstellt werden. Zur Zeit gibt es nur eine Option die für alle Adaptoren verfügbar ist: 'clear' setzt, ob die neuen Übersetzungsdaten zu den bestehenden hinzugefügt werden sollen oder ob Sie diese überschreiben. Das Standardverhalten ist das Hinzufügen von neuen Übersetzungsdaten zu den Bestehenden. Aber das wird immer nur für die aktuelle Sprache gemacht. Anderen Sprachen bleiben davon unberührt.

Man kann Optionen temporär setzen indem man die Funktion addTranslation($data, $locale, array $options = array()) als dritten und optionalen Parameter benutzt. Ausserdem kann die Methode setOptions() benutzt werden um Optionen permanent zu setzen.

// Definiere ':' als Trenner für die Quelldatei der Übersetzung
$options = array('delimiter' => ':');
$translate = new Zend_Translate(
    'csv',
    '/path/to/mytranslation.csv',
    'de',
    $options);

...

// Lösche die definierte Sprache und verwende die neuen Übersetzungsdaten
$options = array('clear' => true);
$translate->addTranslation('/path/to/new.csv', 'fr', $options);

Hier können alle vorhandenen Optionen für die verschiedenen Adapter gefunden werden mit einer Beschreibung Ihrer Verwendung:

Wenn man selbstdefinierte Optionen haben will, können diese auch in allen Adaptern verwendet werden. Die setOptions() Methode kann verwendet werden um die eigene Option zu definieren. setOptions() benötigt ein Array mit den Optionen die gesetzt werden sollen. Wenn eine angegebene Option bereits existiert wird diese überschrieben. Es können beliebig viele Optionen definiert werden da diese nicht vom Adapter geprüft werden. Man muß nur Sicherstellen das keine existierende Option überschrieben werden die von einem Adapter verwendet wird.

Um die Option zurückzugeben kann die Methode getOptions() verwendet werden. Wenn getOptions() ohne einen Parameter aufgerufen wird, gibt Sie alle Optionen zurück. Wenn der optionale Parameter angegeben wird, wird nur die spezifizierte Option zurückgegeben.

Wenn mit verschiedenen Sprachen gearbeitet wird gibt es ein paar Methoden die nützlich sind.

Die getLocale() Methode kann verwendet werden um die aktuell gesetzte Sprache zu erhalten. Sie kann entweder eine Instanz von Zend_Locale oder den Bezeichner des Gebietsschemas enthalten.

Die setLocale() Methode setzt eine neue Standardsprache für Übersetzungen. Das verhindert das der optionale Sprachparameter der translate() Methode mehr als einmal gesetzt werden muß. Wenn die angegebene Sprache nicht existiert, oder keine Übersetzten Daten für diese Sprache vorhanden sind, versucht setLocale() auf die Sprache ohne Region downzugraden wenn diese angegeben wurde. Die Sprache en_US würde zum Beispiel zu en downgegradet werden. Wenn sogar nach dem Downgraden die Sprache nicht gefunden werden konnte, wird eine Ausnahme geworfen.

Die isAvailable() Methode prüft ob eine angegebene Sprache bereits vorhanden ist. Es wird true zurückgegeben wenn Daten für die angegebene Sprache existieren.

Und letztendlich kann die getList() Methode verwendet werden um alle aktuell gesetzten Sprachen für einen Adapter als Array zu erhalten.

// gibt die aktuell gesetzte Sprache zurück
$actual = $translate->getLocale();

// der optionale Parameter kann wärend der Übersetzung verwendet werden
echo $translate->_("mein_Text", "fr");
// oder setze eine neue Standardsprache
$translate->setLocale("fr");
echo $translate->_("mein_Text");
// zur Basissprache referieren
// fr_CH wird zu fr downgegradet
$translate->setLocale("fr_CH");
echo $translate->_("mein_Text");

// Prüft ob die Sprache existiert
if ($translate->isAvailable("fr")) {
    // Sprache existiert
}

// Angenommen der Browser gibt folgende Spracheneinstellungen zurück:
// HTTP_ACCEPT_LANGUAGE = "de_AT=1;fr=1;en_US=0.8";

// Beispiel 1:
// Wenn keine passende Sprache gefunden wird, wird die MessageID zurückgegeben
$translate = new Zend_Translate(
    'gettext',
    '\my_it.mo',
    'auto',
    array('scan' => Zend_Translate::LOCALE_FILENAME));

// Beispiel 2:
// Die am besten passende Sprache ist 'fr'
$translate = new Zend_Translate(
    'gettext',
    '\my_fr.mo',
    'auto',
    array('scan' => Zend_Translate::LOCALE_FILENAME));

// Beispiel 3:
// Die am besten passende Sprache ist 'de' ('de_AT' wird degradiert)
$translate = new Zend_Translate(
    'gettext',
    '\my_de.mo',
    'auto',
    array('scan' => Zend_Translate::LOCALE_FILENAME));

// Beispiel 4:
// Gibt 'it' als Übersetzungsquelle zurück und überschreibt
// die automatischen Eigenschaften
$translate = new Zend_Translate(
    'gettext',
    '\my_it.mo',
    'auto',
    array('scan' => Zend_Translate::LOCALE_FILENAME)
);
$translate->addTranslation('\my_ru.mo', 'ru');
$translate->setLocale('it_IT');

// In der Bootstrap Datei
$locale = new Zend_Locale();
Zend_Registry::set('Zend_Locale', $locale);

// Standardsprache wenn die angefragte Sprache nicht vorhanden ist
$defaultlanguage = 'en';

// Irgendwo in der Anwendung
$translate = new Zend_Translate('gettext', 'my_de.mo');

if (!$translate->isAvailable($locale->getLanguage())) {
    // Nicht vorhandene Sprache werden auf eine andere Sprache geroutet
    $translate->setLocale($defaultlanguage);
}

$translate->getLocale();

Zend_Translate kann Übersetzungsquellen automatisch erkennen. Es muß also nicht jede Quelldatei manuell deklariert werden. Man kann diesen Job Zend_Translate überlassen welches die komplette Verzeichnisstruktur nach Quelldateien durchsucht.

Hinweis: Automatische Erkennung der Quellen ist seit Zend Framework Version 1.5 vorhanden.

Die Verwendung ist fast die selbe wie bei der Initiierung einer einzelnen Übersetzungsquelle mit einem Unterschied. Es darf nur ein Verzeichnis angegeben werden, statt einer Datei, welches gescannt werden soll.

// Angenommen wir haben die folgende Struktur
//  /language/
//  /language/login/login.tmx
//  /language/logout/logout.tmx
//  /language/error/loginerror.tmx
//  /language/error/logouterror.tmx

$translate = new Zend_Translate('tmx', '/language');

Zend_Translate muß also nicht nur das angegebene Verzeichnis durchsuchen, sondern auch alle Unterverzeichnisse nach Dateien für Übersetzungen. Das macht die Verwendung sehr einfach. Aber Zend_Translate wird alle Dateien ignorieren, welche keine Quellen sind, oder wärend des Einlesens der Übersetzungsdaten Fehler produzieren. Man sollte also sicherstellen das alle Übersetzungsquellen korrekt sind und gelesen werden können weil man keinen Fehler erhält wenn eine Datei fehlerhaft ist oder nicht gelesen werden kann.

Hinweis: Abhängig davon wie tief die Verzeichnisstruktur ist und wieviele Dateien innerhalb dieser Struktur vorhanden sind, kann es eine sehr lange Zeit dauern bis Zend_Translate fertig ist.

In unserem Beispiel haben wir das TMX Format verwendet welches die Sprache enthält die innerhalb der Quelle verwendet wird. Aber viele der anderen Quellformate sind nicht dazu fähig die Sprache in der Datei selbst zu inkludieren. Aber auch diese quellen können mit der automatischen Erkennung verwendet werden wenn ein paar Dinge berücksichtigt werden die anbei beschrieben sind:

// Angenommen wir haben die folgende Struktur
//  /language/
//  /language/de/login/login.mo
//  /language/de/error/loginerror.mo
//  /language/en/login/login.mo
//  /language/en/error/loginerror.mo

$translate = new Zend_Translate(
    'gettext',
    '/language',
    null,
    array('scan' => Zend_Translate::LOCALE_DIRECTORY));

// Angenommen wir haben die folgende Struktur
//  /language/
//  /language/login/login_en.mo
//  /language/login/login_de.mo
//  /language/error/loginerror_en.mo
//  /language/error/loginerror_de.mo

$translate = new Zend_Translate(
    'gettext',
    '/language',
    null,
    array('scan' => Zend_Translate::LOCALE_FILENAME));

/languages/
/languages/en.mo
/languages/de.mo
/languages/es.mo

/languages/
/languages/view.en
/languages/view.de
/languages/view.es

/languages/
/languages/view_en.mo -> erkennt englisch
/languages/view_de.mo -> erkennt deutsch
/languages/view_it.mo -> erkennt italienisch

/languages/
/languages/view_en_de.mo -> erkennt englisch
/languages/view_en_es.mo -> erkennt englisch und überschreibt die erste Datei
/languages/view_it_it.mo -> erkennt italienisch

/languages/
/languages/view_en-it.mo -> erkennt englisch weil '_' vor '-' verwendet wird
/languages/view-en_it.mo -> erkennt italienisch weil '_' vor '-' verwendet wird
/languages/view_en.it.mo -> erkennt italienisch weil '.' vor '_' verwendet wird

Normalerweise wird Text ohne Berechnungen übersetzt. Aber manchmal ist es notwendig zu wissen, ob ein Text in der Quelle übersetzt ist oder nicht, und hierfür kann die Methode isTranslated() verwendet werden.

isTranslated($messageId, $original = false, $locale = null) nimmt den Text bzw die Id von der man wissen will ob sie Übersetzbar ist, als ersten Parameter, und als optionalen dritten Parameter das Gebietsschema für das man die Prüfung durchführen will. Der optionale zweite Parameter definiert ob die Übersetzung fix für die definierte Sprache ist oder ob ein kleineres Set von Übersetzungen verwendet werden kann. Wenn ein Text, welcher für 'en' zurückgegeben werden kann, aber nicht für 'en_US', dann wird die Übersetzung normalerweise zurückgegeben, aber wenn $original auf true gesetzt ist, gibt die isTranslated() Methode in solche Fällen false zurück.

$english = array(
    'message1' => 'Nachricht 1',
    'message2' => 'Nachricht 2',
    'message3' => 'Nachricht 3');

$translate = new Zend_Translate('array', $english, 'de_AT');

if ($translate->isTranslated('message1')) {
    print "'message1' kann übersetzt werden";
}

if (!($translate->isTranslated('message1', true, 'de'))) {
    print "'message1' kann nicht in 'de' übersetzt werden da es "
        . "nur in 'de_AT' vorhanden ist";
}

if ($translate->isTranslated('message1', false, 'de')) {
    print "'message1' kann in 'de_AT' übersetzt werden " .
    "da es zu 'de' zurückfällt";
}

Wenn man eine größere Site hat, oder man die Übersetzungsdateien manuell erstellt hat man oft das Problem das einige Meldungen nicht übersetzt werden. Aber es gibt eine einfache Lösung wenn man Zend_Translate verwendet.

Man muß den folgenden zwei oder drei einfachen Schritten folgen. Erstens, muß man eine Instanz von Zend_Log erstellen. Und dann muß man diese Instanz an Zend_Translate übergeben. Siehe das folgende Beispiel:

$translate = new Zend_Translate('gettext', $path, 'de');

// Eine Log Instanz erstellen
$writer = new Zend_Log_Writer_Stream('/path/to/file.log');
$log    = new Zend_Log($writer);

// Diese der Übersetzungs-Instanz hinzufügen
$translate->setOptions(array(
    'log'             => $log,
    'logUntranslated' => true));

$translate->translate('unbekannter String');

Jetzt steht im Log eine neue Notiz: Untranslated message within 'de': unbekannter String.

Hinweis: Man sollte beachten das jede Übersetzung die nicht gefunden wird mitgeloggt wird. Das bedeutet alle Übersetzungen wenn ein Benutzer eine nicht unterstützte Sprache anfragt. Aber auch jede Anfrage für eine Nachricht die nicht übersetzt werden kann wird mitgeloggt. Es ist zu beachten das, 100 Personen die die gleiche Übersetzung anfragen, auch zu 100 geloggten Notizen führen.

Dieses Feature kann nicht nur verwendet werden um Nachrichten zu Loggen sondern auch um diese nicht übersetzen Nachrichten in eine leere Übersetzungsdatei zu schreiben. Um das zu ermöglichen muß man seinen eigenen Log Writer erstellen der das Format schreibt das man haben will und das führende "Untranslated message" herausschneidet.

Wenn man seine eigene Logmeldung haben will, kann man auch die Option 'logMessage' setzen. Das '%message%' Token ist für die Platzierung der messageId in der eigenen Logmeldung zu verwenden, und das '%locale%' Token für das angefragte Gebietsschema. Siehe das folgende Beispiel für ein Beispiel einer selbst definierten Logmeldung:

$translate = new Zend_Translate('gettext', $path, 'de');

// Eine Loginstanz erstellen
$writer = new Zend_Log_Writer_Stream('/path/to/file.log');
$log    = new Zend_Log($writer);

// Diese der Übersetzungsinstanz hinzufügen
$translate->setOptions(array(
    'log'             => $log,
    'logMessage'      => "Fehlende '%message%' im Gebietsschema '%locale%'",
    'logUntranslated' => true));

$translate->translate('unknown string');

Manchmal ist es nützlich, Zugang zu den übersetzten Quelldaten zu erhalten. Hierfür werden die folgenden zwei Methoden angeboten.

Die getMessageIds($locale = null) Methode gibt alle bekannten Ids für Übersetzungen als Array zurück.

Die getMessages($locale = null) Methode gibt die komplette Übersetzungs-Quelle als Array zurück. Die Ids der Übersetzungen werden als Schlüssel und die Übersetzten Daten als Wert verwendet.

Beide Methoden akzeptieren einen optionalen Parameter $locale welcher, wenn er gesetzt wird, die Übersetzungsdaten für die spezifizierte Sprache, zurückgibt. Wenn dieser Parameter nicht angegeben wird, wird die aktuell gesetzte Sprache verwendet. Es ist zu beachten das normalerweise alle Übersetzungen in allen Sprachen vorhanden sein sollten. Das bedeutet das man in einer normalen Situation diesen Parameter nicht angeben muß.

Zusätzlich kann die getMessages() Methode verwendet werden um das komplette Übersetzungsverzeichnis, mit dem Pseudo-Gebietsschema 'all', zurückgeben. Das gibt alle vorhandenen Übersetzungsdaten für jedes hinzugefügte Gebietsschema zurück.

Hinweis: Achtung: Das zurückgegebene Array kann sehr groß sein, abhängig von der Anzahl an hinzugefügten Gebietsschemata und der Anzahl an Übersetzungsdaten.

// gibt alle bekannten Übersetzungs Ids zurück
$messageIds = $translate->getMessageIds();
print_r($messageIds);

// oder nur die spezifizierte Sprache
$messageIds = $translate->getMessageIds('en_US');
print_r($messageIds);

// gibt die kompletten Übersetzungs Daten zurück
$source = $translate->getMessages();
print_r($source);