The Laravel team released v10.46 this week with new Enum validation methods, incrementing a rate limiter by a custom amount, Conditionable Enum validation rules, and more:
Enum Validation gets only() and except() methods
@Anton5360 contributed two new methods to the
Enum
validation rule when you don’t expect all enum
cases to be valid:
Rule::enum(ServerStatus::class)
->only([ServerStatus::Pending, ServerStatus::Active]);
Rule::enum(ServerStatus::class)
->except([ServerStatus::New]);
A status enum is a perfect example of where these methods might
be practical: after a record status moves away from
New
, you’ll likely not want to allow a record to
return to that status again. Another example from the pull request
description is once a shipment status is shipped
,
you’ll only allow delivered
, cancelled
,
or rejected
.
Rate limiter may be incremented by a custom amount
Sebastien Armand contributed the ability to increment a rate limit value by a custom amount:
Sometimes a rate limit doesn't map directly to an increase of 1 at a time. Some examples would be:
- a limit on bandwidth used
- a limit on # of updates across batch calls where each call could mean multiple "hits"
- a limit on time spent on some operations
Here’s an example of how you can use the
increment()
method to increase the total by a custom
amount:
use Illuminate\Support\Facades\RateLimiter;
RateLimiter::increment('send-message:'.$user->id, amount: 5);
See Manually Incrementing Attempts in the documentation for details.
Conditionable added to the Enum rule
Michael Nabil contributed the ability to use
the Conditionable
trait with the
Rule::enum()
validation rule:
Rule::enum(PostStatus::class)
->when(
auth()->user()->is_admin,
fn ($rule) => $rule->only([PostStatus::APPROVED]),
fn ($rule) => $rule->only([PostStatus::PADDING]),
);
Release notes
You can see the complete list of new features and updates below and the diff between 10.45.0 and 10.46.0 on GitHub. The following release notes are directly from the changelog:
v10.46.0
- [10.x] Ensure lazy-loading for trashed morphTo relations works by @nuernbergerA in https://github.com/laravel/framework/pull/50176
- [10.x] Arr::select not working when $keys is a string by @Sicklou in https://github.com/laravel/framework/pull/50169
- [10.x] Added passing loaded relationship to value callback by @dkulyk in https://github.com/laravel/framework/pull/50167
- [10.x] Fix optional charset and collation when creating database by @GrahamCampbell in https://github.com/laravel/framework/pull/50168
- [10.x] update doc block in PendingProcess.php by @saMahmoudzadeh in https://github.com/laravel/framework/pull/50198
- [10.x] Fix Accepting nullable Parameters, updated doc block, and null pointer exception handling in batchable trait by @saMahmoudzadeh in https://github.com/laravel/framework/pull/50209
- Make GuardsAttributes fillable property DocBlock more specific by @liamduckett in https://github.com/laravel/framework/pull/50229
- [10.x] Add only and except methods to Enum validation rule by @Anton5360 in https://github.com/laravel/framework/pull/50226
- [10.x] Fixes on nesting operations performed while applying scopes. by @Guilhem-DELAITRE in https://github.com/laravel/framework/pull/50207
- [10.x] Custom RateLimiter increase by @khepin in https://github.com/laravel/framework/pull/50197
- [10.x] Add Lateral Join to Query Builder by @Bakke in https://github.com/laravel/framework/pull/50050
- [10.x] Update return type by @AmirRezaM75 in https://github.com/laravel/framework/pull/50252
- [10.x] Fix dockblock by @michaelnabil230 in https://github.com/laravel/framework/pull/50259
- [10.x] Add
Conditionable
in enum rule by @michaelnabil230 in https://github.com/laravel/framework/pull/50257 - [10.x] Update Facade::$app to nullable by @villfa in https://github.com/laravel/framework/pull/50260
- [10.x] Truncate sqlite table name with prefix by @kitloong in https://github.com/laravel/framework/pull/50251
- Correction comment for Str::orderedUuid() - https://github.com/larave… by @wq9578 in https://github.com/laravel/framework/pull/50268
The post Increment a Rate Limiter by a Custom Amount in Laravel 10.46 appeared first on Laravel News.
Join the Laravel Newsletter to get all the latest Laravel articles like this directly in your inbox.
Read more https://laravel-news.com/laravel-10-46-0