Join 26,000+ Laravel Developers and join the free Laravel Newsletter
Laravel 5.7 Mail Localization Improvements
Laravel 5.7 / updated: December 02, 2018

Laravel 5.7 Mail Localization Improvements

Laravel 5.7.7 is now released and includes both bug fixes and thanks to Derek MacDonald a big improvement to Mail Localization.

With the release of Laravel 5.7 the Illuminate\Notifications\Notification class started offering a locale method to set the desired language. The application will change into this locale when the notification is being formatted and then revert back to the previous locale when formatting is complete. Here is an example of this feature:

$user->notify((new InvoicePaid($invoice))->locale('es'));

Now with Laravel 5.7.7 you can take this a step further and hook directly into a “user” model. In a typical application you might have a “locale” field on the user table and now you can define the User model as follows:

use Illuminate\Contracts\Translation\HasLocalePreference;

class User extends Model implements HasLocalePreference
{
    public function preferredLocale()
    {
        return $this->locale;
    }
}

Now pretend you create a user from Germany:

$user = User::create([
    'email' => '[email protected]',
    'locale' => 'de',
]);

The following four calls will send the notification to the user in German:

$user->notify(new OrderConfirmation($order))
Notification::send($user, new OrderConfirmation($order))
Mail::to($user)->queue(new OrderConfirmation($order)
Mail::to($user)->send(new OrderConfirmation($order)

Of course, if you need to over-ride a user locale preference you can by specifying the locale() like this:

$user->notify((new OrderConfirmation($order))->locale('en'))

As you can see, the inclusion of this feature will allow you to simplify a lot of your code when sending emails to people throughout the world. For complete information on this check out the pull request which includes great documentation and a complete changelog on how it’s implemented.

Laravel News Partners

Newsletter

Join the weekly newsletter and never miss out on new tips, tutorials, and more.