Laravel 5.7 Mail Localization Improvements

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' => 'hello@example.org',
    '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.


Filed in: Laravel 5.7


Newsletter

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

Laravel News Partners

Laravel Jobs

Software Engineer Lead (PHP)
Remote
CivicPlus, LLC
Full-time Senior Web Developer
Detroit, MI
Wayne State University
Senior Software Engineer
Sydney, Australia
FoodByUs
Full Stack Engineer
Remote or Medford, Oregon
Empire Medical
Laravel Developer (fulltime - Dutch only)
Netherlands
Qbixx | Webservices
Full Stack or Back-End Developer
Alexandria, VA; Tallahassee, FL; Orlando, FL
Marketing for Change
Senior Quality Assurance Engineer
Remote
Bisnow Media