Laravel News Laravel News
News

Support for Query Builder Pipelines in Laravel 12.4

Published Updated
Support for Query Builder Pipelines in Laravel 12.4 image

Release updates

Never miss a Laravel release

Get an email whenever a new Laravel release lands.

The Laravel team released v12.4.0, which includes a query builder pipe() method, the ability to conditionally skip migrations, an Arr::sole() method, and more.

Query Builder pipe() Method

Tim MacDonald contributed a pipe() method to the base query builder and Eloquent query builder. This method's functionality is the same as the Collection::pipe() method:

$records = DB::query()
    ->from('...')
    // ...
    ->tap(new TappableScope) // returns the query
    ->pipe(new ActionScope); // executes the query and returns the result

Skipping Migrations

Dan Matthews conbributed the ability to programatically skip migrations by adding an optional shouldRun() method to a migration:

return new class extends Migration
{
   public function shouldRun()
   {
        return Feature::active(Flights::class);
   }
 
   // ...
}

The shouldRun() method is considered for both migrate and rollback commands. See the Database Migrations documentation for details.

Arr::sole() Method

Ralph J. Smit contributed a Arr::sole() method, similar to collections and Eloquent collections. Sole supports passing a simple array that will return the first item only if it is the only item. Also, you can pass a callable as the second argument:

Arr::sole(['foo']); // "foo"
 
// @throws \Illuminate\Support\ItemNotFoundException
Arr::sole(['foo'], fn (string $value) => $value === 'baz');
 
// @throws \Illuminate\Support\MultipleItemsFoundException
Arr::sole(['baz', 'foo', 'baz'], fn (string $value) => $value === 'baz');

Queue fake Helper for Listeners Pushed

Luke Kuzmish contributed a listenersPushed() method you can use to assert a queue listener was pushed during a test:

Queue::fake();
event(new SomeEvent(value: 'look, a value!'));
 
$this->assertCount(
    1,
    Queue::listenersPushed(
        SomeEventListener::class,
        fn (SomeEvent $event) => $event->value === 'look, a value!'
    )
);

Model except() Method

Vishal Chavda contributed a Model::except() method to retrieve model attributes excluding specific keys. This method is the inverse of the only() method:

$user->except('id', 'email');

Assert Does Not Throw Method

Günther Debrauwer contributed a assertDoesntThrow() method to easily assert that a block of code doesn't throw an exception

$this->assertDoesntThrow(fn () => (new ProcessOrder)->execute());

This method is documented in the HTTP Tests documentation.

Where Null and Where Not Null JSON Assertions

Faissal Wahabali contributed whereNull() and whereNotNull() methods to Assertablejson instances. Here's an example from the pull request of how this works:

// Usage:
fn (AssertableJson $json) => $json->whereNull('error')
 
 
// Example from the Framework tests:
$assert = AssertableJson::fromArray([
    'bar' => 'value',
]);
 
$this->expectException(AssertionFailedError::class);
$this->expectExceptionMessage('Property [bar] should be null.');
 
$assert->whereNull('bar');

Edit: 04/01/2025

I somehow missed the new AsHtmlString Eloquent cast in v12.4! I wrote a separate post about it:

As of v12.4, you can automatically cast Eloquent attributes to an HTML string using the AsHtmlString cast. The framework already has an HtmlString class available; this cast stitches it together with Eloquent attributes.

Release notes

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

v12.4.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 →
Laravel Auditor Audits Your App With Your Own AI Agent image

Laravel Auditor Audits Your App With Your Own AI Agent

Read article
A simple form builder that stays out of your way image

A simple form builder that stays out of your way

Read article
Laravel AI: Trace Agent Runs With Lifecycle Events image

Laravel AI: Trace Agent Runs With Lifecycle Events

Read article
Laravel AI: Get Raw HTTP Responses and Rate Limits image

Laravel AI: Get Raw HTTP Responses and Rate Limits

Read article
Agent Run Observability in Laravel AI SDK 0.11 image

Agent Run Observability in Laravel AI SDK 0.11

Read article
Debounced Queued Event Listeners in Laravel image

Debounced Queued Event Listeners in Laravel

Read article