Sections

Internacionalización


Preámbulo

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. 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 significaría 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.

Esta guía no pretende ser una documentación completa de la extensión intl. Por favor visita la documentación oficial de la extensión como referencia.

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

use Locale;

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

// Locale could be something like 'en_GB' or '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 (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

Part of creating a localized application is to produce concatenated, language-neutral messages. El MessageFormatter permite generar estos mensajes.

Printing numbers formatted based on some locale:

<?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);

Locale-Sensitive comparison

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;

// Create a collator using Spanish locale
$collator = new Collator('es');

// Returns that the strings are equal, in spite of the emphasis on the 'o'
$collator->setStrength(Collator::PRIMARY);

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

// Returns that the strings are not equal
$collator->setStrength(Collator::DEFAULT_VALUE);

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

Transliteration

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