TLDR; ​

Laravel has great localisation functionality, but it is all based on the locale. The locale only refers to a language, not a country. This package adds the ability to localize based on the country. Why? Mainly because dates dates can be pronounced the same in a language, but be formatted differently in different countries. The package also adds more convenience functions to get localized country names, currency symbols and more.

What is new in version 4? ​

Version 4 is adding Carbon Macros so you can use the LangCountry formatting directly on your Carbon instances. On most IDE's they're also autocompleted for convenience.

Examples ​

session(['lang_country' => 'nl-NL']);
$post->created_at->langCountryDateNumbers(); // Will return "27-09-2023"

// You can also include the time by adding `true` as the second parameter.
$post->created_at->langCountryDateWordsWithDay(false, true); // Will return "Wednesday September 27th 2023 01:05 pm"

session(['lang_country' => 'nl-NL']);
$post->created_at->langCountryDateNumbers(); // Will return "27-09-2023"

// You can also include the time by adding `true` as the second parameter.
$post->created_at->langCountryDateWordsWithDay(false, true); // Will return "Wednesday September 27th 2023 01:05 pm"

Introduction ​

Setting the locale in Laravel is not enough most of the time, some countries use more than one language. Also, different countries use different date notations formats despite their language. Proper localization gives us many challenges. This package will help you out with new tools in your tool belt.

In a nutshell ​

• You can set all supported languages and countries of your choice and make use of all the tools and data that are available in this package.
• It will automatically try to find the best match for the user based on the browser settings when a user first visits your app.
• It has a smart fallback.
• It provides a middleware that will set the locale and the country of the user.
• It provides an (optional) language switcher that is based on countries (with flags) and not only on languages. So for some countries, it will even show multiple languages. (Read more)
• It provides you with date/time helpers.
• It provides you with language helpers
• It provides you with currency helpers.
• It will store the users preferred language and country in the database.
• And more...

I've also written an article about it here.

What will it do? ​

For each user or guest it will create a four character lang_country code. For guests, it will try to make a perfect match based on the browser settings. For users, it will load the last used lang_country, because we will store it in the DB.

There will ALWAYS be two sessions set:

• lang_country (example: nl-BE)
• locale (examples: nl, en, fr, es, de, ...)

When a user will log in to your app, it will load the last lang_country and set the sessions accordingly.