Laravel News Laravel News
News

Laravel 12.19 Adds a useEloquentBuilder Attribute, a FailOnException Queue Middleware, and More

Published
Laravel 12.19 Adds a useEloquentBuilder Attribute, a FailOnException Queue Middleware, and More image

Release updates

Never miss a Laravel release

Get an email whenever a new Laravel release lands.

The Laravel team released v12.19.0 with a UseEloquentBuilder PHP attribute, an AsFluent model cast, FailOnException job middleware, assert redirect back with errors, and more:

Use Eloquent Builder PHP Attribute

Hristijan Manasijev contributed a UseEloquentBuilder PHP attribute to register a custom Eloquent query builder for a model. This feature has been proposed a few times and is now in Laravel 12 for those using custom query builders.

Before you might write something like this to use a custom query builder:

class MyModel extends Model
{
    // ...
    public function newEloquentBuilder($query)
    {
        return new CustomBuilder($query);
    }
}

Now you can use the framework-provided PHP attribute:

use Illuminate\Database\Eloquent\Attributes\UseEloquentBuilder;
 
#[UseEloquentBuilder(CustomBuilder::class)]
class MyModel extends Model
{
    // ...
}

See Pull Request #56025 for details.

AsFluent Model Cast

Azim Kordpour contributed a AsFluent model cast

namespace App\Models;
 
use Illuminate\Database\Eloquent\Casts\AsFluent;
use Illuminate\Database\Eloquent\Model;
 
class Passenger extends Model
{
    protected function casts(): array
    {
        return [
            'address' => AsFluent::class,
        ];
    }
}

After defining a model cast as a fluent instance, you can use it with a model instance:

$passanger = Passenger::first();
 
// Get nested values
$passenger->address->get('office.street');
$passenger->address->get('home.street');
 
// Update it as a Fluent instance...
$passenger->address = new Fluent([
           'office' => ['street' => 'new street'],
           'office' => ['home' => 'new street']
]);
 
// Or as an array...
$passenger->address = [
    'office' => ['street' => 'new street'],
    'office' => ['home' => 'new street']
];

See the Eloquent: Mutators & Casting documentation for details on using model casts.

Fail on Exception Job Middleware

Luke Kuzmish contributed a queue job middleware to fail the job on a particular exception—the default behavior is to retry based on how many retries are left. Using this middleware, you might know that a job never has a chance to run successfully and can instantly fail the job:

use Illuminate\Queue\Middleware\FailOnException;
 
/**
 * Get the middleware the job should pass through.
 */
public function middleware(): array
{
    return [
        new FailOnException([AuthorizationException::class])
    ];
}

The FailOnException accepts a callable instance if you want custom logic, which takes the thrown exception and the job instance:

new FailOnException(fn (\Throwable $e, mixed $job): bool => /* ... */);

See the Failing Jobs on Specific Exceptions section in the Queues documentation.

Asserting Redirects with Errors

Ahmed Alaa contributed two test response methods to assert whether the response is redirecting back to the previous page and the session has given errors:

$response->assertRedirectBackWithErrors(
    array $keys = [], $format = null, $errorBag = 'default'
);

The second helper is the opposite, asserting a redirect back and verifying that no errors exist in the session:

$response->assertRedirectBackWithoutErrors();

These methods are now documented in the official 12.x documentation.

Add a Mailable Attachment from an UploadedFile Instance

Rodrigo Pedra Brum contributed a fromUploadedFile() method to the mail Attachment class, which allows you to convert an UploadedFile instance into a mailable attachment.

use Illuminate\Mail\Attachment;
 
Attachment::fromUploadedFile($file);

See Pull Request #56027 for details.

Release notes

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

v12.19.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

masteringlaravel logo
Laravel Code Review

Get expert guidance in a few days with a Laravel code review

Visit Laravel Code Review

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