Increment a Rate Limiter by a Custom Amount in Laravel 10.46

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