Laravel News Laravel News
News

Temporary Context Scope in Laravel 12.1

Published
Temporary Context Scope in Laravel 12.1 image

Release updates

Never miss a Laravel release

Get an email whenever a new Laravel release lands.

The Laravel team tagged v12.1.0—the first minor release of Laravel 12—which includes a context scope method, an Arr::partition() method, a getRawSql() method on query exception instances, and more.

New Array Partition Method

Liam Duckett contributed the partition method to the Array helper, which allows using existing partition logic without having to reach for collections:

$numbers = [0, 1, 2, 3, 4, 5];
 
// Using collections
[$evens, $odds] = collect($numbers)->partition(fn(int $number) => $number % 2 === 0);
 
// Using the Arr::partition() method
[$evens, $odds] = Arr::partition($numbers, fn(int $number) => $number % 2 === 0);

This method partitions the array into two arrays using the provided callback.

Added a getRawSql() Method to Query Exceptions

@erickcomp contributed a getRawSql() method to the QueryException class, which returns the raw SQL representation of the query with embedded bindings. You could use this to report any problematic query errors:

->withExceptions(function (Exceptions $exceptions) {
    $exceptions->report(function (QueryException $e) {
        // ...
       MyErrorServiceFacade::report('Error executing SQL: ', $e->getRawSql());
    });
})

Context Scope Method

Luke Kuzmish contributed a Context::scope() method that can include context for the duration of a function call and then restore the context to what it was before the call:

// Before
Context::add('event_id', $event->id);
 
try {
    $this->innerHandle($event);
} finally {
    Context::forget(['event_id', 'sns_message_id']);
}
 
// After
Context::scope(
    fn () => $this->innerHandle($event),
    ['event_id' => $event->id]
);

You can learn more about the Context::scope() method in the documentation.

PendingCommand Class is Now Tappable

Kevin Bui added the Tappable trait to the testing PendingCommand class, which allows you to handle assertions all in one go:

$this->artisan('orders:refunding', ['--ids' => 1])
    ->expectsOutput('Start Refunding...')
    ->tap(function ($command) {
        // ...
        $command->expectsOutput('...');
    });

See Pull Request #54801 for the complete example.

Release notes

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

v12.1.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 →
CPX: The Composer Package Executor for PHP image

CPX: The Composer Package Executor for PHP

Read article
Laravel AI SDK Adds Human-in-the-Loop Tool Approval image

Laravel AI SDK Adds Human-in-the-Loop Tool Approval

Read article
Pest 5 Released With Test Impact Analysis, Agent Verification, and Evals image

Pest 5 Released With Test Impact Analysis, Agent Verification, and Evals

Read article
Queue-SQL: Run Mass Deletes and Updates Across Parallel Queue Jobs image

Queue-SQL: Run Mass Deletes and Updates Across Parallel Queue Jobs

Read article
Blade Formatting in Laravel Pint image

Blade Formatting in Laravel Pint

Read article
Inertia DevTools Is Now on the Chrome Web Store image

Inertia DevTools Is Now on the Chrome Web Store

Read article