folklore/laravel-locale

Localization package for Laravel 5

v8.0.6 2022-02-23 16:35 UTC

Requires

• php: ^7.3|^8.0.2
• illuminate/support: 8.*|9.*

Requires (Dev)

• fakerphp/faker: ^1.9.1
• mockery/mockery: ^1.4.2
• orchestra/testbench: 6.*|7.*
• php-coveralls/php-coveralls: ^2.4
• phpunit/phpunit: ^9.5.10

MIT

• Folklore
• David Mongeau-Petitpas

• framework
• translation
• locale
• laravel
• localization

README

A simple localization package for Laravel 5. It provides URL detection, Route parameters, session storage, and view sharing.

Installation

Dependencies:

Version prior to 3.0

• Laravel <= 5.7

Version 3.0 and up

• Laravel >= 5.5

Installation:

1- Require the package via Composer in your composer.json.

{
	"require": {
		"folklore/laravel-locale": "~3.0"
	}
}

2- Run Composer to install or update the new requirement.

$ composer install

or

$ composer update

3- Add the service provider to your app/config/app.php file

\Folklore\LaravelLocale\LocaleServiceProvider::class,

5- Publish the configuration file

$ php artisan vendor:publish --provider="Folklore\LaravelLocale\LocaleServiceProvider"

6- Review the configuration file

config/locale.php

Usage

Define route locale

You can specify the locale of a specific routes:

Route::get('/fr', [
  'as' => 'home.fr',
  'locale' => 'fr',
  function()
  {
    return view('home');
  }
]);

Auto-detection from URL

It is possible to let the package auto-detect the locale from the first part fo the URL.

Route::get('/fr/a-propos', [
  'as' => 'about.fr',
  function()
  {
    return view('home');
  }
]);

Be sure to add the supported locales in config/locale.php

View sharing

By default, this package shares two variables to every views $locale and $otherLocales. The $otherLocales variable is an array containing all the other locales than the current one.