Automatic Relation Loading in Laravel 12.8

The Laravel team released v12.8.0, which includes automatic eager relation loading, creating a Collection instance from a JSON string, and more:

Automatic Relation Loading

Serhii Litvinchuk contributed automatic relationship autoloading:

In large projects, it can become difficult to track and manually specify which relations should be eager-loaded, especially if those relations are deeply nested or dynamically used. Therefore, automatic relation loading can be useful.

// instead of this

$projects->load([
    'client.owner.details',
    'client.customPropertyValues',
    'clientContact.customPropertyValues',
    'status',
    'company.statuses',
    'posts.authors.articles.likes',
    'related.statuses'
]);


// We can use this
$projects->withRelationshipAutoloading();

Here's another example from the pull request's description:

$orders = Order::all()->withRelationshipAutoloading();

foreach ($orders as $order) {
    echo $order->client->owner->company->name;
}

// automatic calls:
// $orders->loadMissing('client');
// $orders->loadMissing('client.owner');
// $orders->loadMissing('client.owner.company');

You can enable automatic loading across models using the following static method:

Model::automaticallyEagerLoadRelationships();

Create a Collection from JSON

@DarkGhostHunter contributed a fromJson method to the Collection class, which you can use to create a collection from a JSON string:

// Before
$collection = new Collection(json_decode($json, true));

// After
$collection = Collection::fromJson($json);

The fromJson() method also supports the depth and flags arguments you might pass to json_decode():

$collection = Collection::fromJson(json: $json, flags: JSON_THROW_ON_ERROR);

"Create Many" Variants of HasOneOrMany Relations

Philip Iezzi contributed forceCreateMany() and forceCreateManyQuietly() Eloquent methods for the HasOneOrMany relationship:

$post->comments()->forceCreateMany($data);
$post->comments()->forceCreateManyQuietly($data);

Here's an example from the Pull Request description, which would require force-creating individual models:

// Before
collect($comments)
    ->map(fn (array $comment) => [
        ...$comment,
        // override some attributes here
    ])
    ->each(fn (array $comment) => $post->comments()->forceCreateQuietly($comment));

// After
collect($comments)
    ->map(fn (array $comment) => [
        ...$comment,
        // override some attributes here
    ])
    ->pipe($post->comments()->forceCreateManyQuietly(...));

Release notes

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