Model Resource Helper Functions in Laravel 12.7

The Laravel team released v12.7.0 recently, which includes two excellent new features: resource helper functions for models and a whereAttachedTo() Eloqent method:

Resource Helper Methods for Models

Tim Kunze contributed helper methods that will make generating resource instances fluent using an Eloquent model or collection:

// Before
UserResource::make(User::find(1));
UserResource::collection(User::query()->active()->paginate());
 
// After
User::find(1)->toResource(UserResource::class);
 
User::query()->active()->paginate()->toResourceCollection(UserResource::class);

You can also call toResource() without any arguments, and the model will guess the resource name. Of course, you can be explicit and pass a resource, but when you use Laravel's conventions, it can be omitted:

User::find(1)->toResource();

See Pull Request #55107 for discussion and implementation details.

Eloquent `whereAttachedTo()` Query Builder Method

Jacob Baker-Kretzmar contributed a whereAttachedTo() Eloquent query builder method to simplify retrieving records "attached" to a model via a BelongsToMany relationship:

$tags = Tag::where('created_at', '>', now()->subMonth())->get();
 
// Before
$taggedPosts = Post::whereHas('tags', function ($query) use ($tags) {
    $query->whereKey($tags);
})->get();
 
// After
$taggedPosts = Post::whereAttachedTo($tags)->get();
 
// After with explicit relationship name
$taggedPosts = Post::whereAttachedTo($tags, 'tags')->get();

Make the Uri Class Macroable

Similar to many other classes having the Macroable trait, Richard van Baarsen contributed adding the Macroable trait to the URI class:

use Illuminate\Support\Uri;
 
Uri::macro('docs', fn () => $this->withPath('docs'));
new Uri('https://laravel.com/')->docs(); // https://laravel.com/docs

Release notes

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