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().

$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 Objekts
$copiedLocale = clone $locale;

print "copied: ", $copiedLocale->toString();

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

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

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

// Prüfe ob die Gebietsschemata 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 Zend Framework 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, oder FRAMEWORK). Der zweite Parameter wechselt zwischen der Rückgabe aller gefundenen Gebietsschemata oder nur dem ersten oder besten Gebietsschema. Lokalisierbare Komponenten benutzen normalerweise nur das erste Gebietsschema. Wenn vorhanden, wird eine Bewertung der Qualität mit angegeben.

$locale = new Zend_Locale();

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

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

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

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.

$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.

$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();

Wenn man nur ein Territorium oder ein Land hat, dann ist es auch möglich aus diesen Informationen ein Gebietsschema zu erhalten. Man kann manuell suchen, ob es ein Gebietsschema für dieses Territorium gibt, indem man getLocaleToTerritory() verwendet. Diese Methode gibt ein Gebietsschema für das angegebene Territorium zurück, oder NULL wenn kein Gebietsschema gefunden werden konnte.

$locale = Zend_Locale::getLocaleToTerritory('US');
// Gibt 'en_US' zurück

getTranslationList() gibt Zugriff auf viele Arten von lokalisierten Informationen. Diese Informationen sind sehr nützlich, wenn man einem Benutzer lokalisierte Daten anzeigen will, ohne dass man alles übersetzen muss. 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.

$list = Zend_Locale::getTranslationList('language', 'de_AT');

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 Zend_Locale::getTranslation('de', 'language', 'zh');
// Gibt die Übersetzung 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 Methode getTranslation() verwendet werden. Diese gibt immer einen String zurück, akzeptiert aber einige andere Typen als die Methode getTranslationList(). Auch der Wert ist der gleiche wie vorher mit einem Unterschied. Das Detail, das man zurückerhalten will, muss als zusätzlicher Wert angegeben werden.

Siehe die folgende Tabelle für detailierte Informationen:

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

$locale = new Zend_Locale('en_US');
// Gibt die Namen aller Länder in der Französischen Sprache aus
print_r(Zend_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.

$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 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 muss 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.

$list = Zend_Locale::getLanguageTranslationList('auto');

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

Oft müssen Programme eine Rückmeldung mit "Ja" oder "Nein" 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:

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:

$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 Methode getLocaleList() verwendet werden, welche eine Liste aller bekannten Gebietsschemata zurückgibt.

$localelist = Zend_Locale::getLocaleList();

Wenn man erkennen will, ob eine vorhandene Eingabe unabhängig von ihrer Quelle ein Gebietsschema ist, sollte man die statische Methode isLocale() verwenden. Der erste Parameter dieser Methode ist der String den man prüfen will.

$input = 'to_RU';
if (Zend_Locale::isLocale($input)) {
    print "'{$input}' ist ein Gebietsschema";
} else {
    print "Sorry... die vorhandene Eingabe ist kein Gebietsschema";
}

Wie man sieht, ist die Ausgabe dieser Methode immer ein boolscher Wert. Es gibt nur einen Grund, warum man eine Ausnahme erhält, wenn diese Methode aufgerufen wird. Wenn das eigene System kein Gebietsschema anbietet und Zend Framework nicht in der Lage ist, dieses automatisch zu erkennen. Normalerweise zeigt dies, dass ein Problem mit dem eigenen OS in Kombination mit setlocale() von PHP vorhanden ist.

Man sollte auch beachten, dass jeder angegebene Gebietsschema-String automatisch degradiert wird, wenn der Regionsabschnitt für dieses Gebietsschema nicht existiert. In unserem vorherigen Beispiel existiert die Region 'RU' nicht für die Sprache 'to', aber es wird trotzdem TRUE zurückgegeben, da Zend_Locale mit der vorhandenen Eingabe arbeiten kann.

Trotzdem ist es manchmal nützlich, diese automatische Degradierung zu verhindern, und hier kommt der zweite Parameter von isLocale() zu Tragen. Der Parameter strict ist standardmäßig FALSE und kann verwendet werden, um die automatische Degradierung zu verhindern, wenn er auf TRUE gesetzt wird.

$input = 'to_RU';
if (Zend_Locale::isLocale($input, true)) {
    print "'{$input}' ist ein Gebietsschema";
} else {
    print "Sorry... die vorhandene Eingabe ist kein Gebietsschema";
}

Jetzt da man in der Lage zu erkennen, ob ein vorhandenen String ein Gebietsschema ist, kann man Gebietsschema bezogenes Verhalten zu den eigenen Klassen hinzufügen. Aber man wird schnell erkennen, dass das immer zu den gleichen 15 Zeilen Code führt. Etwas ähnliches wie das folgende Beispiel:

if ($locale === null) {
    $locale = new Zend_Locale();
}

if (!Zend_Locale::isLocale($locale, true, false)) {
    if (!Zend_Locale::isLocale($locale, false, false)) {
        throw new Zend_Locale_Exception(
            "Das Gebietsschema '$locale' ist kein bekanntes Gebietsschema");
    }

    $locale = new Zend_Locale($locale);
}

if ($locale instanceof Zend_Locale) {
    $locale = $locale->toString();
}

Mit Zend Framework 1.8 haben wir die statische Methode findLocale() hinzugefügt, welche einen Gebietsschema-String zurückgibt, mit dem man arbeiten kann. Sie führt die folgenden Arbeiten durch:

Das folgende Beispiel zeigt, wie diese Prüfungen und der obige Code mit einem einfachen Aufruf vereinfacht werden kann:

$locale = Zend_Locale::findLocale($inputstring);