Internacionalización

Phalcon está escrito en C como una extensión para PHP. Hay una extensión PECL que ofrece funciones de internacionalización a las aplicaciones de PHP llamados intl. A partir de PHP 5.4/5.5 esta extensión está integrada en PHP. Su documentación puede encontrarse en las páginas del manual de PHP oficial.

Phalcon no ofrece esta funcionalidad, ya que crear un componente como este, significa duplicar código que ya existe.

En los ejemplos que se muestran a continuación, se indica cómo implementar la funcionalidad de la extensión intl en aplicaciones con Phalcon.

Encontrar la mejor configuración regional disponible (Locale)

Hay varias maneras de descubrir la mejor configuración regional disponible utilizando intl. Una de ellas es verificar la cabecera HTTP Accept-Language:

<?php

$locale = Locale::acceptFromHttp($_SERVER['HTTP_ACCEPT_LANGUAGE']);

// La configuración Locale puede ser algo como 'en_GB' o 'en'
echo $locale;

A continuación, el método devuelve una configuración regional identificada. Se usa para obtener un lenguaje, cultura o comportamiento regional específico de la API de configuración regional.

Los ejemplos de identificadores incluyen:

  • en-US (Inglés, Estados Unidos)
  • ru-RU (Ruso, Rusia)
  • zh-Hant-TW (Chino, escritura tradicional, Taiwán)
  • fr-CA, fr-FR (Francés para Canadá y Francia respectivamente)

Formato de mensajes basados en la configuración regional (Locale)

Parte de la creación de una aplicación regionalizada es producir, mensajes enlazados que sean neutros al idioma. El MessageFormatter permite generar estos mensajes.

Visualizar números con formato basado en algunas configuraciones regionales:

<?php

// Visualiza € 4 560
$formatter = new MessageFormatter('fr_FR', '€ {0, number, integer}');
echo $formatter->format([4560]);

// Visualiza USD$ 4,560.5
$formatter = new MessageFormatter('en_US', 'USD$ {0, number}');
echo $formatter->format([4560.50]);

// Visualiza ARS$ 1.250,25
$formatter = new MessageFormatter('es_AR', 'ARS$ {0, number}');
echo $formatter->format([1250.25]);

Formato de mensajes utilizando patrones de fecha y hora:

<?php

// Configurar parámetros
$time   = time();
$values = [7, $time, $time];

// Visualiza 'At 3:50:31 PM on Apr 19, 2015, there was a disturbance on planet 7.'
$pattern   = 'At {1, time} on {1, date}, there was a disturbance on planet {0, number}.';
$formatter = new MessageFormatter('en_US', $pattern);
echo $formatter->format($values);

// Muestra 'À 15:53:01 le 19 avr. 2015, il y avait une perturbation sur la planète 7.'
$pattern   = 'À {1, time} le {1, date}, il y avait une perturbation sur la planète {0, number}.';
$formatter = new MessageFormatter('fr_FR', $pattern);
echo $formatter->format($values);

Comparación sensitiva para la configuración regional

La clase Collator proporciona capacidad de comparación de cadenas con el soporte de ordenamientos sensible a la configuración regional. Revise los ejemplos a continuación en el uso de esta clase:

<?php

// Crear un Collator utilizando la localización en Español
$collator = new Collator('es');

// Retorna que los strings son iguales, a pesar del acento en la 'o'
$collator->setStrength(Collator::PRIMARY);
var_dump($collator->compare('una canción', 'una cancion'));

// Retorna que los strings no son iguales
$collator->setStrength(Collator::DEFAULT_VALUE);
var_dump($collator->compare('una canción', 'una cancion'));

Transcripción

Transliterator proporciona la transcripción de strings:

<?php

$id = 'Any-Latin; NFD; [:Nonspacing Mark:] Remove; NFC; [:Punctuation:] Remove; Lower();';
$transliterator = Transliterator::create($id);

$string = "garçon-étudiant-où-L'école";
echo $transliterator->transliterate($string); // garconetudiantoulecole