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

acquaintsoft logo
Acquaint Softtech

Hire Laravel developers with AI expertise at $20/hr. Get started in 48 hours.

Visit Acquaint Softtech

The latest

View all →
Slow Job Alerts and Replica Commit IDs in Laravel 13.40 image

Slow Job Alerts and Replica Commit IDs in Laravel 13.40

Read article
Flock: A Free, Native Herd Alternative for Laravel image

Flock: A Free, Native Herd Alternative for Laravel

Read article
Live Props for Real-Time Updates in Inertia.js v3.11 image

Live Props for Real-Time Updates in Inertia.js v3.11

Read article
Cooldown Dependency Policy now in Composer 2.11 image

Cooldown Dependency Policy now in Composer 2.11

Read article
Email Sending and Testing for Laravel in One Account image

Email Sending and Testing for Laravel in One Account

Read article
Decide with Jev: Tie Every AI Check to the Exact Draft image

Decide with Jev: Tie Every AI Check to the Exact Draft

Read article