Download the PHP package longman/laravel-multilang without Composer

Laravel 5.x MultiLanguage

This version of MultiLang package requires minimum PHP 7.0. For older PHP versions use MultiLang 1.x

This is a very useful package to integrate multi language (multi locale) functionality in Laravel 5.x. It includes a ServiceProvider to register the multilang and Middleware for automatic modification routes like http://site.com/en/your-routes.

This package uses database for storing translations (it caches data on production environment for improving performance) Also package automatically adds in database missing keys (on the local environment only).

Table of Contents

• Installation
• Usage
  • Translating
  • Blade Templates
  • URL Generation
  • Text Scopes
  • Import/Export Texts
• TODO
• Troubleshooting
• Contributing
• License
• Credits

Installation

Install this package through Composer.

Edit your project's composer.json file to require longman/laravel-multilang

Create composer.json file:

And run composer update

Or run a command in your command line:

composer require longman/laravel-multilang

In Laravel the service provider and facade will automatically get registered.

Copy the package config to your local config with the publish command:

php artisan vendor:publish --provider="Longman\LaravelMultiLang\MultiLangServiceProvider"

After run multilang migration command

php artisan multilang:migration

Its creates multilang migration file in your database/migrations folder. After you can run

php artisan migrate

Also if you want automatically change locale depending on url (like http://site.com/en/your-routes) you must add middleware in app/Http/Kernel.php

I suggest add multilang after CheckForMaintenanceMode middleware

In your RoutesServiceProvider modify that:

or directly in app/Http/routes.php file add multilang group:

Or if you want only translate strings without automatic resolving locale and redirect, you can manually set locale in your application like:

Usage

Translating

Everywhere in application you can use t() helper function like:

You can use markers for dynamic texts and pass any data like

which will be return The Start Date must be a date after 7 April 1986.

Blade Templates

In blade templates you can use just @t() notation like

which is equivalent to {{ t('Your translatable string') }}

URL Generation

Also you can use lang_url() helper function for appending current lang marker in urls automatically.

You can force locale and get localized url for current url for example.

or

Also you use named routes via lang_route() function

Also Request::locale() always will return current locale.

Note: Texts will be selected after firing Laravel's LocaleUpdated event. Therefore you should use MultiLang middleware, or manually set locale in the application.

Text Scopes

If you want group translations by some scope, in package available defining of scopes. For example to define scope admin in application, you should call:

before setting the locale.

Note: Default scope is global

Import/Export Texts

For versioning texts with source code (git/svn) and easy management, there is possible import texts from yml file and also export in the file.

yml file format is:

Run commands for possible options and more information:

php artisan help multilang:import

php artisan help multilang:export

TODO

write more tests

Troubleshooting

If you like living on the edge, please report any bugs you find on the laravel-multilang issues page.

Contributing

Pull requests are welcome. See CONTRIBUTING.md for information.

License

Please see the LICENSE included in this repository for a full copy of the MIT license, which this project is licensed under.

Credits

• Avtandil Kikabidze aka LONGMAN

Full credit list in CREDITS