Laravelでのvalidationを使いこなす！基礎やエラーを実例で解説

Laravel

PHP
プログラミング言語

公開日時: 2021-03-15 　更新日時: 2022-06-09

この記事でわかること

システム エンジニア: validationを使うとどのようになりますか？

プロジェクト マネージャー: Laravelでのvalidationを使うと、入力の項目チェックができます。

Laravelでのvalidationの使い方とは？

今回は、Laravelでのvalidationの使い方について説明します。validationを使うと、入力項目のチェックができます。
例えば、
・必須入力項目を入力しているか？
・メールアドレス形式になっているか？
・パスワードは8文字以上であるか？
・パスワードと確認用パスワードは一致しているか？
などのチェックを簡単に行えます。
これ以外にも多くのvalidationチェックが可能です。

Laravelでのvalidationの使い方に興味のある方はぜひご覧ください。

基本的な使い方

Laravelでのvalidationの基本的な使い方を紹介します。
Schemaは以下のように記述しています。name、email、password、password_confirmationを画面から入力させる想定です。

/**
 * Run the migrations.
 *
 * @return void
 */
public function up()
{
    Schema::create('tasks', function (Blueprint $table) {
        $table->id();
        $table->string('name');
        $table->string('email');
        $table->string('password');
        $table->string('password_confirmation');
        $table->timestamps();
    });
}

/**

* Run the migrations.

* @return void

public function up()

{

Schema::create('tasks', function (Blueprint $table) {

$table->id();

$table->string('name');

$table->string('email');

$table->string('password');

$table->string('password_confirmation');

$table->timestamps();

});

}

viewは以下のように記述しています。

<div class="form-group">
    <label for="task" class="col-sm-3 control-label">Name</label>
    <div class="col-sm-6">
        <input type="text" name="name" id="task-name" class="form-control">
    </div>
    <label for="task" class="col-sm-3 control-label">Email</label>
    <div class="col-sm-6">
        <input type="text" name="email" id="task-email" class="form-control">
    </div>
    <label for="task" class="col-sm-3 control-label">Password</label>
    <div class="col-sm-6">
        <input type="password" name="password" id="task-password" class="form-control">
    </div>
    <label for="task" class="col-sm-3 control-label">Confirm Password</label>
    <div class="col-sm-6">
        <input type="password" name="password_confirmation" id="task-password_confirmation" class="form-control">
    </div>
</div>

</div>

<label for="task" class="col-sm-3 control-label">Email</label>

</div>

<label for="task" class="col-sm-3 control-label">Password</label>

</div>

<label for="task" class="col-sm-3 control-label">Confirm Password</label>

</div>

validationはcontrollerに記述します。ここでは、name、email、passwordにvalidationを指定しています。

public function store(Request $request)
{
    $task = new Task;

    // validationの追加
    $rules = [
        'name' => ['required', 'string'],
        'email' => ['email'],
        'password' => ['required', 'min:8', 'confirmed']
    ];
    $this->validate($request, $rules);
    // ここまで

    $task->name = request('name');
    $task->email = request('email');
    $task->password = request('password');
    $task->password_confirmation = request('password_confirmation');
    $task->save();
    return redirect('/tasks');
}

public function store(Request $request)

{

$task = new Task;

// validationの追加

$rules = [

'name' => ['required', 'string'],

'email' => ['email'],

'password' => ['required', 'min:8', 'confirmed']

];

$this->validate($request, $rules);

// ここまで

$task->name = request('name');

$task->email = request('email');

$task->password = request('password');

$task->password_confirmation = request('password_confirmation');

$task->save();

return redirect('/tasks');

}

validationの設定内容について説明します。
「required」は、必須入力項目であることを意味します。入力しない場合、データ登録されません。
「string」は文字列のみを受け付けます。数字を入力すると、データ登録されません。
「email」はメールアドレス形式であるか否かをチェックします。メールアドレス形式でないと、データ登録されません。
「min」は最小文字列数をチェックします。「min:8」とすることで、8文字以上入力されているか否かチェックします。8文字未満では、データ登録されません。
「confirmed」はこの場合は、password_confirmationと同値であるか否かをチェックします。passwordとpassword_confirmationが異なると、データ登録されません。

エラー表示

Laravelでのvalidationのエラー内容を画面表示する方法を紹介します。viewに以下のように記述します。

@if(count($errors) > 0)
    <div class="alert alert-danger">
    <ul>
        @foreach ($errors->all() as $error)
            <li>{{ $error }}</li>
        @endforeach
    </ul>
    </div>
@endif

@if(count($errors) > 0)

<ul>

@foreach ($errors->all() as $error)

<li>{{ $error }}</li>

@endforeach

</ul>

</div>

@endif

何も入力しないまま登録しようとすると、以下のメッセージが表示されます。

The name field is required.
The email must be a valid email address.
The password field is required.

The name field is required.

The email must be a valid email address.

The password field is required.

validationのエラー内容がリスト形式で表示されることが分かります。
特定のエラー内容のみ表示するには、以下のように記述します。

@if($errors->has('password'))
    <div class="error">
        <p>{{ $errors->first('password') }}</p>
    </div>
@endif

@if($errors->has('password'))

<p>{{ $errors->first('password') }}</p>

</div>

@endif

何も入力しないまま登録しようとすると、以下のメッセージが表示されます。

The password field is required.

1	The password field is required.

passwordのエラーのみが表示されることが分かります。password以外のvalidationエラーは表示されません。
このようにLaravelでは、validationのエラー内容を取得、表示できます。

unique

Laravelにて、テーブル内でユニークであるか否かをチェックするuniqueについて紹介します。実際のソースコードを見てみましょう。

public function store(Request $request)
{
    $task = new Task;

    // validationの追加
    $rules = [
        'name' => ['required', 'string', 'unique:tasks'],
        'email' => ['email'],
        'password' => ['required', 'min:8', 'confirmed']
    ];
    $this->validate($request, $rules);
    // ここまで

    $task->name = request('name');
    $task->email = request('email');
    $task->password = request('password');
    $task->password_confirmation = request('password_confirmation');
    $task->save();
    return redirect('/tasks');
}

public function store(Request $request)

{

$task = new Task;

// validationの追加

$rules = [

'name' => ['required', 'string', 'unique:tasks'],

'email' => ['email'],

'password' => ['required', 'min:8', 'confirmed']

];

$this->validate($request, $rules);

// ここまで

$task->name = request('name');

$task->email = request('email');

$task->password = request('password');

$task->password_confirmation = request('password_confirmation');

$task->save();

return redirect('/tasks');

}

1レコード登録後に、nameに同じ値を使ってレコード登録しようとすると、以下のようにvalidationエラーになります。

The name has already been taken.

1	The name has already been taken.

このようにLaravelでは、テーブル内でユニークであるか否かをチェックできます。

bail

Laravelでvalidationエラーになったら、以降のvalidationチェックをしないbailについて紹介します。実際のソースコードを見てみましょう。

$rules = [
    'name' => ['bail', 'required', 'string', 'unique:tasks'],
    'email' => ['email'],
    'password' => ['required', 'min:8', 'confirmed']
];
$this->validate($request, $rules);

$rules = [

'name' => ['bail', 'required', 'string', 'unique:tasks'],

'email' => ['email'],

'password' => ['required', 'min:8', 'confirmed']

];

$this->validate($request, $rules);

例えば、nameのstringでvalidationエラーになった場合、uniqueはチェックしません。

システム エンジニア: Laravelでのvalidationの基本的な使い方やエラーがわかりました。

プロジェクト マネージャー: 解説を参考に試してみてください。

まとめ

いかがでしたでしょうか。Laravelでのvalidationの使い方について説明しました。validationを使うと、入力項目のチェックができます。
これ以外にも多くのvalidationチェックが可能です。
ぜひご自身でLaravelのソースコードを書いて、理解を深めてください。

FEnet.NETナビ・.NETコラムは株式会社オープンアップシステムが運営しています。

株式会社オープンアップシステムはこんな会社です

秋葉原オフィスには株式会社オープンアップシステムをはじめグループのIT企業が集結！
数多くのエンジニアが集まります。

スマホアプリから業務系システムまで

スマホアプリから業務系システムまで開発案件多数。システムエンジニア・プログラマーとしての多彩なキャリアパスがあります。
充実した研修制度

毎年、IT技術のトレンドや社員の要望に合わせて、カリキュラムを刷新し展開しています。社内講師の丁寧なサポートを受けながら、自分のペースで学ぶことができます。
資格取得を応援

スキルアップしたい社員を応援するために資格取得一時金制度を設けています。受験料(実費)と合わせて資格レベルに合わせた最大10万円の一時金も支給しています。
東証プライム上場企業グループ

オープンアップシステムは東証プライム上場「株式会社オープンアップグループ」のグループ企業です。

安定した経営基盤とグループ間のスムーズな連携でコロナ禍でも安定した雇用を実現させています。

株式会社オープンアップシステムに興味を持った方へ

株式会社オープンアップシステムでは、開発系エンジニア・プログラマを募集しています。

年収をアップしたい！スキルアップしたい！大手の上流案件にチャレンジしたい！
まずは話だけでも聞いてみたい場合もOK。お気軽にご登録ください。

株式会社オープンアップシステムへ応募する
会員登録不要! カンタン45秒!

Laravelでのvalidationを使いこなす！基礎やエラーを実例で解説

Laravelでのvalidationの使い方とは？

基本的な使い方

エラー表示

unique

bail

まとめ

株式会社オープンアップシステムはこんな会社です

スマホアプリから業務系システムまで

充実した研修制度

資格取得を応援

東証プライム上場企業グループ

株式会社オープンアップシステムに興味を持った方へ

新着案件New Job

開発エンジニア/東京都品川区/【WEB面談可】/在宅ワーク

遠隔テストサービス機能改修/JavaScript/東京都港区/【WEB面談可】/テレワーク

病院内システムの不具合対応、保守/東京都豊島区/【WEB面談可】/テレワーク

開発/JavaScript/東京都豊島区/【WEB面談可】/テレワーク

債権債務システム追加開発/東京都文京区/【WEB面談可】/在宅勤務

PMO/東京都豊島区/【WEB面談可】/在宅勤務

Laravelでのvalidationを使いこなす！基礎やエラーを実例で解説

Laravelでのvalidationの使い方とは？

基本的な使い方

エラー表示

unique

bail

まとめ

株式会社オープンアップシステムはこんな会社です

スマホアプリから業務系システムまで

充実した研修制度

資格取得を応援

東証プライム上場企業グループ

株式会社オープンアップシステムに興味を持った方へ

新着案件New Job

開発エンジニア/東京都品川区/【WEB面談可】/在宅ワーク

遠隔テストサービス機能改修/JavaScript/東京都港区/【WEB面談可】/テレワーク

病院内システムの不具合対応、保守/東京都豊島区/【WEB面談可】/テレワーク

開発/JavaScript/東京都豊島区/【WEB面談可】/テレワーク

債権債務システム追加開発/東京都文京区/【WEB面談可】/在宅勤務

PMO/東京都豊島区/【WEB面談可】/在宅勤務

関連記事Related Posts

LaravelでのSeederの使い方｜クラス定義やデータ登録のコード例

LaravelでのLoggingの使い方とは？基本的な使い方やログについて紹介！

Laravelでのsessionの扱い方とは？sessionを学んで正しく扱おう！

Laravelのインストール方法とは？インストール手順や環境の作り方を解説

LaravelでVue.jsを利用する方法を解説｜LaravelにおけるVue.jsのセットアップの仕方や使い方