ドキュメントの検索

コレクションから単一のドキュメントを取得するには、Model::where() や DB ファサードのメソッドなどのメソッドを使用してドキュメントを一致させ、first() メソッドを呼び出して 1 つのドキュメントを返します。

If multiple documents match the query filter, first() returns the first matching document according to the documents' natural order in the database or according to the sort order that you can specify by using the orderBy() method.

Tip

Lambda 統合を使用してドキュメントを取得する他の方法については、読み取り操作のガイドを参照してください。

例

対応するそれぞれのクエリ構文を使用する同じ操作の使用例を表示するには、次の Eloquent タブと Query Builder タブから選択します。

この例では、次のアクションを実行します。

Movie Eloent モデルを使用して、 sample_mflixデータベース内のmoviesコレクションを表します
クエリフィルターに一致するドキュメントをmoviesコレクションから取得します
検索されたドキュメントを印刷

この例では、 Movieモデルで次のメソッドを呼び出します。

where(): directorsフィールドの値に "Rob Reiner" が含まれるドキュメントと一致します
orderBy(): 一致したドキュメントを _id 値の昇順で並べ替えます
first(): 最初に一致するドキュメントのみを検索

$movie = Movie::where('directors', 'Rob Reiner')
  ->orderBy('id')
  ->first();
echo $movie->toJson();

// Result is truncated
{
  "_id": ...,
  "title": "This Is Spinal Tap",
  "directors": [ "Rob Reiner" ],
   ...
}

この例では、次のアクションを実行します。

DB ファサードから table() メソッドを呼び出して moviesコレクションにアクセスします
クエリフィルターに一致するドキュメントをmoviesコレクションから取得します
検索されたドキュメントの titleフィールドを出力します

この例では、次のクエリビルダのメソッドを呼び出します。

where(): directorsフィールドの値に "Rob Reiner" が含まれるドキュメントと一致します
orderBy(): 一致したドキュメントを _id 値の昇順で並べ替えます
first(): 最初に一致するドキュメントのみを検索

$movie = DB::table('movies')
  ->where('directors', 'Rob Reiner')
  ->orderBy('_id')
  ->first();
echo $movie['title'];

Lambda アプリケーションを編集して使用例を実行する方法については、使用例のランディングページを参照してください。

戻る

使用例

複数ドキュメントの検索