Verwende » Klonen von Objekten um Gebietsschema Objekte exakt und effizient zu duplizieren. Die meisten lokalisierbaren Methoden akzeptieren auch eine Zeichenkette welche das Gebietsschema repräsentiert. Dieser entspricht dem Ergebnis von $locale->toString().

<?php
require_once 'Zend/Locale.php';

$locale = new Zend_Locale('ar');

// Speichere das $locale Objekt als Serialisierung
$serializedLocale = $locale->serialize();
// Wiedererstellung des Original Objekts
$localeObject = unserialize($serializedLocale);

// Erhalte eine Zeichenkette welche das Gebietsschema identifiziert
$stringLocale = $locale->toString();

// Erstelle eine geklonte Kopie des $locale Objektes
$copiedLocale = clone $locale;

print "copied: ", $copiedLocale->toString();
print "copied: ", $copiedLocale; // PHP ruft automatisch toString() über __toString(); auf
            

Zend_Locale bietet auch eine erwartete Funktion zum Vergleichen von zwei Gebietsschema an. Alle lokalisierbaren Klassen sollten eine Vergleichbare Funktion für eine Gleichheitsprüfung anbieten.

<?php
require_once 'Zend/Locale.php';

$locale = new Zend_Locale();
$mylocale = new Zend_Locale('en_US');

// Prüfe ob die Gebietsschema gleich sind
if ($locale->equals($mylocale)) {
    print "Die Gebietsschemata sind gleich";
}
            

Die Methode getDefault() gibt ein Array mit relevanten Gebietsschemata zurück wobei Informationen vom Web Browser des Benutzers (wenn vorhanden), Informationen vom Betriebsystem des Host Servers und ZF Einstellungen benutzt werden. Wie beim Konstruktor von Zend_Locale wählt der erste Parameter die bevorzugte Umgebung von der die Informationen zuerst geholt werden sollen (BROWSER, ENVIRONMENT, or FRAMEWORK) . Der zweite Parameter wechselt zwischen der Rückgabe aller gefundenen Gebietsschemata oder nur dem ersten/besten Gebietsschema. Lokalisierbare Komponenten benutzen normalerweise nur das erste Gebietsschema. Wenn vorhanden, wird eine Bewertung der Qualität mit angegeben.

<?php
require_once 'Zend/Locale.php';

$locale = new Zend_Locale();

// Alle Standard Gebietsschema zurückgeben
$found = $locale->getDefault();
print_r($found);

// Nur die Gebietsschema des Browsers zurück geben
$found2 = $locale->getDefault(Zend_Locale::BROWSER,TRUE);
print_r($found2);
            

Um nur die Standard Gebietsschema für BROWSER, ENVIRONMENT, oder FRAMEWORK zu erhalten, können die folgenden Methoden benutzt werden:

• getEnvironment()

• getBrowser()

• getLocale()

Ein neues Gebietsschema kann mit der Funktion setLocale() gesetzt werden. Diese Funktion nimmt eine Gebietsschema Zeichenkette als Parameter an. Wenn kein Gebietsschema angegeben wurde, wird ein automatisch gewähltes Gebietsschema benutzt. Da Zend_Locale Objekte sehr "leicht" sind, existiert diese Methode hauptsächlich um Nebeneffekte auszuschließen, für Klassen die ein existierendes angelegtes Objekt referenzieren.

<?php
require_once 'Zend/Locale.php';

$locale = new Zend_Locale();

// Aktuelles Gebietsschema
print $locale->toString();

// neues Gebietsschema
$locale->setLocale('aa_DJ');
print $locale->toString();
            

getLanguage() gibt eine Zeichenkette zurück welche den zwei-Zeichen Code der Sprache des Gebietsschemas enthält. getRegion() gibt eine Zeichenkette zurück welche den Zwei-Zeichen Code der Region des Gebietsschemas enthält.

<?php
require_once 'Zend/Locale.php';

$locale = new Zend_Locale();

// Wenn das Gebietsschema 'de_AT' ist, wird 'de' als Sprache zurückgegeben
print $locale->getLanguage();

// Wenn das Gebietsschema 'de_AT' ist, wird 'AT' als Region zurückgegeben
print $locale->getRegion();
            

getTranslationList() gibt Zugriff auf viele Arten von lokalisierten Informationen. Diese Informationen sind sehr nützlich wenn man einem Benutzer lokalisierte Daten anzeigen will, ohne das man alles Übersetzen muß. Diese Informationen sind bereits für den Gebrauch vorhanden.

Die angefragte Liste an Informationen wird immer als benanntes Array zurückgegeben. Wenn mehr als ein Wert zu einem expliziten Typ angegeben werden soll von dem man Werte erhalten will, muss ein Array statt mehrerer Werte übergeben werden.

<?php
require_once 'Zend/Locale.php';

$locale = new Zend_Locale('de_AT');
$list = $locale->getTranslationList('language');

print_r ($list);
// Beispiel Schlüssel -> Werte Paare...
// [de] -> Deutsch
// [en] -> Englisch

// Einen der zurückgegebenen Schlüssel als Wert für die getTranslation() Methode einer anderen Sprache verwenden
print $locale->getTranslation('de', 'language', 'zh');
// Gibt die Übversetzung für die Sprache 'de' in chinesisch zurück
            

Man kann diese Informationen für alle Sprachen auslesen. Aber nicht alle dieser Informationen sind komplett für alle Sprachen. Einige dieser Arten sind auch durch eine eigene Funktion erhältlich wegen der Einfachheit. Anbei eine Liste für detailierte Informationen hierüber.

Wenn nur ein einzelner übersetzter Wert benötigt wird, kann die getTranslation() Methode verwendet werden. Diese gibt immer einen String zurück, akzeptiert aber einige andere Typen als die getTranslationList() Methode. Auch der Wert ist der gleiche wie vorher mit einem Unterschied. Das Detail das man zurückerhalten will muß als zusätzlicher Wert angegeben werden

Hinweis: Weil immer ein Wert als Detail angegeben werden muß, muss dieser Parameter als erster Parameter angegeben werden. Das unterscheidet sich von der getTranslationList() Methode.

Siehe die folgende Tabelle für detailierte Informationen:

Hinweis: Mit dem Zend Framework 1.5 wurde verschiedene alte Typen umbenannt. Das wurde notwendig durch verschiedene neue Typen, einige Schreibfehler und die Erhöhung der Verwendbarkeit. Die folgende Tabelle zeigt eine Liste von alten und neuen Typen:

Das folgende Beispiel zeigt wie man die Namen für Dinge in verschiedenen Sprachen erhalten kann.

<?php
require_once 'Zend/Locale.php';

$locale = new Zend_Locale('en_US');
// Gibt die Namen aller Länder in der Französischen Sprache aus
print_r($locale->getTranslationList('country', 'fr'));
            

Das nächste Beispiel zeigt wie der Name einer Sprache in einer anderen Sprache gefunden werden kann, wenn der zwei-Zeichen ISO Länder-Code unbekannt ist.

<?php
require 'Zend/Locale.php';
$locale = new Zend_Locale('en_US');
$code2name = $locale->getLanguageTranslationList();
$name2code = array_flip($code2name);
$frenchCode = $name2code['French'];
echo $locale->getLanguageTranslation($frenchCode, 'es');
// Ausgegeben wird der Spanische Name der Fransösischen Sprache
            

Um etwas mehr Erfahrung damit zu bekommen was verfügbar ist, sollen die Beispiele ausprobiert und die Ausgabe angesehen werden.

<?php
// Erhalte eine Liste aller Übersetzungslisten
$lists = $locale->getTranslationList();

// Zeige alle vorhandenen Übersetzungslisten (viel Ausgabe, alles in der gewählten Sprache)
foreach ($lists as $list) {
    echo "List $list = ";
    print_r($locale->getTranslationList($list));
}
            

Um von Zend_Locale eine Liste aller bekannten Sprachen zu bekommen wobei jede Sprache in Ihrer eigenen Sprache geschrieben wird, kann das untere Beispiel in einer Web Seite benutzt werden. Genauso können getCountryTranslationList() und getCountryTranslation() benutzt werden um eine Tabelle zu erhalten die Namen für Muttersprachen einer Region und Namen für Regionen in einer anderen Sprache zu erhalten. Man muß einen try .. catch Block benutzen um Ausnahmen abzufangen die auftreten wenn ein Gebietsschema benutzt wird das nicht existiert. Nicht alle Sprachen sind auch ein Gebietsschema. Im Beispiel werden die Ausnahmen ignoriert um einen frühen Abbruch zu verhindern.

<?php
require_once 'Zend/Locale.php';

$sourceLanguage = null; // Setze hier deine Muttersprache ein
$locale = new Zend_Locale($sourceLanguage);
$list = $locale->getLanguageTranslationList();

foreach($list as $language => $content) {
    try {
        $output = $locale->getLanguageTranslation($language, $language);
        if (is_string($output)) {
            print "\n<br>[".$language."] ".$output;
        }
    } catch (Exception $e) {
        continue;
    }
}
            

Oft müssen Programme eine "Ja" oder "Nein" Rückmeldung eines Benutzers erkennen. getQuestion() gibt ein Array zurück welches die richtigen Wörter oder Regex Zeichenketten enthält um einem Benutzer in einer bestimmten $locale zu antworten (Standardmäßig das aktuelle Gebietsschema des Objekts). Das zurückgegebene Array enthält die folgenden Informationen:

• yes und no: Eine generelle Stringrepräsentation für Ja und Nein Antworten. Es enthält die erste und generellste Antwort von yesarray und noarray.

  yesarray und noarray: Ein Array mit allen bekannten Ja und Nein Antworten. Diverse Sprachen haben mehr als nur zwei Antworten. Normalerweise ist das der komplette String und seine Abkürzung.

  yesexpr und noexpr: Ein ersteller Regex String des es erlaubt Benutzerantworten zu behandeln und nach Ja und Nein zu suchen.

Alle diese Informationen sind natürlich lokalisiert und hängen vom eingestellten gebietsschema ab. Das folgende Beispiel zeigt die Informationen die empfangen werden können:

<?php
require_once 'Zend/Locale.php';

$locale = new Zend_Locale();
// Zeichenketten für Fragen
print_r($locale->getQuestion('de'));

- - - Output - - -

Array
(
    [yes]ja[/yes]
    [no]nein[/no]
    [yesabbr]j[/yesabbr]
    [noabbr]n[/noabbr]
    [yesexpr]^([yY]([eE][sS])?)|([jJ][aA]?)[/yesexpr]
    [noexpr]^([nN]([oO]|([eE][iI][nN]))?)[/noexpr]
)
            

Manchmal will man eine Liste aller bekannten Gebietsschemata erhalten. Das kann für die verschiedensten Aufgaben nützlich sein, zum Beispiel für die Erstellung einer Auswahlbox. Für diesen Zweck kann die statische getLocaleList() Methode verwender werden, welche eine Liste aller bekannten Gebietsschemata zurückgibt.

<?php
require_once 'Zend/Locale.php';

$localelist = Zend_Locale::getLocaleList();

            

Hinweis: Es ist zu beachten das die Gebietsschemata als Schlüssel des Arrays das man erhält zurück gegeben werden. Der Wert ist immer ein Boolsches True.