Utilice la clonación de objetos para duplicar un objeto locale de forma exacta y eficiente. La mayoría de los métodos que dependen de la locale también aceptan representaciones en cadena de las locales, como el resultado de $locale->toString().

$locale = new Zend_Locale('ar');

// Save the $locale object as a serialization
$serializedLocale = $locale->serialize();
// re-create the original object
$localeObject = unserialize($serializedLocale);

// Obtain a string identification of the locale
$stringLocale = $locale->toString();

// Make a cloned copy of the $local object
$copiedLocale = clone $locale;

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

// PHP automatically calls toString() via __toString()
print "copied: ", $copiedLocale;

Zend_Locale también proporciona una función de conveniencia para comparar dos locales. Todas las clases que dependen de la locale deberían proporcionar una comprobación de igualdad similar.

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

// Check if locales are equal
if ($locale->equals($mylocale)) {
    print "Locales are equal";
}

El método getDefault() devuelve un array de locales relevantes utilizando información del navegador del usuario (si está disponible), información del entorno del servidor anfitrión y la configuración de Zend Framework. Al igual que con el constructor de Zend_Locale, el primer parámetro selecciona una preferencia de qué información considerar primero (BROWSER, ENVIRONMENT o FRAMEWORK. El segundo parámetro alterna entre devolver todas las locales coincidentes o solo la primera o la mejor coincidencia. Los componentes que dependen de la locale normalmente usan solo la primera locale. Se incluye una valoración de calidad, cuando está disponible.

$locale = new Zend_Locale();

// Return all default locales
$found = $locale->getDefault();
print_r($found);

// Return only browser locales
$found2 = $locale->getDefault(Zend_Locale::BROWSER,TRUE);
print_r($found2);

Para obtener solamente las locales por defecto relevantes para BROWSER, ENVIRONMENT o FRAMEWORK, utilice el método correspondiente:

Se puede establecer una nueva locale con la función setLocale(). Esta función toma una cadena de locale como parámetro. Si no se proporciona ninguna locale, se selecciona automáticamente una locale.

$locale = new Zend_Locale();

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

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

Utilice getLanguage() para obtener una cadena que contiene el código de idioma de dos caracteres a partir del identificador de locale en forma de cadena. Utilice getRegion() para obtener una cadena que contiene el código de región de dos caracteres a partir del identificador de locale en forma de cadena.

$locale = new Zend_Locale();

// if locale is 'de_AT' then 'de' will be returned as language
print $locale->getLanguage();

// if locale is 'de_AT' then 'AT' will be returned as region
print $locale->getRegion();

Cuando solo dispone del territorio o país, también es posible obtener una locale a partir de esa información. Puede buscar manualmente si existe una locale para ese territorio utilizando getLocaleToTerritory(). Este método devuelve una locale para el territorio dado o NULL cuando no se ha encontrado ninguna locale.

$locale = Zend_Locale::getLocaleToTerritory('US');
// returns 'en_US'

Territorios en mayúsculas

Cuando sepa que está utilizando un territorio, debería escribirlo en mayúsculas. De lo contrario, podría obtener, a sus ojos, una locale falsa al usar otros métodos. Por ejemplo: cuando indica "om", entonces getLocaleToTerritory() le devuelve "ar_OM", ya que sabe que se refiere a un territorio. Pero todos los demás métodos devolverán "om", ya que también es un idioma. Así que cuando sepa que la cadena dada es un territorio, use getLocaleToTerritory() usted mismo antes de crear una locale, o escriba la entrada en mayúsculas.

getTranslationList() le da acceso a información localizada de varios tipos. Esta información es útil si desea mostrar datos localizados a un cliente sin necesidad de traducirlos. Ya están disponibles para su uso.

La lista de información solicitada siempre se devuelve como un array con nombre. Si desea proporcionar más de un valor para un tipo explícito del cual desea recibir valores, tiene que proporcionar un array en lugar de varios valores.

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

print_r ($list);
// example key -> value pairs...
// [de] -> Deutsch
// [en] -> Englisch

// use one of the returned key as value for the getTranslation() method
// of another language
print Zend_Locale::getTranslation('de', 'language', 'zh');
// returns the translation for the language 'de' in chinese

Puede recibir esta información para todos los idiomas. Pero no toda la información está completamente disponible para todos los idiomas. Algunos de estos tipos también están disponibles a través de una función propia por simplicidad. Consulte esta lista para obtener información detallada.

Si necesita un único valor traducido, puede usar el método getTranslation(). Siempre devuelve una cadena, pero acepta algunos tipos diferentes que el método getTranslationList(). El valor también es el mismo que antes, con una diferencia. Debe indicar el detalle que desea que se devuelva como valor adicional.

	Nota
	Dado que casi siempre debe indicar un valor como detalle, este parámetro debe darse como primer parámetro. Esto difiere del método getTranslationList().

Consulte la siguiente tabla para obtener información detallada:

	Nota
	Con Zend Framework 1.5 se han renombrado varios tipos antiguos. Esto se ha hecho debido a varios tipos nuevos, algunos errores ortográficos y para aumentar la usabilidad. Consulte esta tabla para ver una lista de los tipos antiguos a nuevos:

El siguiente ejemplo demuestra cómo obtener los nombres de las cosas en diferentes idiomas.

// prints the names of all countries in German language
print_r(Zend_Locale::getTranslationList('country', 'de'));

El siguiente ejemplo muestra cómo encontrar el nombre de un idioma en otro idioma, cuando no se conoce el código de país iso de dos letras.

$code2name = Zend_Locale::getLanguageTranslationList('en_US');
$name2code = array_flip($code2name);
$frenchCode = $name2code['French'];
echo Zend_Locale::getLanguageTranslation($frenchCode, 'de_AT');
// output is the German name of the French language

Para generar una lista de todos los idiomas conocidos por Zend_Locale, con cada nombre de idioma mostrado en su propio idioma, pruebe el siguiente ejemplo en una página web. De forma similar, getCountryTranslationList() y getCountryTranslation() podrían usarse para crear una tabla que asocie los nombres de las regiones en su idioma nativo con los nombres de las regiones mostrados en otro idioma. Use un bloque try .. catch para manejar excepciones que ocurren al usar una locale que no existe. No todos los idiomas son también locales. En el ejemplo siguiente se ignoran las excepciones para evitar una terminación anticipada.

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

Con frecuencia, los programas necesitan solicitar una respuesta de "sí" o "no" al usuario. Use getQuestion() para obtener un array que contiene la(s) palabra(s) correcta(s) o cadenas de expresión regular a usar para preguntar al usuario en una $locale particular (por defecto la locale del objeto actual). El array devuelto contendrá la siguiente información:

Toda esta información está, por supuesto, localizada y depende de la locale establecida. Vea el siguiente ejemplo para la información que puede recibir:

$locale = new Zend_Locale();
// Question strings
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]?)
)

	Nota
	Hasta la 1.0.3 yesabbr de los datos de locale subyacentes también estaba disponible. Desde la 1.5 esta información ya no está disponible de forma independiente, pero encontrará la información dentro de yesarray.

A veces querrá obtener una lista de todas las locales conocidas. Esto se puede usar para varias tareas, como la creación de un cuadro de selección. Para este propósito puede usar el método estático getLocaleList(), que devolverá una lista de todas las locales conocidas.

$localelist = Zend_Locale::getLocaleList();

	Nota
	Tenga en cuenta que las locales se devuelven como clave del array que recibirá. El valor siempre es un booleano TRUE.

Cuando desee detectar si una entrada dada, independientemente de su origen, es una locale, debe usar el método estático isLocale(). El primer parámetro de este método es la cadena que desea comprobar.

$input = 'to_RU';
if (Zend_Locale::isLocale($input)) {
    print "'{$input}' is a locale";
} else {
    print "Sorry... the given input is no locale";
}

Como puede ver, la salida de este método siempre es un booleano. Solo hay una razón por la que podría obtener una excepción al llamar a este método. Cuando su sistema no proporciona ninguna locale y Zend Framework no puede detectarla automáticamente. Normalmente esto indica que hay un problema con su sistema operativo en combinación con el setlocale() de PHP.

También debe tener en cuenta que cualquier cadena de locale dada se degradará automáticamente si la parte de región no existe para esta locale. En nuestro ejemplo anterior, el idioma 'to' no existe en la región 'RU', pero aun así obtendrá TRUE como resultado, ya que Zend_Locale puede trabajar con la entrada dada.

Aun así, a veces es útil evitar esta degradación automática, y aquí es donde entra en juego el segundo parámetro de isLocale(). El parámetro strict por defecto es FALSE y se puede usar para evitar la degradación cuando se establece en TRUE.

$input = 'to_RU';
if (Zend_Locale::isLocale($input, true)) {
    print "'{$input}' is a locale";
} else {
    print "Sorry... the given input is no locale";
}

Ahora que puede detectar si una cadena dada es una locale, podría agregar un comportamiento consciente de la locale a sus propias clases. Pero pronto notará que esto siempre lleva a las mismas 15 líneas de código. Algo como el siguiente ejemplo:

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

Con Zend Framework 1.8 agregamos un método estático findLocale() que devuelve una cadena de locale con la que puede trabajar. Procesa las siguientes tareas:

El siguiente ejemplo muestra cómo estas comprobaciones y el código anterior se pueden simplificar con una única llamada:

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