Laravelでtry-catchを使いこなす！例外処理の基本と効果的なパターン

1. try-catchとは？エラーを優しく受け止める仕組み

1. try-catchとは？エラーを優しく受け止める仕組み

プログラミング未経験の方が最初にイメージしやすいように例えると、try-catchは「もしものための保険」のようなものです。パソコンのプログラムは、何かしらの間違いや予期せぬ事態（これを例外と呼びます）が起きると、その場で作業を投げ出して止まってしまいます。これを「クラッシュ」や「落ちる」と言ったりします。

そこで、tryという箱の中に「失敗するかもしれないけれど実行したい処理」を入れ、catchという箱の中に「もし失敗したときにどうするか」を書いておきます。こうすることで、たとえエラーが起きてもプログラムが突然終了することを防ぎ、ユーザーに「ただいま混み合っています」といった優しいメッセージを出すことができるようになります。これが例外処理の基本です。

2. 基本的なtry-catchの書き方を見てみよう

2. 基本的なtry-catchの書き方を見てみよう

Laravelでも、基本的にはPHPの仕組みを使って例外処理を書きます。まずは最もシンプルな形を確認しましょう。ここでは「数字をゼロで割る」という、数学的にもプログラミング的にもやってはいけないエラーを例にします。

try {
    // ここでエラーが起きそうな処理を実行します
    $result = 10 / 0; 
    echo '計算結果は' . $result . 'です';
} catch (\Throwable $e) {
    // エラーが起きたらここに来ます
    echo 'エラーが発生しました：ゼロで割ることはできません。';
}

このコードでは、tryの中でエラーが起きた瞬間、その下のechoは実行されずにcatchの中へとジャンプします。$eという文字には、エラーの詳しい内容（原因や場所など）が自動的に詰め込まれます。このように「捕まえる（catch）」ことで、プログラムの暴走を食い止めることができるのです。

3. Laravelのデータベース操作で効果的に使う

3. Laravelのデータベース操作で効果的に使う

Laravel開発で最もtry-catchが活躍するのは、データベースにデータを保存したり、情報を取得したりする時です。例えば、「会員登録のボタンを押したけれど、通信が途切れて保存に失敗した」という状況はよくあります。

このような場合、ただエラーを表示するのではなく、catchの中で「前の画面に戻してエラー文を表示する」という親切な対応ができます。Laravelのデータベース操作（Eloquent）と組み合わせた例を見てみましょう。

use App\Models\User;
use Illuminate\Support\Facades\Log;

try {
    // ユーザー情報を新しく作ろうとする
    $user = new User();
    $user->name = 'テスト太郎';
    $user->save();
    
    return '登録が完了しました！';
} catch (\Exception $e) {
    // 失敗した記録をログ（日記）に残す
    Log::error('ユーザー登録失敗：' . $e->getMessage());
    
    // ユーザーにエラーを知らせる
    return '申し訳ありません。登録に失敗しました。もう一度お試しください。';
}

Log（ログ）とは、後で開発者が確認できるようにエラーの内容をこっそり記録しておくノートのようなものです。ユーザーには難しい英語を見せず、開発者にはしっかりと情報を残すのが、プロのデバッグ術です。

4. トランザクションと組み合わせた応用パターン

4. トランザクションと組み合わせた応用パターン

次に、非常に重要なトランザクションという言葉について解説します。これは、複数の処理を「全部成功するか、全部失敗させるか」のどちらかにまとめる仕組みです。例えば、銀行の振り込みを想像してください。「自分の口座からお金を引く」処理と「相手の口座にお金を入れる」処理は、どちらか片方だけ成功してはいけませんね。

Laravelでは、try-catchとトランザクションを組み合わせて、安全なプログラムを作ります。もし途中でエラーが起きたら、rollBack（ロールバック）という命令を使って、全ての作業を「なかったこと」にして元に戻します。

use Illuminate\Support\Facades\DB;

DB::beginTransaction(); // ここから作業開始！

try {
    // 1つ目の処理：お金を引き出す
    DB::table('accounts')->where('id', 1)->decrement('money', 1000);
    
    // 2つ目の処理：お金を振り込む
    DB::table('accounts')->where('id', 2)->increment('money', 1000);
    
    DB::commit(); // 全部うまくいったので確定！
    return '送金に成功しました';
} catch (\Exception $e) {
    DB::rollBack(); // 失敗したので全部元に戻す！
    return '送金に失敗したため、元に戻しました。';
}

5. 何でもかんでも囲めばいいわけではない？注意点その1

5. 何でもかんでも囲めばいいわけではない？注意点その1

try-catchは便利ですが、初心者が陥りやすい罠があります。それは「プログラム中の全ての場所をtry-catchで囲んでしまうこと」です。これをやると、本来修正すべき小さなミスまで無理やり「隠して」しまい、どこが間違っているのか分からなくなってしまうデバッグ地獄に陥ります。

基本的には、「自分の力ではどうしようもない外部の要因（データベースの接続、外部アプリとの連携、ファイルの読み込みなど）」が絡む場所で使うのが正解です。自分の書いた計算式の間違いなどは、try-catchで隠さずに、エラー画面を見て修正するのが上達の近道です。難しい単語で言えば「期待されるエラー」と「想定外のバグ」を切り分けることが大切です。

6. catchの中身を空にしないこと！注意点その2

6. catchの中身を空にしないこと！注意点その2

最もやってはいけない書き方は、catchの中に何も書かないことです。これを「エラーの握りつぶし」と呼びます。エラーが起きたのに、プログラムは何事もなかったかのように進もうとするため、後でとんでもない大きな問題に発展することがあります。

最低でも、先ほど紹介した「ログに記録する」か、「画面にエラーメッセージを出す」のどちらかは必ず行いましょう。エラーは敵ではなく、プログラムをより良くするための「ヒント」です。ヒントを捨ててはいけません。以下のコードは「悪い例」ですので、絶対に真似しないでくださいね。

// 【悪い例】エラーを握りつぶしている
try {
    $data = loadImportantFile();
} catch (\Exception $e) {
    // 何も書かない。これが一番危険！
}

7. 最後に実行されるfinallyの役割

7. 最後に実行されるfinallyの役割

try-catchには、もう一つfinally（ファイナリー）という便利な仲間がいます。これは、「成功しても失敗しても、最後に必ず実行される場所」です。例えば、「部屋に入って（try）、何か作業をして、途中で転んでも（catch）、最後は必ず電気を消してドアを閉める（finally）」といったイメージです。

データベースの接続を閉じたり、一時的に作ったファイルを削除したりと、後片付けが必要な場面で重宝します。Laravelの日常的な開発ではあまり使いませんが、知っておくと「痒い所に手が届く」便利な機能です。これを使いこなせれば、初心者卒業と言っても過言ではありません。

try {
    echo '作業を開始します。';
    // 何か複雑な処理
} catch (\Exception $e) {
    echo '途中で失敗しました。';
} finally {
    // 成功・失敗に関わらず必ず通る
    echo '後片付けをして終了します。';
}

8. Laravel専用の例外クラスを使いこなそう

8. Laravel専用の例外クラスを使いこなそう

Laravelには、あらかじめ便利な例外の種類がたくさん用意されています。例えば、ページが見つからないときの「NotFoundHttpException」や、権限がないときの「AccessDeniedHttpException」などです。これらを使い分けることで、より詳細な「キャッチ」が可能になります。

全てのボールを一つのグローブ（Exception）で捕るのではなく、フライ用、ゴロ用と使い分けることで、より正確な守備ができるようになるのと似ています。少しずつで構いませんので、Laravelのリファレンス（説明書）を見て、どんな種類があるのか眺めてみるのも楽しいですよ。まずは基本的な使い道を理解して、安全なWebサイト作りを楽しみましょう！