Cover of the book Symfony 5: The Fast Track

Symfony 5: The Fast Track is the best book to learn modern Symfony development, from zero to production. +300 pages showcasing Symfony with Docker, APIs, queues & async tasks, Webpack, SPAs, etc.

  1. Home
  2. Documentation
  3. Components
  4. The Locale Component
WARNING: You are browsing the documentation for Symfony 2.1 which is not maintained anymore. Consider upgrading your projects to Symfony 5.2.

The Locale Component

2.1 version
Unmaintained
2.0 2.1 2.2

The Locale Component

Locale component provides fallback code to handle cases when the intl extension is missing. Additionally it extends the implementation of a native Locale class with several handy methods.

Replacement for the following functions and classes is provided:

Note

Stub implementation only supports the en locale.

Installation

You can install the component in 2 different ways:

Usage

Taking advantage of the fallback code includes requiring function stubs and adding class stubs to the autoloader.

When using the ClassLoader component following code is sufficient to supplement missing intl extension:

1
2
3
4
5
6
7
if (!function_exists('intl_get_error_code')) {
    require __DIR__.'/path/to/src/Symfony/Component/Locale/Resources/stubs/functions.php';

    $loader->registerPrefixFallbacks(
        array(__DIR__.'/path/to/src/Symfony/Component/Locale/Resources/stubs')
    );
}

Symfony\Component\Locale\Locale class enriches native Locale class with additional features:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
use Symfony\Component\Locale\Locale;

// Get the country names for a locale or get all country codes
$countries = Locale::getDisplayCountries('pl');
$countryCodes = Locale::getCountries();

// Get the language names for a locale or get all language codes
$languages = Locale::getDisplayLanguages('fr');
$languageCodes = Locale::getLanguages();

// Get the locale names for a given code or get all locale codes
$locales = Locale::getDisplayLocales('en');
$localeCodes = Locale::getLocales();

// Get ICU versions
$icuVersion = Locale::getIntlIcuVersion();
$icuDataVersion = Locale::getIcuDataVersion();

This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.