webident / laravel-intl
Easy to use internationalization functions for Laravel
Requires
- php: >=5.5.0
- commerceguys/intl: ^0.7.3
- jenssegers/date: ^3.2
- laravel/framework: ^5.0
Requires (Dev)
- orchestra/testbench: ^3.0
- phpunit/phpunit: ^4.0|^5.0
This package is auto-updated.
Last update: 2025-06-04 18:19:48 UTC
README
Easy to use internationalization functions for Laravel 5 based on various libraries for easy retrieval of localized values and formatting of numeric values into their localized patterns.
Overview
Installation
Run the following command to install the latest version of the package
composer require webident/laravel-intl
In your app config, add the Service Provider to the $providers
array
'providers' => [ ... Webident\LaravelIntl\IntlServiceProvider::class, ],
Usage
Note: always use the helper functions or Facades.
Country
Output localized country names.
use Webident\LaravelIntl\Facades\Country; // Application locale: en Country::name('US'); // United States Country::currency('US'); // USD Country::all(); // ['US' => 'United States', 'BE' => 'Belgium', ...] // Application locale: nl Country::name('US'); // Verenigde Staten Country::all(); // ['US' => 'Verenigde Staten', 'BE' => 'België', ...]
// Application locale: en country('US'); // United States country()->currency('US'); // USD country()->all(); // ['US' => 'United States', 'BE' => 'Belgium', ...]
Currency
Output localized currency names and format currency amounts into their localized pattern.
use Webident\LaravelIntl\Facades\Currency; // Application locale: en Currency::name('USD'); // US Dollar Currency::symbol('USD'); // $ Currency::format(1000, 'USD'); // $1,000.00 Currency::formatAccounting(-1234, 'USD'); // ($1,234.00) Currency::all(); // ['USD' => 'US Dollar', 'EUR' => 'Euro', ...] // Application locale: nl Currency::name('USD'); // Amerikaanse dollar Currency::format(1000, 'USD'); // $ 1.000,00 Currency::formatAccounting(-1234, 'USD'); // (US$ 1.234,00) Currency::all(); // ['USD' => 'Amerikaanse dollar', 'EUR' => 'Euro', ...]
// Application locale: en currency('USD'); // US Dollar currency(1000, 'USD'); // $1,000.00 currency()->symbol('USD'); // $ currency()->all(); // ['USD' => 'US Dollar', 'EUR' => 'Euro', ...]
Parse localized values into native PHP numbers.
use Webident\LaravelIntl\Facades\Currency; // Application locale: nl Currency::parse('€ 1.234,50'); // 1234.5
// Application locale: nl currency()->parse('€ 1.234,50'); // 1234.5
Date
Output localized dates.
Use the Facade (Webident\LaravelIntl\Facades\Carbon
) or the helper function (carbon()
) as if it were Carbon.
Language
Output localized language names.
use Webident\LaravelIntl\Facades\Language; // Application locale: en Language::name('en'); // English Language::all(); // ['en' => 'English', 'nl' => 'Dutch', ...] // Application locale: nl Language::name('en'); // Engels Language::all(); // ['en' => 'Engels', 'nl' => 'Nederlands', ...]
// Application locale: en language('en'); // English language()->all(); // ['en' => 'English', 'nl' => 'Dutch', ...]
Number
Output localized numeric values into their localized pattern.
use Webident\LaravelIntl\Facades\Number; // Application locale: en Number::format(1000); // 1,000 Number::percent(75); // 75% // Application locale: fr Number::format(1000); // 1 000 Number::percent(75); // 75 %
// Application locale: en number(1000); // 1,000 number()->percent(75); // 75%
Parse localized values into native PHP numbers.
use Webident\LaravelIntl\Facades\Number; // Application locale: fr Number::parse('1 000'); // 1000 Number::parse('1,5'); // 1.5
// Application locale: fr number()->parse('1 000'); // 1000 number()->parse('1,5'); // 1.5
Changing locales
Ever feel the need to use a locale other than the current application locale? You can temporarily use another locale by using the forLocale()
method.
country()->name('US'); // United States country()->forLocale('nl', function($country) { return $country->name('US'); }); // Verenigde Staten country()->name('US'); // United States
Alternatively, you can force each component individually to the preferred locale for the rest of the application by calling the setLocale()
on the helper function or Facade.
Usually you'd set this in the boot()
method of a ServiceProvider.
country()->setLocale($locale); currency()->setLocale($locale); carbon()->setLocale($locale); language()->setLocale($locale); number()->setLocale($locale); country()->setFallbackLocale($locale); currency()->setFallbackLocale($locale); carbon()->setFallbackLocale($locale); language()->setFallbackLocale($locale); number()->setFallbackLocale($locale);