PHPackages                             nniicc/language-switcher - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Localization & i18n](/categories/localization)
4. /
5. nniicc/language-switcher

ActivePackage[Localization & i18n](/categories/localization)

nniicc/language-switcher
========================

Laravel Language Switcher

v0.1(8y ago)1254Apache 2.0PHPPHP >=5.3.0

Since Sep 13Pushed 8y ago1 watchersCompare

[ Source](https://github.com/nniicc/LanguageSwitcher)[ Packagist](https://packagist.org/packages/nniicc/language-switcher)[ Docs](https://github.com/nniicc/LanguageSwitcher)[ RSS](/packages/nniicc-language-switcher/feed)WikiDiscussions master Synced yesterday

READMEChangelogDependenciesVersions (2)Used By (0)

LanguageSwitcher
================

[](#languageswitcher)

Laravel Language Switcher Package

\##Description This package provides an easy to work with language switcher that you can use in your projects with a wide variety of config options. It automatically bootstraps to your Laravel project, sets the locale, and switches the languages when needed.

Configuration provided supports a dynamic array of different options to adjust the functionality of the package to suit your needs, whereas the default provided config will allow you to use the package right after installing, with almost no additional work.

I know it may seem very simple and perhaps over-complicated, but you don't have to waste time and thought process on the simple things.

\##Installation To install the package, just run composer require nniicc/language-switcher and follow the instructions. If you want to add it to your composer.json manually, just open composer.json and search for the "autoload" field and add

```
composer require nniicc/language-switcher

```

After the package is installed, you should run the vendor:publish command in the console so the package publishes its config file to your application. The package should work fine without this step, all config options have fall backs - however it may impact future use, so it is recommended not to skip the vendor:publish command.

```
php artisan vendor:publish

```

To start using the package,you have to include its service provider and middleware in your application. To include the service provider, just go to your `config/app.php` file, find the providers array and append the language switcher provider at the bottom.

```
    'providers' => [
        .
        .
        .
        nniicc\LanguageSwitcher\Providers\LanguageSwitcherProvider::class,
    ],

```

Next, go to `app/Http/Kernel.php` and find the middleware array. You have two options:

1. Register the middleware as a route and use it within your routes, if you only want to use it only for the routes you need it for
2. **Recommended:** Include the middleware within the 'web' middleware group, making it globally available. Not including the middleware will fail to register the locale and the current selected language will not register. Make sure you include the middleware at the end of the array, because it is reliant on Session to work.

```
        'web' => [
            .
            .
            .
            \nniicc\LanguageSwitcher\Middleware\LanguageSwitcherMiddleware::class,
        ],

```

You are now ready to use the language switcher!

\##Usage

The default language set in your app.locale config value will be set. You can find it in the `config/app.php` config file.

Switching the current language can be done in quite a few ways.

1. Using the provided facade: `LanguageSwitcher::setLanguage($language)`
2. Using the provided `/lang/{language}` route. The config file provides flexibility in changing the actual "lang" route. This route can be changed using the [configuration](#configuration).

When using the provided routes for switching languages, you will be redirected to the '/' route after the new language is set.

You should be all set! You can start writing your content in multiple languages! For more information on how to do this, please consult [Laravel's Documentation](https://laravel.com/docs/5.2/localization).

Alternatively, you can set this yourself using your own routes, just set the session value `'language'` to the new locale and redirect.

\##Configuration The package ships with quite a few configuration options:

```
return [
    'switchPath' => 'lang',
    'store' => 'session',
    'key' => 'language',
    'redirect' => 'route', //can be set to route | back
    'redirect_route' => '/',
];

```

The above config options can be used to customize the switcher's functionality, as described below. You are free to use any method to configure the package. Remember to use the publish:vendor command to avoid unexpected issues.

To set options, you can use any of the following methods:

1. Changing the config file `config/languageswitcher.php`, editing the values of the provided keys (recommended)
2. Using laravel's runtime configuration helper - `Config::set()` | `config()->set()`, with the specification that you use the 'languageswitcher' preffix for the keys (eg. `languageswitcher.switchPath` for changing the switch path). #####Changing the switcher's route (default: lang/{language\_flag})

- Config key: `languageswitcher.switchPath`
- Default Value: `lang`

This config setting dynamically sets the route created in the package for switching the language. #####Changing store method - session | cookie (default: session)

- Config key: `languageswitcher.store`
- Default value: `session`
- Accepted values: `session | cookie`

This config setting changes the storage method of the language flag. Default is session, but cookies with forever as expiry date can be used. Initially this was set up as a cookie with a configurable expiry date, but for obvious reasons it was set up to never expire. #####Changing the key where the language flag is stored (default: lang)

- Config key: `languageswitcher.key`
- Default value: `language`

This config setting decides what key to be used when storing the language flag, to the session or cookie. #####Changing the redirect type (default: route redirect to '/')

- Config keys: `languageswitcher.redirect` and `languageswitcher.redirect_route`
- Default value for `languageswitcher.redirect`: `route`
- Accepted values: `route | back`
- Default value for `languageswitcher.redirect_route`: `/`

When the `languageswitcher.redirect` config value is set to route, the user is redirected to the specified `languageswitcher.redirect_route` after the new language flag is set. Setting the `languageswitcher.redirect` to `back` will redirect the user back to the previous page after the new language flag is set. ##Examples My preffered way to usage is this: I include the library, create my UI for switching the language, and start translating!

Example HTML:

```

    {{ trans('locale.en') }}
    {{ trans('locale.dk') }}
    {{ trans('locale.sw') }}

```

If you want to evidentiate the current selection language, you can use App::getLocale() or LanguageSwitcher::getCurrentLanguage(). ##Bugs/Issues/Improvements Feel free to use github for issues and suggesting improvements. ##Additional Information You can find more information on regarding this package on my website, [www.nniicc.com](http://www.nniicc.com).

###  Health Score

25

—

LowBetter than 36% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 77.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

3212d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/5363602?v=4)[Marko Kuhar](/maintainers/nniicc)[@nniicc](https://github.com/nniicc)

---

Top Contributors

[![ied3vil](https://avatars.githubusercontent.com/u/673331?v=4)](https://github.com/ied3vil "ied3vil (27 commits)")[![nniicc](https://avatars.githubusercontent.com/u/5363602?v=4)](https://github.com/nniicc "nniicc (4 commits)")[![erik-ropez](https://avatars.githubusercontent.com/u/1631035?v=4)](https://github.com/erik-ropez "erik-ropez (2 commits)")[![ettiennelouw](https://avatars.githubusercontent.com/u/1754421?v=4)](https://github.com/ettiennelouw "ettiennelouw (2 commits)")

---

Tags

phplaravellanguageswitcher

### Embed Badge

![Health badge](/badges/nniicc-language-switcher/health.svg)

```
[![Health](https://phpackages.com/badges/nniicc-language-switcher/health.svg)](https://phpackages.com/packages/nniicc-language-switcher)
```

###  Alternatives

[codezero/laravel-localized-routes

A convenient way to set up, manage and use localized routes in a Laravel app.

544656.8k4](/packages/codezero-laravel-localized-routes)[ied3vil/language-switcher

Laravel Language Switcher

4544.3k](/packages/ied3vil-language-switcher)[josiasmontag/laravel-redis-mock

This Laravel package provides a Redis mock for your tests

471.8M19](/packages/josiasmontag-laravel-redis-mock)[opgginc/codezero-laravel-localized-routes

A convenient way to set up, manage and use localized routes in a Laravel app.

29109.8k1](/packages/opgginc-codezero-laravel-localized-routes)[awes-io/localization-helper

Package for convenient work with Laravel's localization features

3527.1k4](/packages/awes-io-localization-helper)[josiasmontag/laravel-localization

Localization for Laravel framework

2336.7k](/packages/josiasmontag-laravel-localization)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)