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 toContext
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
tobootstrap/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
The post Non-backed Enums in Database Queries and a withSchedule() bootstrap method in Laravel 11.1 appeared first on Laravel News.
Join the Laravel Newsletter to get Laravel articles like this directly in your inbox.