導入

Laravel モデルにリレーションシップを熱心に読み込む場合、返される関連モデルの数を制限したい場合があります。

たとえば、ブログ プラットフォームでは、システム内のすべての著者とその 3 つの投稿を読み込むことができます。

Laravel の古いバージョンでは、熱心にロードされた関係を制限するのは少し面倒な作業でした。適切だと感じられるエレガントな方法を見つけることができませんでした。そこで私は通常、この機能を追加する Jonas Staudenmeir (@staudenmeir) の staudenmeir/eloquent-eager-limit パッケージをインストールしました。

しかし、今年の初めに、そのパッケージの背後にあるコア機能が Laravel フレームワーク自体に統合されました。つまり、Laravel 11 では、追加のパッケージをインストールすることなく、積極的にロードされる関係を制限できるということです。

例を見てみましょう。

Laravel での Eager Loaded Relationship の制限

ブログ プラットフォームがあり、システム内のすべての著者とその 3 つの投稿をロードしたいとします。

これは、熱心な読み込みクエリの制限メソッドを使用して実現できます:

use App\Models\Post;
use App\Models\Author;
use Illuminate\Contracts\Database\Eloquent\Builder;

$authors = Author::query()
    ->with([
        'posts' => fn (Builder $query): Builder => $query->limit(3),
    ])
    ->get();

上記のコード例でわかるように、App\Models\Author モデルに投稿関係を積極的にロードすることを定義しました。熱心な読み込みクエリでは、limit メソッドを使用して、3 つの投稿のみを読み込むことを指定しました。

基礎となる SQL クエリ

興味のある方のために、上記のクエリは 2 つの SQL クエリを生成します。

最初のクエリはデータベースから著者を取得します:

SELECT * FROM `authors`

2 番目のクエリは、各著者の 3 つの投稿を取得します (システムに 5 人の著者がいると仮定します):

SELECT *
FROM
    (
        SELECT
            *,
            row_number() OVER (PARTITION BY `posts`.`author_id`) AS `laravel_row`
        FROM `posts`
        WHERE `posts`.`author_id` IN (1, 2, 3, 4, 5)
    ) AS `laravel_table`
WHERE `laravel_row` 




  
  
  さらに読む


この記事を読んで気に入っていただけたなら、同様のトピックをさらに詳しく扱った私の 220 ページの電子書籍「Battle Ready Laravel」をチェックしてみることに興味があるかもしれません。

または、Laravel を使用して他のサービスから API を使用する方法を説明する、私の他の 440 ページの電子書籍「Laravel での API の使用」もチェックしてみてください。

私が新しい投稿を公開するたびに最新情報を受け取ることに興味がある場合は、お気軽にニュースレターに登録してください。

これからも素晴らしいものを作り続けてください！ ?