Laravel News Laravel News
News

Relative Date Helpers in Laravel 11.42

Published
Relative Date Helpers in Laravel 11.42 image

Release updates

Never miss a Laravel release

Get an email whenever a new Laravel release lands.

The Laravel team released v11.42, which includes relative date helpers, fluent numeric validation, JSON assertions on streamed content, and more.

Relative Date Shorthands

Jason McCreary contributed relative date shorthand methods to the query builder that you can use to constrain date fields for things like finding records in the past, future, today, after today, and more:

DB::table('invoices')
    ->wherePast('due_at')
    ->get();
 
DB::table('invoices')
    ->whereFuture('due_at')
    ->get();
 
DB::table('invoices')
    ->whereNowOrPast('due_at')
    ->get();
 
DB::table('invoices')
    ->whereNowOrFuture('due_at')
    ->get();
 
DB::table('invoices')
    ->whereToday('due_at')
    ->get();
 
DB::table('invoices')
    ->whereBeforeToday('due_at')
    ->get();
 
DB::table('invoices')
    ->whereAfterToday('due_at')
    ->get();

Besides the above methods shown, they also include or and not variants and the ability to pass an array of column names:

All of these methods have their where, or, and orWhereNot counterparts. All methods also accept an array of column names as the first argument. The wherePast and whereFuture have an optional second argument to set $now.

See Pull Request #54408 for implementation details and test examples.

Fluent Numeric Validation

Carlos Junior contributed a fluent numeric validation class, providing an expressive way to define numeric validation rules:

// Before
$rules = [
    'score' => 'numeric|integer|multiple_of:10|lte:some_field|max:100',
];
 
// After
$rules = [
    'score' => [
        Rule::numeric()
            ->integer()
            ->multipleOf(10)
            ->lessThanOrEqual('some_field')
            ->max(100);
    ],
];

Context "missing" Method

Vincent Bergeron contributed a missing() and missingHidden() method to the Context service, which returns a boolean if a context key is missing:

Context::add('url', $request->url());
Context::addHidden('hidden_url', $request->url());
 
Context::missing('url'); // false
Context::missing('missing_key'); // true
 
Context::missingHidden('url'); // true
Context::missingHidden('hidden_url'); // false

JSON Assertions on Streamed Content

Günther Debrauwer contributed the ability to use JSON assertions on a streamed JSON response:

Route::get('/users', function () {
    return response()->streamJson([
        'data' => User::cursor(),
    ]);
});
 
$this->getJson('/users')
    ->assertJsonCount(10, 'data')
    ->assertJsonPath('data.*.id', $users->pluck('id')->all());

Release notes

You can see the complete list of new features and updates below and the diff between 11.41.0 and 11.42.0 on GitHub. The following release notes are directly from the changelog:

v11.42.0

Paul Redmond photo

Staff writer at Laravel News. Full stack web developer and author.

X X Github Github
Filed in
News Laravel Releases

Sponsored

laravelcloud logo
Laravel Cloud

Easily create and manage your servers and deploy your Laravel applications in seconds.

Visit Laravel Cloud

The latest

View all →
PayZephyr: One Payment API for Stripe, Paystack, and PayPal image

PayZephyr: One Payment API for Stripe, Paystack, and PayPal

Read article
Bifrost Turns One With AI Builds and New Workflows image

Bifrost Turns One With AI Builds and New Workflows

Read article
Preview Blade Templates in macOS Finder with Quick Blade image

Preview Blade Templates in macOS Finder with Quick Blade

Read article
Artisan Debugging Commands in Laravel Telescope 5.24.0 image

Artisan Debugging Commands in Laravel Telescope 5.24.0

Read article
Queue totalSize() and JobInterrupted Event in Laravel 13.31 image

Queue totalSize() and JobInterrupted Event in Laravel 13.31

Read article
Find Unexpected Test Inputs with Fuzz for Pest image

Find Unexpected Test Inputs with Fuzz for Pest

Read article