国际化（Internationalization）

Phalcon is written in C as an extension for PHP. There is a PECL extension that offers internationalization functions to PHP applications called intl. Starting from PHP 5.4/5.5 this extension is bundled with PHP. Its documentation can be found in the pages of the official PHP manual.

Phalcon does not offer this functionality, since creating such a component would be replicating existing code.

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

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

匹配最佳的区域设置（Find out best available Locale）

There are several ways to find out the best available locale using intl. One of them is to check the HTTP “Accept-Language” header:

  1. <?php
  3. $locale = Locale::acceptFromHttp($_SERVER["HTTP_ACCEPT_LANGUAGE"]);
  5. // Locale could be something like "en_GB" or "en"
  6. echo $locale;

Below method returns a locale identified. It is used to get language, culture, or regionally-specific behavior from the Locale API.

Examples of identifiers include:

  • 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)

基于区域设置格式化信息（Formatting messages based on Locale）

Part of creating a localized application is to produce concatenated, language-neutral messages. The MessageFormatter allows for the production of those messages.

Printing numbers formatted based on some locale:

  1. <?php
  3. // Prints € 4 560
  4. $formatter = new MessageFormatter("fr_FR", "€ {0, number, integer}");
  5. echo $formatter->format([4560]);
  7. // Prints USD$ 4,560.5
  8. $formatter = new MessageFormatter("en_US", "USD$ {0, number}");
  9. echo $formatter->format([4560.50]);
  11. // Prints ARS$ 1.250,25
  12. $formatter = new MessageFormatter("es_AR", "ARS$ {0, number}");
  13. echo $formatter->format([1250.25]);

Message formatting using time and date patterns:

  1. <?php
  3. // Setting parameters
  4. $time   = time();
  5. $values = [7, $time, $time];
  7. // Prints "At 3:50:31 PM on Apr 19, 2015, there was a disturbance on planet 7."
  8. $pattern   = "At {1, time} on {1, date}, there was a disturbance on planet {0, number}.";
  9. $formatter = new MessageFormatter("en_US", $pattern);
  10. echo $formatter->format($values);
  12. // Prints "À 15:53:01 le 19 avr. 2015, il y avait une perturbation sur la planète 7."
  13. $pattern   = "À {1, time} le {1, date}, il y avait une perturbation sur la planète {0, number}.";
  14. $formatter = new MessageFormatter("fr_FR", $pattern);
  15. echo $formatter->format($values);

特定区域设置的字符串比较（Locale-Sensitive comparison）

The Collator class provides string comparison capability with support for appropriate locale-sensitive sort orderings. Check the examples below on the usage of this class:

  1. <?php
  3. // Create a collator using Spanish locale
  4. $collator = new Collator("es");
  6. // Returns that the strings are equal, in spite of the emphasis on the "o"
  7. $collator->setStrength(Collator::PRIMARY);
  8. var_dump($collator->compare("una canción", "una cancion"));
  10. // Returns that the strings are not equal
  11. $collator->setStrength(Collator::DEFAULT_VALUE);
  12. var_dump($collator->compare("una canción", "una cancion"));

音译（Transliteration）

Transliterator provides transliteration of strings:

  1. <?php
  3. $id = "Any-Latin; NFD; [:Nonspacing Mark:] Remove; NFC; [:Punctuation:] Remove; Lower();";
  4. $transliterator = Transliterator::create($id);
  6. $string = "garçon-étudiant-où-L'école";
  7. echo $transliterator->transliterate($string); // garconetudiantoulecole