php artisan make:exception ApiAccessErrorException

php artisan make:controller CustomExceptionController

すると、ファイルが作成されるので、中身を以下のように変更します。

<?php

namespace App\Http\Controllers;

use App\Exceptions\ApiAccessErrorException;
use Illuminate\Http\Request;
use Illuminate\Support\Arr;
use Illuminate\Support\Facades\Http;
use Inertia\Inertia;

class CustomExceptionController extends Controller
{
    public function create()
    {
        return Inertia::render('CustomException/Create')->with([
            'successMessage' => session('success'),
        ]);
    }

    public function store(Request $request)
    {
        // 通常のバリデーションは省略しています

        $api_url = route('custom_exception.access_error');
        $show_api_error = ($request->has_api_error === 'yes'); // API のエラーを出すかどうか

        try {

            $response = Http::get($api_url); // API にアクセス

            throw_if(
                $show_api_error,
                new ApiAccessErrorException($response->json('error_message'))
            );

            // 実際にはこの部分で DB 保存などを実行します

        } catch (ApiAccessErrorException $e) { // API でエラーが発生した場合

            $error_message = $e->getMessage();

            // 擬似的にバリデーションエラーを返す
            return back()->withErrors([
                'api_access' => $error_message
            ]);

        } catch (\Exception $e) { // その他のエラー

            throw $e;

        }

        return back()->with('success', '保存が完了しました！');
    }

    public function access_error()
    {
        $error_messages = [
            'API のパラメータに不足があります',
            'API のパラメータに誤りがあります',
            'API のパラメータに不正な値があります',
            'API キーが無効です',
            'API シークレットキーが無効です',
        ];
        $error_message = Arr::random($error_messages); // ランダムにエラーを返す

        return response([
            'error_message' => $error_message,
        ], 400);
    }
}

データ送信したときに実行されるstore()が今回のメインで、この中で「例外を使った分岐」をしていることに注目してください。

つまり、tryの中ではいくつかコードを実行しますが、APIにエラーがあったときだけ、catch (ApiAccessErrorException $e) { ... }が実行されることになります。

※ 本来はAPIを使った処理はモデルやTraitなどに分割すると思うので、例外を投げるのは実際にその中ということになります。

また、DBへの保存などその他のエラーが出た場合は、次のcatch (\Exception $e){ ... }が実行されます。

※ 今回は複雑になるので書いていませんが、トランザクションで一気にDB保存する場合はこの中でロールバック（「ここまでのDB保存はナシよ」機能）することになります。

そして、APIエラーの場合、擬似的にバリデーションエラーを実行するわけですが、これはシンプルにwithErrors([ ... ])にエラーをセットしてリダイレクトすればOKです。（あとでReact側でこのエラーを受け取ることになります）

import {Inertia} from "@inertiajs/inertia";
import {useState} from "react";

export default function Create(props) {

    const errors = props.errors;
    const [hasApiError, setHasApiError] = useState('yes');
    const successMessage = props.successMessage;
    const handleSubmit = () => {

        const url = route('custom_exception.store');
        const params = {
            has_api_error: hasApiError,
        };
        Inertia.post(url, params)

    };

    return (
        <div className="p-5">
            {successMessage && (
                <div className="bg-green-100 border border-green-400 text-green-700 px-4 py-3 rounded relative mb-3" role="alert">
                    &#x1F44D; {successMessage}
                </div>
            )}
            {errors.api_access && (
                <div className="bg-red-100 border border-red-400 text-red-700 px-4 py-3 rounded relative mb-3" role="alert">
                    &#x26A0; {errors.api_access}
                </div>
            )}
            <div className="mb-2 p-2">
                <div>
                    <label>
                        <input
                            type="radio"
                            value="has_api_error"
                            checked={hasApiError === 'yes'}
                            onChange={() => setHasApiError('yes')}
                        /> API でエラーを出す
                    </label>
                </div>
                <div>
                    <label>
                        <input
                            type="radio"
                            value="has_api_error"
                            checked={hasApiError === 'no'}
                            onChange={() => setHasApiError('no')}
                        /> なし
                    </label>
                </div>
            </div>
            <button
                type="button"
                className="text-white bg-blue-700 rounded-lg text-sm px-4 py-2"
                onClick={handleSubmit}>送信</button>
        </div>
    );

}

この中でやっているのは、シンプルに「ラジオボタンでデータを選択して送信」だけです。

そして、そのラジオボタンは以下２つの選択になっています。

• API でエラーを出す
• なし

つまり、テストしやすくしているだけですね

// 省略

use App\Http\Controllers\CustomExceptionController;

Route::prefix('custom_exception')->controller(CustomExceptionController::class)->group(function(){

    Route::get('create', 'create')->name('custom_exception.create');
    Route::post('/', 'store')->name('custom_exception.store');
    Route::get('access_error', 'access_error')->name('custom_exception.access_error');

});