【Laravel】get()・first()で0件データを綺麗に処理する方法

2025年7月26日

当ページのリンクには広告が含まれています。

この記事で解決できる悩み

Laravelのget()・first()で0件データを綺麗に処理する方法は？

いずみ

こんな悩みを解決できる記事を書きました！

僕は現役フリーランスエンジニア（歴10年）で、資格は13個保有しています。

「Laravelのget()やfirst()で0件データを綺麗に処理する方法を知りたい」とお考えではありませんか？

Laravelを使っていると、取得したデータが空の場合に例外が発生したり、期待通りの動作にならないことがありますよね。

特にfirst()でnullが返ってきた時や、get()で空のコレクションが返ってきた時の処理に悩むことも多いはずです。

いずみ

分かってしまえば簡単なのでサクッと解説します。

ということで、本記事ではLaravelのget()やfirst()で0件データを綺麗に処理する方法を解説します。

いずみ

すぐ読み終わるので、ぜひ最後まで読んでくださいませ。

執筆者／監修者

フリーランスエンジニア（保有資格13個）
ブログ・アフィリエイト歴7年（2018年〜）
ブランドせどりで月利50万円⇨脱サラ
投資（仮想通貨・FX）歴7年（2018年〜）
X（旧Twitter）フォロワー約1,900人
運営者情報はこちら

いずみです

first()でnullを適切に処理する方法

Laravelのfirst()は、データが見つからない場合にnullを返すため、適切なnullチェックが必要です。

最もスマートな方法は、firstOrFail()やOptional Chainingを活用することです。

いずみ

firstOrFail()を使えば、データが見つからない場合に自動的に404エラーを返してくれるため、コントローラーでの例外処理が不要になります。

// Bad: 手動でnullチェックする方法
$user = User::where('email', $email)->first();
if (!$user) {
    abort(404, 'ユーザーが見つかりません');
}

// Good: firstOrFail()を使う方法
$user = User::where('email', $email)->firstOrFail();
// データが見つからない場合は自動的に404エラーが返される

get()で空のコレクションを判定する方法

get()は常にコレクションを返すため、isEmpty()やisNotEmpty()を使った判定が効果的です。

また、count()よりもisEmpty()の方がパフォーマンス面で優れています。

いずみ

空の場合に代替データを返したい時は、whenEmpty()が便利です。

// Bad: count()を使った判定
$users = User::where('status', 'active')->get();
if (count($users) === 0) {
    return '該当ユーザーなし';
}

// Good: isEmpty()を使った判定
$users = User::where('status', 'active')->get();
if ($users->isEmpty()) {
    return '該当ユーザーなし';
}

// Better: whenEmpty()を使った方法
$users = User::where('status', 'active')->get();
return $users->whenEmpty(function () {
    return collect(['該当ユーザーなし']);
});