How to install the Intl extension for Twig

Install the PHP intl extension

First of all, you will need the PHP intl extension, as the Twig extension is built on top of that. The Twig Intl extension will throw an Exception if the PHP intl extension is not enabled. Installation instructions can be found in the official PHP documentation.

On Ubuntu/Debian machines, this is as easy as running the following command:

sudo apt install php-intl

On Windows machines, you probably have to uncomment the following line in php.ini:


For CentOS, or other architectures, follow the instructions here. Note that CentOS requires both PECL and the GCC C++ compiler to be installed: yum install php-pear and yum install gcc-c++.

Once the extension is added to php.ini, then restart the web server.

Install the Twig Extensions

Next, you will need the Twig Extensions package (that contains the Intl extension, among others), which can be installed using Composer. Run this command in the command line:

composer require twig/extensions

This will add the dependency to your composer.json and download it.

Note: the localizednumber and localizedcurrency filters were introduced in version 1.2.0, so you need at least that version if you want to use them.

Adding the extension to Twig

If you are using Twig directly (i.e. not in a Symfony project), add the extension to the Twig environment manually:


use Twig\Environment;
use Twig\Extensions\IntlExtension;

$twig = new Environment($loader);
$twig->addExtension(new IntlExtension());

Adding the extension to Twig (in Symfony)

If you are using a Symfony application, you can add the extension to Twig by creating a service and tagging it as a Twig extension in config/services.yml:

        class: Twig\Extensions\IntlExtension
            - { name: twig.extension }

Setting the default locale



Setting the default locale in Symfony

In config/framework.yaml, uncomment the default_locale setting:

    default_locale: en

Leave a Comment