このチュートリアルでは、ユーザーが以前に入力したデータが失われないように、Laravel アプリケーションでフォーム検証の失敗シナリオを適切に処理する方法を詳細(xì)に説明します。コントローラーで withInput() メソッドを使用してリクエスト データをセッションにフラッシュし、Blade テンプレートで old() 補(bǔ)助関數(shù)を使用することにより、フォーム フィールドの自動バックフィルが実現(xiàn)され、ユーザー エクスペリエンスが大幅に向上します。

Web アプリケーション開発では、ユーザーがフォームを送信した後、データがサーバー側(cè)の検証に失敗した場合、通常はユーザーをフォーム ページにリダイレクトしてエラー メッセージを表示する必要があります。ただし、一般的なユーザー エクスペリエンスの問題點(diǎn)は、リダイレクトが発生すると、ユーザーがフォームに入力したデータが失われ、すべてのフィールドに再度入力しなければならないことです。これは、ユーザーの運(yùn)用負(fù)擔(dān)を増大させるだけでなく、ユーザーの損失にもつながる可能性があります。 Laravel は、withInput() メソッドと old() ヘルパー関數(shù)を通じて、この問題を解決するためのシンプルかつ強(qiáng)力なメカニズムを提供します。

コントローラーの withInput() メソッド

Laravel の Validator インスタンスは、フォーム検証が失敗した場合にすべての検証エラーをキャッチします。通常、これらのエラー メッセージを表示してユーザーをフォーム ページにリダイレクトします。ユーザーが送信したフォームデータを同時(shí)に保持するには、リダイレクト時(shí)に withInput() メソッドを呼び出す必要があります。

withInput() メソッドの機(jī)能は、現(xiàn)在のリクエストのすべての入力データをセッションにフラッシュすることです。これは、データが次のリクエストでのみ利用可能になり、その後セッションから自動的に消去されることを意味し、セッション データの不必要な蓄積を回避します。

元の質(zhì)問コードの例 (入力は保持されません):

次のコードは、検証が失敗した後、ユーザー入力を保持せずにエラー メッセージのみを表示してリダイレクトするシナリオを示しています。

 // ...他のコード...

$validator = Validator::make($request->all(), [
    'PageLanguage.title.*' => '必須',
]、[
    "required" => "フォームの必須フィールドをすべてチェックして記入してください。" // エラー メッセージを最適化します]);

if ($validator->fails()) {
    return redirect('admin/page/create')
                ->withErrors($validator); // ユーザー入力データは現(xiàn)時(shí)點(diǎn)では保持されません}

//...検証後のロジック...

上記のコードでは、検証が失敗した場合、ユーザーは admin/page/create ページにリダイレクトされますが、以前に入力したフォーム データは失われます。

withInput() を追加した後の解決策:

データ損失の問題を解決するには、リダイレクト チェーンに ->withInput() メソッドを追加するだけです。

 // ...他のコード...

$validator = Validator::make($request->all(), [
    'PageLanguage.title.*' => '必須',
]、[
    "required" => "フォームの必須フィールドをすべてチェックして記入してください。"
]);

if ($validator->fails()) {
    return redirect('admin/page/create')
                ->withErrors($validator)
                ->withInput(); // ユーザー入力データを保持するためにこのメソッドを追加します}

//...検証後のロジック...

現(xiàn)在は、検証が失敗してリダイレクトされると、以前に送信されたフォーム データ (すべての $_POST および $_GET パラメーターを含む) が次のリクエストに備えてセッションに保存されます。

Blade テンプレートの old() ヘルパー関數(shù)

コントローラーの withInput() を介してデータをフラッシュした後、Blade テンプレートでデータを正しく取得し、適切なフォーム フィールドにデータを入力する必要があります。 Laravel はこれを行うための old() ヘルパー関數(shù)を提供します。

old() 関數(shù)は、取得する入力フィールドの name 屬性という 1 つのパラメータを受け入れます。フィールドがフラッシュ メモリ內(nèi)の入力データに存在する場合、old() はその値を返します。それ以外の場合は null を返します。

使用例：

フォームフィールドの名前が name であると仮定すると、次のように Blade テンプレートで old() を使用できます。

 <input type="text" name="name" value="{{ old('name') }}" class="form-control" placeholder="名前を入力してください">

アプリケーションが LaravelCollective/html などのフォーム補(bǔ)助パッケージを使用している場合、その使用法はより簡単になります。たとえば、テキスト入力ボックスの場合は次のようになります。

 {!! Form::text('name', old('name'), ['class' => 'form-control', 'placeholder' => '']) !!}

ここで、Form::text の 2 番目のパラメータはフィールドのデフォルト値です。 old('name') が値を返す場合、その値がデフォルト値として使用されます。それ以外の場合、フィールドは空になります。

入力を配列形式で処理します。

元の質(zhì)問では、検証ルールは 'PageLanguage.title.*' => 'required' で、フォームが PageLanguage[title][0]、PageLanguage[title][1] などの配列形式で入力を受け取る可能性があることを示しています。 old() 関數(shù)は、この形式のアクセスもサポートしています。

 <!-- PageLanguage[title][0] のような入力の場合 -->
<input type="text" name="PageLanguage[title][0]" value="{{ old('PageLanguage.title.0') }}" class="form-control">

<!-- または、フォームが動的に生成される場合は、ループを通じてアクセスできます -->
@foreach($言語として $index => $言語)
    <label for="title_{{ $index }}">{{ $ language->name }} タイトル:</label>
    <input type="テキスト" name="ページ言語[タイトル][{{ $index }}]" id="title_{{ $index }}" value="{{ old('PageLanguage.title.' . $index) }}">
@endforeach

ネストされた配列の場合、 old() 関數(shù)はドットを使用することに注意してください。 PageLanguage.title.0 などの子要素にアクセスします。

注意すべき點(diǎn)とベストプラクティス

1. old() 関數(shù)のデフォルト値: old() 関數(shù)は、2 番目のパラメータをデフォルト値として受け入れることができます。対応するフィールドがフラッシュ データ內(nèi)に見つからない場合は、このデフォルト値が使用されます。これは、既存のレコードを編集する場合に特に便利です。

    <input type="text" name="name" value="{{ old('name', $user->name ?? '') }}" class="form-control">

   ここで、old('name') が空の場合は、$user->name が試行されます。

2. フォームヘルパー関數(shù): LaravelCollective/html のようなパッケージには便利なフォーム生成メソッドが用意されていますが、それを使用しなくても、HTML タグ內(nèi)で直接 value="{{ old('field_name') }}" を使用することは完全に実現(xiàn)可能です。
3. ユーザー エクスペリエンス: 検証エラー メッセージとデータ バックフィルを組み合わせると、ユーザー エクスペリエンスを大幅に向上できます。エラー メッセージが明確かつ具體的で、どのフィールドを修正する必要があるかを示していることを確認(rèn)してください。
4. セキュリティ: old() 関數(shù)によって返される値は、XSS 攻撃を防ぐために、Laravel によって HTML エンティティに自動的にエンコードされます。したがって、通常は手動で再度コーディングする必要はありません。

要約する

Laravel コントローラーの withInput() メソッドを巧みに使用し、Blade テンプレートの old() ヘルパー関數(shù)を組み合わせることで、フォーム検証が失敗した後のユーザー入力データの自動バックフィルを簡単に実裝できます。このメカニズムは開発プロセスを簡素化するだけでなく、さらに重要なことに、ユーザーにスムーズで中斷のないフォーム送信エクスペリエンスを提供し、データ損失によるフラストレーションを効果的に回避します。このスキルを習(xí)得することは、ユーザーフレンドリーな Laravel アプリケーションを構(gòu)築する上で重要なステップです。

以上がLaravelはフォーム検証が失敗した後にユーザー入力データを自動的にバックフィルしますの詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國語 Web サイトの他の関連記事を參照してください。