Es gibt verschiedene zusätzliche Features welche von Zend_Translate unterstützt werden. Lesen Sie hier für zusätzliche Informationen. Optionen können bei allen Adaptern 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. ':'); $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 mit einer Beschreibung Ihrer Verwendung gefunden werden: Option Adapter Beschreibung Standardwert clear all Wenn true gesetzt wird, werden bereits gelesene Übersetzungen entfernt. Das kann statt dem Erstellen einer neuen Instanz verwendet werden wenn neue Übersetzungsdaten gelesen werden false disableNotices all Wenn es auf true gesetzt wird, werden alle Notizen betreffend nicht vorhandenen Übersetzungen ausgeschaltet. Man sollte diese Option in einer Produktionsumgebung auf true setzen false ignore all Alle Verzeichnisse und Dateien die mit diesem Präfix beginnen werden bei der Suche nach Dateien ignoriert. Der Standardwert ist '.' was zu dem Verhalten führt das alle versteckten Dateien ignoriert werden. Wenn dieser Wert auf 'tmp' gesetzt wird, bedeutet das, Verzeichnisse und Dateien wie z.B. 'tmpImages' und 'tmpFiles', sowie alle darunter liegenden Verzeichnisse, werden ignoriert. . log all Eine Instanz von Zend_Log wohin nicht übersetzbare Meldungen und Notizen geschrieben werden null logMessage all Die Nachricht die in das Log geschrieben werden soll Untranslated message within '%locale%': %message% logUntranslated all Wenn diese Option auf true gesetzt wird, werden alle Nachrichten Id's die nicht übersetzt werden können in das angehängte Log geschrieben false reload all Wenn diese Option auf true gesetzt wird, werden die Dateien in den Cache nachgeladen. Diese Option kann verwendet werden um den Cache wieder herzustellen, oder Übersetzungen zu bereits gecachten Daten hinzuzufügen nachdem der Cache bereits erstellt wurde. false scan all Wenn null gesetzt wird, wird die Verzechnisstruktur nicht gescannt. Wenn Zend_Translate::LOCALE_DIRECTORY gesetzt wird, wird das Gebietsschema im Verzeichnis gesucht. Wenn Zend_Translate::LOCALE_FILENAME gesetzt wird, wird das Gebietsschema im Dateinamen gesucht. Siehe für Details null delimiter Csv Definiert welches Zeichen als Trenner für Quelle und Übersetzung verwendet wird ; enclosure Csv Definiert die maximale Länge einer CSV Zeile. Auf 0 gesetzt wird sie automatisch erkannt " length Csv Definiert das zu verwendende Einschließungszeichen. Standard ist das doppelte Hochkomma 0 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. getLocale(); // der optionale Parameter kann wärend der Übersetzung verwendet werden echo $translate->_("my_text", "fr"); // oder setze eine neue Standardsprache $translate->setLocale("fr"); echo $translate->_("my_text"); // zur Basissprache referieren // fr_CH wird zu fr downgegradet $translate->setLocale("fr_CH"); echo $translate->_("my_text"); // Prüft ob die Sprache existiert if ($translate->isAvailable("fr")) { // Sprache existiert } ]]> Es gilt zu beachten das, solange man neue Sprachquellen mit der addTranslation() Methode hinzufügt, Zend_Translate automatisch die am besten passende Sprache für die eigene Umgebung auswählt wenn man eine der automatischen Gebietsschemata verwendet die 'auto' oder 'browser' sein können. Man muß normalerweise also setLocale() nicht aufrufen. Das sollte nur in Verbindung mit der automatischen Erkennung von Quellen verwendet werden. Der Algorithmus sucht nach dem am besten passenden Gebietsschema abhängig vom Browser des Benutzers und der eigenen Umgebung. Siehe das folgende Beispiel für Details: 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'); ]]> Nachdem eine Sprache per Hand mit der setLocale() Methode gesetzt wurde, wird die automatische Erkennung ausgeschaltet und übergangen. Wenn man Sie wieder verwenden will, kann die Sprache auto mit setLocale() gesetzt werden, was die automatische Erkennung für Zend_Translate wieder reaktiviert. Seit dem Zend Framework 1.7.0 unterstützt Zend_Translate auch die Verwendung eines Anwendungsweiten Gebietsschemas. Man kann einfach eine Zend_Locale Instanz in der Registry setzen wie unten gezeigt. Mit dieser Schreibweise kann man das manuelle Setzen eines Gebietsschemas mit jeder Instanz komplett vergessen wenn man das gleiche Gebietsschema mehrere Male verwenden will. 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. 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. 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. 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: Ein Weg, die automatische Spracherkennung zu inkludieren, ist es die Verzeichnisse relativ zur Sprache zu benennen, welche in den Quellen des betreffenden Verzeichnisses verwendet wird. Das ist der einfachste Weg und wird zum Beispiel in Standard Gettext Implementationen verwendet. Zend_Translate benötigt die 'scan' Option um zu wissen das es die Namen aller Verzeichnisse nach Sprachen durchsuchen soll. Siehe das folgende Beispiel für Details: Zend_Translate::LOCALE_DIRECTORY)); ]]> Das funktioniert nur für Adapter die die Sprache nicht in der Quelldatei enthalten. Die Verwendung dieser Option wird zum Beispiel mit TMX ignoriert. Sprachdefinitionen im Dateinamen werden bei der Verwendung dieser Option ignoriert. Man sollte acht geben wenn man verschiedenen Unterverzeichnisse in der gleichen Struktur hat. Angenommen wir haben eine Struktur wie /language/module/de/en/file.mo. In diesem Fall enthält der Pfad mehrere Strings die als Gebietsschema erkannt werden würden. Das könnte entweder de oder en sein. In solch einem Fall ist das Verhalten nicht definiert und es wird empfohlen die Dateierkennung zu verwenden. Ein anderer Weg um die Sprache automatisch zu erkennen ist die Verwendung von speziellen Dateienamen. Man kann entweder die komplette Datei oder Teile der Datei nach der verwendeten Sprache benennen. Um diese Option zu Verwenden muß die 'scan' Option bei der Initiierung gesetzt werden. Es gibt verschiedene Wege die Quelldateien zu benennen welche im folgenden beschrieben werden: Zend_Translate::LOCALE_FILENAME)); ]]> Die komplette Datei nach der Sprache zu benennen ist der einfachste Weg, aber nur praktikabel wenn man nur eine Datei pro Verzeichnis verwendet. Ein anderer einfacher Weg ist die Verwendung der Dateiextension für die Spracherkennung. Aber das kann verwirrend sein weil man keine Idee mehr hat welche Erweiterung die Datei ursprünglich hatte. Zend_Translate kann die Sprache auch erkennen wenn Sie im Dateinamen enthalten ist. Aber wenn man diesen Weg nimmt, muß die Sprache mit einem Trennzeichen seperiert werden. Es gibt drei unterstützte Trennzeichen welche verwendet werden können. Ein Punkt '.', ein Unterstrich '_', oder ein Bindestrich '-'. erkennt englisch /languages/view_de.mo -> erkennt deutsch /languages/view_it.mo -> erkennt italienisch ]]> Das erste gefundene String der von einem Trennzeichen getrennt wird das als Gebietsschema interpretiert werden kann, wird verwendet. Siehe das folgende Beispiel für Details. erkennt englisch /languages/view_en_es.mo -> erkennt englisch und überschreibt die erste Datei /languages/view_it_it.mo -> erkennt italienisch ]]> Alle drei Trennzeichen werden verwendet um das Gebietsschema zu erkennen. Wenn der Dateiname mehrere Trennzeichen enthält, hängt das erste gefundene Trennzeichen von der Reihenfolge der Trennzeichen ab die verwendet werden. Siehe das folgende Beispiel für Details. 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. '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: setOptions(array( 'log' => $log, 'logUntranslated' => true)); $translate->translate('unbekannter String'); ]]> Jetzt steht im Log eine neue Notiz: Untranslated message within 'de': unbekannter String. 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: 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. Achtung: Das zurückgegebene Array kann sehr groß sein, abhängig von der Anzahl an hinzugefügten Gebietsschemata und der Anzahl an Übersetzungsdaten. 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); ]]>