Internacionalización

Resumen

Phalcon está escrito en C como una extensión para PHP. There is a PECL extension that offers internationalization functions to PHP applications called intl. Its documentation can be found in the pages of the official PHP manual.

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

In the examples below, we will show you how to implement the intl extension’s functionality into Phalcon powered applications.

NOTE: This guide is not intended to be a complete documentation of the intl extension. Please visit the documentation of the extension for a reference.

Encontrar la mejor configuración regional disponible (Locale)

There are several ways to find out the best available locale using intl. Una de ellas es verificar la cabecera HTTP Accept-Language:

<?php

use Locale;

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

// 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:

Identifier	Descripción
`en-US`	(English, United States)
`ru-RU`	(Russian, Russia)
`zh-Hant-TW`	(Chinese, Traditional Script, Taiwan)
`fr-CA`, `fr-FR`	(French for Canada and France respectively)

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. The MessageFormatter allows for the production of those messages.

Para visualizar números con formato basado en algunas configuraciones regionales:

<?php

use MessageFormatter;

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

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

// 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

use MessageFormatter;

$time   = time();
$values = [7, $time, $time];

// '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);

// 'À 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

The Collator class provides string comparison capability with support for appropriate locale-sensitive sort orderings. Revise los ejemplos a continuación en el uso de esta clase:

<?php

use Collator;

// Crea un collator usando la localización en español
$collator = new Collator('es');

// Establece que la comparación sea igual, a pesar del acento en la 'o'
$collator->setStrength(Collator::PRIMARY);

var_dump(
    $collator->compare('una canción', 'una cancion')
);

// Establece que las cadenas no sean iguales
$collator->setStrength(Collator::DEFAULT_VALUE);

var_dump(
    $collator->compare('una canción', 'una cancion')
);

Transliteración

Transliterator provides transliteration of strings:

<?php

use Transliterator;

$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