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

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 documentationfor 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.

Now, you can pass these enums to queries as of Laravel 11.1:

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:

#v11.1.0

• [11.x] MySQL transaction isolation level fix by @mwikberg-virta in https://github.com/laravel/framework/pull/50689
• [11.x] Add ListManagementOptions in SES mail transport by @arifszn in https://github.com/laravel/framework/pull/50660
• [11.x] Accept non-backed enum in database queries by @gbalduzzi in https://github.com/laravel/framework/pull/50674
• [11.x] Add Conditionable trait to Context by @michaelnabil230 in https://github.com/laravel/framework/pull/50707
• [11.x] Adds [@throws](https://github.com/throws) section to the Context's doc blocks by @rnambaale in https://github.com/laravel/framework/pull/50715
• [11.x] Test modifying nullable columns by @hafezdivandari in https://github.com/laravel/framework/pull/50708
• [11.x] Introduce HASH_VERIFY env var by @valorin in https://github.com/laravel/framework/pull/50718
• [11.x] Apply default timezone when casting unix timestamps by @daniser in https://github.com/laravel/framework/pull/50751
• [11.x] Fixes ApplicationBuilder::withCommandRouting() usage by @crynobone in https://github.com/laravel/framework/pull/50742
• [11.x] Register console commands, paths and routes after the app is booted by @plumthedev in https://github.com/laravel/framework/pull/50738
• [11.x] Enhance malformed request handling by @jnoordsij in https://github.com/laravel/framework/pull/50735
• [11.x] Adds withSchedule to bootstrap/app.php file by @nunomaduro in https://github.com/laravel/framework/pull/50755
• [11.x] Fix dock block for create method in InvalidArgumentException.php by @saMahmoudzadeh in https://github.com/laravel/framework/pull/50762
• [11.x] signature typo by @abrahamgreyson in https://github.com/laravel/framework/pull/50766
• [11.x] Simplify ApplicationBuilder::withSchedule() by @crynobone in https://github.com/laravel/framework/pull/50765