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()),
);
