redirectやreturn viewにメッセージを付与する方法

▶

編集

この記事の要点

「保存しました」のような一度だけ表示するメッセージは、セッションのフラッシュデータで渡す
リダイレクトするなら return redirect()->route('xxx')->with('message', '保存しました'); が最短
return view でその場で表示するだけなら session()->now() か、ビュー変数で渡す
session()->flash() の後に return view すると、次の画面でもメッセージが残って二重表示になる
Blade 側は @if (session('message')) で存在確認してから表示する

やりたいこと

フォームの送信後に「登録が完了しました」「削除しました」といったメッセージを、次の画面で 1 回だけ表示したい場面はよくあります。Laravel ではこれをフラッシュデータ（次のリクエストまでだけ保持されるセッションの値）で実現します。

どの方法を使うべきかは、コントローラーの最後が redirect なのか return view なのかで変わります。

コントローラーの返し方	使う方法	メッセージの寿命
redirect / back	`->with('message', '...')`	リダイレクト先の 1 リクエストだけ
return view	`session()->now('message', '...')` またはビュー変数	今回のリクエストだけ
（汎用）	`session()->flash('message', '...')`	今回と次のリクエスト

方法 1: redirect にメッセージを付ける（推奨）

POST の処理後はリダイレクトして画面を表示し直すのが定石です（PRG パターン。再読み込みで二重送信されるのを防げます）。リダイレクトレスポンスの with() は、値をフラッシュデータとしてセッションに保存します。

public function store(Request $request)
{
    $user = User::create($request->validated());

    return redirect()
        ->route('users.show', $user)
        ->with('message', 'ユーザーを登録しました');
}

元の画面に戻すなら back() にも同じように付けられます。

return back()->with('message', '更新しました');

// Laravel 9 以降は to_route() でも書ける
return to_route('users.index')->with('message', '削除しました');

方法 2: return view で表示する場合

リダイレクトせず、そのままビューを返してメッセージを表示したい場合は、今回のリクエストだけ有効な session()->now() を使います。

session()->now('message', 'メッセージ');

return view('user', [
    'user' => $user,
]);

セッションを使わず、ビュー変数として渡しても構いません。この場合、Blade 側では session('message') ではなく $message で参照します。

return view('user', [
    'user'    => $user,
    'message' => 'メッセージ',
]);

flash() の直後に return view するとメッセージが二重に出る

次のように session()->flash() の直後に return view しても、今回の画面にはメッセージが表示されます。

session()->flash('message', 'メッセージ');

return view('user', [
    'user' => $user,
]);

ただしフラッシュデータは「次のリクエストまで」保持されるため、ユーザーが次に別のページを開いたときにも同じメッセージがもう一度表示されます。「メッセージが 2 回出る」という不具合の多くはこれが原因です。return view で使うなら now()、リダイレクトするなら with() と使い分けてください。

View（Blade）での表示

@if (session('message'))
    <div class="alert alert-success">
        {{ session('message') }}
    </div>
@endif

{{ }} は自動で HTML エスケープされるため、メッセージにユーザー入力を含めても安全です。Laravel 11 以降では @session ディレクティブでも書けます。

@session('message')
    <div class="alert alert-success">{{ $value }}</div>
@endsession

成功とエラーでキーを分ける

キーを分けておくと、見た目を切り替えやすくなります。共通レイアウト（例: layouts/app.blade.php）に一度書けば、全ページで使えます。

@foreach (['success', 'error', 'warning'] as $type)
    @if (session($type))
        <div class="alert alert-{{ $type === 'error' ? 'danger' : $type }}">
            {{ session($type) }}
        </div>
    @endif
@endforeach

return back()->with('error', '在庫が不足しています');

うまく表示されないときの確認ポイント

ルートに web ミドルウェアが付いているか: セッションは web ミドルウェアグループで有効になります。routes/api.php のルートではフラッシュメッセージは使えません
リダイレクトが 2 回以上連続していないか: リダイレクト先がさらにリダイレクトすると、最初の遷移でフラッシュデータが消費されて表示されません
キー名の一致: with('message') と session('msg') のようにキー名がずれていないか
バリデーションエラーは別の仕組み: $request->validate() の失敗時は $errors 変数に入ります。自分でエラーを返すなら back()->withErrors([...])->withInput() を使います

セッションの中身を確認したいときは、Blade に一時的に @dump(session()->all()) を書くと、どのキーが入っているかが分かります。

関連

編集

子ページ

子ページはありません

同階層のページ

2026-10-02 16:08:36 atom 1839

人気ページ

最近更新/作成されたページ

プロジェクトをTomcatプロジェクトとして認識させる方法 2026-10-07 22:32:50
MySQLの1366 Incorrect string value｜Laravelの文字コード・絵文字エラー 2026-10-07 21:54:03
curlの証明書ホスト名不一致｜旧エラー51・現行60の確認と対処 2026-10-07 21:54:03
LaravelのMassAssignmentException｜fillableの原因と安全な対処 2026-10-07 21:54:03
Eclipse で Tomcat の起動ログがコンソールに出ない時の確認手順 2026-10-07 21:54:02
MySQLにおける中央値(Median)の導き方(バージョン8未満) 2026-10-07 13:49:45
getInputForward 2026-10-07 13:41:15
JSONから配列に変換 2026-10-07 13:41:15
ビューから値をモデルに格納しコントローラーで受け取る方法 2026-10-07 13:23:41
Laravelのテーブル作成と定義変更｜マイグレーション・up/down・注意点 2026-10-07 13:23:41
NumPy 配列に要素を追加する方法 (append / concatenate) 2026-10-07 13:23:41
MariaDB・MySQLで現在日時を取得する方法｜NOW・タイムゾーン・保存型 2026-10-07 13:13:36
【django】テンプレートで定数を使用する方法 2026-10-07 13:10:15
Spring BootにおけるApplication.propertiesの環境依存設定の分割方法 2026-10-07 12:09:35
Not supported for DML operations【Springエラー】 2026-10-07 11:09:38