Aby pomyślnie zduplikować obiekt locale należy użyć klonowania obiektów. Większość metod świadomych locale przyjmują w argumencie nazwę locale, taką jaka jest zwracana przez $locale->toString().

$locale = new Zend_Locale('ar');

// Serializacja oraz zapisanie obiektu $locale
$serializedLocale = $locale->serialize();
// odtworzenie oryginalnego obiektu
$localeObject = unserialize($serializedLocale);

// Uzyskanie identyfikatora locale
$stringLocale = $locale->toString();

// Utworzenie kopii obiektu $locale
$copiedLocale = clone $locale;

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

// PHP automatycznie wywołuje toString() poprzez __toString()
print "copied: ", $copiedLocale;

Zend_Locale udostępnia wygodną funkcję służącą do porównania dwóch locale. Wszystkie klasy świadome locale powinny umożliwiać podobną funkcjonalność.

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

// Sprawdzenie równoważności
if ($locale->equals($mylocale)) {
    print "Locales are equal";
}

Metoda getDefault() zwraca tablicę identyfikatorów locale na podstawie informacji udostępnianych przez przeglądarkę użytkownika (jeśli jest dostępna), informacji pochodzących ze środowiska serwera hostingowego lub z ustawień Zend Framework. Pierwszy parametr określa preferencję źródła ((BROWSER, ENVIRONMENT, or FRAMEWORK). Drugi parametr określa czy mają być zwrócone wszystkie locale wyszczególnione w źródle czy tylko pierwsze z nich. Komponenty świadome locale używają przeważnie jedynie pierwszego locale, w zależności od oceny ich preferencji (jeśli jest dostępna).

$locale = new Zend_Locale();

// Zwrócenie wszystkich domyślnych locale
$found = $locale->getDefault();
print_r($found);

// Zwrócenie jedynie locale domyślnego dla przeglądarki
$found2 = $locale->getDefault(Zend_Locale::BROWSER,TRUE);
print_r($found2);

Aby uzyskać locale domyślne dla określonego źródła: BROWSER, ENVIRONMENT lub FRAMEWORK, należy skorzystać z odpowiedniej metody:

Nowe locale może zostać ustawione za pomocą metody setLocale(). Przyjmuje ona łańcuch znaków identyfikatora locale jako parametr. Jeśli argument nie zostanie podany to nastąpi próba automatycznego wyboru. Ponieważ obiekty Zend_Locale są "lekkie" metoda ta istnieje głównie po to aby wykluczyć efekty uboczne w kodzie, który odnosi się do już istniejącej instancji.

$locale = new Zend_Locale();

// Obecne locale
print $locale->toString();

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

Aby uzyskać skrót języka z identyfikatora locale należy skorzystać z metody getLanguage(). Do uzyskania skrótu regionu służy metoda getRegion().

$locale = new Zend_Locale();

// jeśli locale to 'de_AT' wtedy 'de' zostanie zwrócone jako język
print $locale->getLanguage();

// jeśli locale to 'de_AT' wtedy 'AT' zostanie zwrócone region
print $locale->getRegion();

Metoda getTranslationList() umożliwia dostęp do zlokalizowanych danych różnego rodzaju. Te informacje są przydatne jeśli zajdzie potrzeba zaprezentowania użytkownikowi zlokalizowanych danych. W takiej sytuacji nie ma potrzeby własnoręcznego tłumaczenia - odpowiednie dane są dostępne do użytku.

Lista żądanych danych jest zawsze zwracana w postaci tablic asocjacyjnych. Jeśli istnieje potrzeba przekazania więcej niż jednego parametru do określonego typu, z którego chce się pobrać wartości to należy przekazać te parametry w postaci tablicy.

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

print_r ($list);
// przykładowe pary klucz -> wartość
// [de] -> Deutsch
// [en] -> Englisch

// użycie jednego ze zwróconych kluczy jako parametru metody getTranslation()
// dla innego języka
print Zend_Locale::getTranslation('de', 'language', 'zh');
// zwraca tłumaczenie nazwy języka określonego jako 'de' w języku chińskim

Podobne informacje można uzyskać dla wszystkich języków ale w niektórych przypadkach nie wszystkie dane są dostępne. Aby ułatwić dostęp do nich, pewne typy informacji są również dostępne poprzez dedykowane metody. Niżej znajduje się obszerniejszy opis.

Jeśli potrzebna jest pojedyncza przetłumaczona wartość można skorzystać z metody getTranslation(). Zawsze zwracany jest łańcuch znaków zaś przyjmowane argumenty są różne od tych przyjmowanych przez getTranslationList(). Parametr wartości jest taki sam jak wcześniej z jedną różnicą - identyfikator żądanego detalu musi zostać przekazany jako dodatkowy parametr.

Poniżej przedstawiono tabelę zawierającą bardziej szczegółowe informacje:

Poniższy przykład pokazuje sposób pozyskania określonych nazw w żądanym języku.

// wyświetla nazwy wszystkich krajów w języku niemieckim
print_r(Zend_Locale::getTranslationList('country', 'de'));

Następny przykład pokazuje sposób odnalezienia nazwy locale w innym języku, jeśli nieznany jest kod ISO kraju.

$code2name = Zend_Locale::getLanguageTranslationList('en_US');
$name2code = array_flip($code2name);
$frenchCode = $name2code['French'];
echo Zend_Locale::getLanguageTranslation($frenchCode, 'de_AT');
// na wyjściu znajduje się nazwa języka francuskiego po niemiecku

Aby wygenerować listę wszystkich języków znanych przez Zend_Locale, z każdą nazwą w oryginalnej formie można skorzystać z poniższego przykładu. Podobnie metody getCountryTranslationList() oraz getCountryTranslation() mogą zostać użyte do utworzenia tabeli mapującej nazwy regionów w języku użytkownika do nazw regionów w innym języku. Aby wyłapać wyjątki spowodowane przez nieistniejące locale należy użyć konstrukcji try .. catch. Nie wszystkie języki stanowią locale. W poniższym przykładzie wyjątki są ignorowane aby zapobiec przedwczesnemu zakończeniu skryptu.

$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;
    }
}

Często może dochodzić do sytuacji, w której niezbędne jest uzyskanie od użytkownika odpowiedzi "tak" lub "nie". Aby uzyskać tablicę zawierającą odpowiednie słowa lub wyrażenia regularne w zależności od określonego locale (domyślnie jest to locale bieżącego obiektu) należy użyć metody getQuestion(). Tablica zwrotna zawiera następujące dane:

Wszystkie powyższe informacje są zlokalizowane. Poniższy przykład przedstawia zestaw danych, jakie można otrzymać:

$locale = new Zend_Locale();
// Łańcuchy ze zgodą oraz odmową
print_r($locale->getQuestion('de'));

- - - Output - - -

Array
(
    [yes] => ja
    [no] => nein
    [yesarray] => Array
        (
            [0] => ja
            [1] => j
        )

    [noarray] => Array
        (
            [0] => nein
            [1] => n
        )

    [yesexpr] => ^([jJ][aA]?)|([jJ]?)
    [noexpr] => ^([nN]([eE][iI][nN])?)|([nN]?)
)

Może nastąpić sytuacja w której niezbędne okaże się uzyskanie listy wszystkich znanych locale. Może to być użyteczne przy wielu czynnościach jak np. utworzenie listy wyboru. Aby to osiągnąć należy użyć statycznej metody getLocaleList().

$localelist = Zend_Locale::getLocaleList();

Jeśli zaistnieje potrzeba rozpoznania czy dana zmienna, niezależnie z jakiego źródła pochodzi, jest poprawnym locale można do tego celu użyć statycznej metody isLocale(). Jej pierwszy parametr to łańcuch znaków do sprawdzenia.

$input = 'to_RU';
if (Zend_Locale::isLocale($input)) {
    print "'{$input}' to poprawne locale";
} else {
    print "Niestety... podana zmienna nie jest poprawnym locale";
}

Jak widać, powyższa metoda zawsze zwraca wartość logiczną. Istnieje jeden powód, który powoduje rzucenie wyjątku w tej metodzie. Dzieje się tak jeśli system operacyjny nie dostarcza żadnego locale a Zend Framework nie jest w stanie go wykryć automatycznie. Często może to oznaczać problem istniejący na styku systemu i środowiska PHP i jego funkcji setlocale().

Należy też zauważyć, iż każdy podany łańcuch locale zostanie automatycznie ograniczony do kodu języka jeśli kod regionu nie jest poprawny. W poprzednim przykładzie kod języka 'to' nie istnieje w regionie 'RU' ale klasa Zend_Locale zwróci TRUE ponieważ możliwe jest dostosowanie podanego stringu do poprawnego locale.

Niekiedy, przydatne może okazać się ograniczenie wyżej opisanego zachowania. W takiej sytuacji należy skorzystać z drugiego parametru metody isLocale(). Parametr strict przyjmuje domyślnie wartość FALSE ale można zadeklarować jego wartość jako TRUE i wyłączyć dostosowywanie przekazanego locale.

$input = 'to_RU';
if (Zend_Locale::isLocale($input, true)) {
    print "'{$input}' to poprawne locale";
} else {
    print "Niestety... podana zmienna nie jest poprawnym locale";
}

Teraz, kiedy możliwe jest rozpoznanie czy określony łańcuch znaków jest poprawnym locale, nic nie stoi na przeszkodzie aby samemu tworzyć klasy świadome locale. Jednak wprowadzając podobne rozwiązanie szybko dochodzi się do wniosku, że implementacja będzie stanowiła bardzo podobne 15 linijek kodu. Przykładowo:

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(
            "The locale '$locale' is no known locale");
    }

    $locale = new Zend_Locale($locale);
}

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

Z nadejściem Zend Framework 1.8 dodano statyczną metodę findLocale(), która zwraca łańcuch znaków zawierający locale. Oto lista jej zadań:

Poniższy przykład pokazuje sposób użycia tej metody zamiast, wcześniej opisanych, kilkunastu linijek:

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