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

当ページのリンクには広告が含まれています。
【Laravel】get()・first()で0件データを綺麗に処理する方法
いずみ

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

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

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

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

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

いずみ

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

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

いずみ

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

スクロールできます
【当サイト】おすすめフリーランスエージェント3選
エージェント評価ポイント公式サイト
レバテックフリーランス

5.0
業界最大級のエージェント。
高単価案件が豊富。
公式
Midworks

4.8
満足度調査で
3年連続3冠を達成。
公式
ITプロパートナーズ

4.6
週2〜3向けの案件が豊富。公式
執筆者/監修者
  • フリーランスエンジニア(保有資格個、企業と直接契約
  • ブログ・アフィリエイト歴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(['該当ユーザーなし']);
});
スクロールできます
【当サイト】おすすめフリーランスエージェント3選
エージェント評価ポイント公式サイト
レバテックフリーランス

5.0
業界最大級のエージェント。
高単価案件が豊富。
公式
Midworks

4.8
満足度調査で
3年連続3冠を達成。
公式
ITプロパートナーズ

4.6
週2〜3向けの案件が豊富。公式

【厳選】フリーランスエンジニアにおすすめなエージェント3選

フリーランスエンジニアになるにはエージェントから案件をもらう必要があります。

僕が実際に利用しているおすすめエージェントを紹介しますね。

いずみ

エージェントは必ず複数登録してください。

担当者によっては「全然案件紹介してくれない…」みたいなこともあるので…

僕は実際に5つのエージェントを使い回していますよ。

フリーランスを始めるなら「

案件数マージン率単価
約88,000件非公開
初心者福利厚生申し込み
無料
Good Point
  • 業界最大級の案件数。
  • 業界トップクラスの高単価報酬、低マージン(平均年収862万円)。
  • 案件参画中のフォローの充実。

※詳細は「【業界最大手】レバテックフリーランスとは?メリットや利用手順を解説!」を参照。

は業界最大手のフリーランスエージェントです。

とにかく案件数が多いので、とりあえず登録しておけば間違いないエージェントです!

いずみ

僕もはじめてフリーランスの案件を貰ったのはです。

保有している案件数が多いので、業務経験がなくても何かしらの案件は紹介してもらえますよ(僕はJavaの経験3年でも案件を貰えました)。

手厚い保障を重視したいなら「

案件数マージン率単価
約10,000件非公開
初心者福利厚生申し込み
無料
Good Point
  • 手厚い保障で正社員並みの安心感。
  • 還元率60%超え&単価公開でクリアな契約。
  • 給与保障制度(審査あり)。

は手厚い保障が特徴のフリーランスエージェントです。

フリーランスを目指しているけど不安な方や保障を重視したい方におすすめです。

いずみ

僕も何度か案件を紹介してもらいました。

自分のスキルに合った案件を紹介してもらえましたし、電話のやり取りも非常に丁寧でした。

週2〜3日の案件探しなら「

案件数マージン率単価
約5,000件非公開
初心者福利厚生申し込み
経験者向け無料
Good Point
  • IT案件に特化したフリーランスエージェント。
  • 週2〜3日の案件が豊富。
  • リモート案件が多く、直エンドなので単価も高い。

※詳細は「【週2・3案件】ITプロパートナーズとは?メリットや利用手順を解説!」を参照。

はIT案件に特化したフリーランスエージェントです。

週2〜3日から参画できる案件が豊富なので、起業したい人にもおすすめです。

いずみ

週2〜3日の案件はある程度スキルがないと紹介してもらえない印象です。

とはいえ、週5の案件ももちろんありますし、僕が利用した時は迅速・丁寧に対応していただきました!

よくある質問

get()とfirst()の違いは何ですか?

get()はコレクション(配列形式)を返し、first()は単一のモデルインスタンス(またはnull)を返します。

get()は複数件のデータを想定した処理で、first()は1件のデータを取得する場合に使用します。

パフォーマンス面では、1件だけ必要な場合はfirst()の方が効率的です。

firstOrFail()を使うとどんなエラーが発生しますか?

firstOrFail()でデータが見つからない場合、ModelNotFoundExceptionが発生します。

Laravelは自動的に例外を404HTTPレスポンスに変換するため、通常はtry-catch文で捕捉する必要はありません。

カスタムエラーメッセージを表示したい場合は、例外ハンドラーで処理を追加できます。

まとめ

今回は、Laravelのget()・first()で0件データを綺麗に処理する方法について解説しました。

以下が本記事のまとめになります。

まとめ
  • first()の0件処理はfirstOrFail()を使うのが効果的。
  • get()の空コレクション判定はisEmpty()やwhenEmpty()が効果的。
まとめ
  • おすすめ本
¥2,673 (2023/07/23 15:53時点 | Amazon調べ)
\楽天ポイント4倍セール!/
楽天市場

Laravelの勉強なら「」が分かりやすくておすすめですよ♪

いずみ

最後までお読みいただき、ありがとうございました!

スクロールできます
【当サイト】おすすめフリーランスエージェント3選
エージェント評価ポイント公式サイト
レバテックフリーランス

5.0
業界最大級のエージェント。
高単価案件が豊富。
公式
Midworks

4.8
満足度調査で
3年連続3冠を達成。
公式
ITプロパートナーズ

4.6
週2〜3向けの案件が豊富。公式
  • クソおすすめ本
¥4,480 (2024/06/01 23:28時点 | Amazon調べ)
\楽天ポイント4倍セール!/
楽天市場
いずみ

海外のエンジニアがどういった思考で働いているかが理解できます。

海外に行く気はないけど海外エンジニアの動向が気になる雑魚エンジニアにおすすめです(本当におすすめな本しか紹介しないのでご安心を)。

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

この記事が気に入ったら
フォローしてね!

シェアしてね!
  • URLをコピーしました!
目次