Laravel モデルでの熱心にロードされた関係を制限する

導入

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();

上記のコード例でわかるように、AppModelsAuthor モデルに投稿関係を積極的にロードすることを定義しました。熱心な読み込みクエリでは、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` <= 3
ORDER BY `laravel_row`

さらに読む

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

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

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

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

以上がLaravel モデルでの熱心にロードされた関係を制限するの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。