zagovorichev/laravel-languages

Using different languages in the Laravel

Multi language Laravel Plugin

This package pulls in the framework agnostic Language Manager and provides seamless integration with Laravel 5., _(*1)

• What is it?
• Installation
• Usage
• Requirements
• License

What is it?

Language manager: you can choose new language and it will be placed as App::setLocale($lang), _(*2)

Language will be saved in SESSION and/or COOKIE, _(*3)

Also you can use URL, _(*4)

http://www.example.com/article/1?lang=en => http://en.example.com/en/article/1 

Installation

composer require zagovorichev/laravel-languages, _(*5)

Add to the app.php (by default in /laravel/config/app.php) lines:, _(*6)

'providers' => [
    // ...
    Zagovorichev\Laravel\Languages\LanguageServiceProvider::class,
]

And new middleware into the Kernel.php (look in /laravel/app/Http/Kernel.php), _(*7)

protected $middlewareGroups = [
        'web' => [
            // ...
            \Zagovorichev\Laravel\Languages\Http\Middleware\LanguagesMiddleware\LanguagesMiddleware::class,
        ],
    ];

Usage

Language manager provides working with sessions, cookies, path and domain., _(*8)

For changing system language send request with input lang. For example: ?lang=es and in application you will have Spain locale., _(*9)

All configurations stored in the languages.php file.
For making your own configuration copy file /laravel/vendor/zagovorichev/laravel-languages/config/languages.php to the folder /laravel/config/., _(*10)

Simple usage (SESSION + COOKIE)

If you need simple language manager you can use only 'session' and 'cookie' modes. Then you don't need to configure anything more., _(*11)

Domain Map

For using DomainMapManger in your configuration file you should matched languages and domains, _(*12)

'domainMap' => [
    'en' => 'www.example.com',
    'es' => 'es.example.com',
    'ua' => 'www.example.ua',
],

:warning: Notice: Please, use only DomainMap or Domain modes, otherwise the behaviour will be unpredictable., _(*13)

Domain

Also you can provide regular expression in the configuration file., _(*14)

'domainRegExp' => [
    'reg' => '|^(http://)([a-z]{2})[\.]{0,1}(example\.com.*)$|ui',
    'langPart' => 2,
]

And as a result you will have http://www.example.en/post/234 => http://en.example.com/post/234 => http://es.example.com/post/234, _(*15)

:warning: Notice: Please, use only DomainMap or Domain modes, otherwise the behaviour will be unpredictable., _(*16)

Path

Similar to domains, you can provide regular expression:, _(*17)

'pathRegExp' => [
     'reg' => '|([a-z]{2})(/.*)|ui',
     'langPart' => 1, // lang part will be replaced with new lang
 ],

Modes of the languages manager

Each store has its own manager., _(*18)

• session - store in the $_SESSION
• cookie - store in the browser $_COOKIES
• domainMap - you can define map if you have different domain which can't be described with simple regular expression
• domain - use domain name for determining current language (www.example.com, en.example.com, es.example.com...)
• path - use uri for language example.com/en/address

Requirements

• PHP 5.6
• Laravel 5.3

License

This package is licensed under the MIT license, _(*19)