Back to Blog

Non-backed Enums in Database Queries and a withSchedule() bootstrap method in Laravel 11.1

Julian Beaujardin
Julian Beaujardin Reference: Laravel News March 26th, 2024

This week, the Laravel team released v11.1 with a withSchedule bootstrap method, non-backed Enums in query builder, SES list management options, and more. Laravel 11.1 is the first minor version release since the GA of Laravel 11, released earlier this month.

Add withSchedule to Application Bootstrap

Nuno Maduro contributed a withSchedule method to the bootstrap/app.php file:

->withSchedule(function ($schedule) {
    $schedule->command('backup:database')->daily();
})

List management options added to SES Mail Transport

Ariful Alam contributed the ability to use SES's subscription management features while using the SES mail transport. You can define the following header in the headers() method of a mail message:

/**
 * Get the message headers.
 */
public function headers(): Headers
{
    return new Headers(
        text: [
            'X-Ses-List-Management-Options' => 'contactListName=MyContactList;topicName=MyTopic',
        ],
    );
}

This SES header automatically enables unsubscribe links in every outgoing email you specify the contact list and topic. If a user unsubscribes, SES does not allow email sending. See Laravel's SES driver documentation for further details.

Accept Non-backed Enums in Database Queries

Giorgio Balduzzi contributed the ability to use non-backed enums in database queries. Casting Eloquent attributes is already possible. However, using non-backed enums with the query builder was not possible.

enum Status
{
    case Active;
    case Archive;
}

class User extends Model
{
  protected $casts = [
    'status' => Status::class,
  ];
}


User::where('status', Status::Active)->get();
User::update([ 'status' => Status::Archive]);

Queries automatically cast each non-backed enum case to the name value.

Conditionable Trait Added to Context

Michael Nabil contributed adding the Conditionable trait to Laravel's new Context Facade. This allows for conditionally setting context and also defining default values when false or true depending on the conditionable method:

Context::when(
    auth()->user()->isAdmin(),
    fn ($context) => $context->add('user', ['key' => 'other data', ...auth()->user()]),
    fn ($context) => $context->add('user', auth()->user()),
);

Release notes

You can see the complete list of new features and updates below and the diff between 11.0.0 and 11.1.0 on GitHub. The following release notes are directly from the changelog