A new project, laravel-lang/locales, has been released

[andrey-helldar]

@Laravel-Lang/laravel-lang, hi guys!

Yesterday I released a new project Laravel Lang: Locales.

It is needed for easy management of localizations. Previously this functionality was inside the Publisher package, which I decided to take outside and add new functionality.

Differences from the "old" version:

Changed namespace for locales list:

// Before
LaravelLang\Publisher\Constants\Locales::AFRIKAANS; // af

// After
LaravelLang\Locales\Enums\Locale::Afrikaans; // af

The name of the cases is aligned with the PER standard.

Also changed aliases section in the configuration file.

New functionality with facade

Before

LaravelLang\Publisher\Facades\Helpers\Locales::available(); // array<string>
// ['en', 'fr', 'de', ...]

LaravelLang\Publisher\Facades\Helpers\Locales::getDefault(); // string
// de-DE

After

LaravelLang\Locales\Facades\Locales::available(); // array<LocaleData>
// [<object>, <object>, ...]

LaravelLang\Locales\Facades\Locales::getDefault(); // LocaleData
// <object>

LaravelLang\Locales\Facades\Locales::raw()->available(); // array<string>
// ['en', 'fr', 'de', ...]

LaravelLang\Locales\Facades\Locales::raw()->getDefault(); // string
// de-DE

<object> is a DTO class of LocaleData:

// Non aliased
LaravelLang\Locales\Data\LocaleData {
  +code: "de"
  +type: "Latn"
  +name: "German"
  +native: "Deutsch"
  +regional: "de_DE"
}

// Aliased
LaravelLang\Locales\Data\LocaleData {
  +code: "de-DE"
  +type: "Latn"
  +name: "German"
  +native: "Deutsch"
  +regional: "de_DE"
}

Conclusion

The current version of the laravel-lang/locales package has no conflicts with any of our existing projects because it has a different namespace. Therefore it is already included in the laravel-lang/common installation of version 4.1.0.

I will soon release version 15 of the publisher where I will replace the internal code to use this package. And that's where it will make critical changes, so the new version of the publisher will be released under the major version increment.

Documentation

• Aliases: https://laravel-lang.com/usage/aliases.html
• Facades: https://laravel-lang.com/usage/features/facades.html

And I've added a new "About" page summarizing exactly what each package does.

Upgrade guide published here.