Laravelでのバリデーションの使い方｜バリデーションルールの記述・エラーの表示と日本語化

Laravel

PHP
プログラミング言語

公開日時: 2021-03-19 　更新日時: 2022-06-01

Laravelでのバリデーションの使い方｜バリデーションルールの記述・エラーの表示と日本語化

この記事でわかること

システム エンジニア: Laravelの学習で、バリデーションでつまづいてしまって困っています。

プロジェクト マネージャー: では、バリデーションとは入力情報が正しいか確認する処理・機能のことです。以下で詳しく見ていきましょう。

Laravelでのバリデーションの使い方を紹介します！

今回は、Laravelでのバリデーションの使い方について説明します。バリデーションとは、入力規則に沿っているかチェックする機構のことです。Laravelでは、バリデーションが用意されているので、入力チェックを簡単に行うことができます。

例えば、
・必須入力項目を入力しているか？
・数字で入力しているか？
・文字列の場合、指定桁数の範囲内で入力しているか？
・e-mailの形式で入力しているか？
など、これ以外にも様々なチェックが行えます。

Laravelでのバリデーションに興味のある方はぜひご覧ください。

migrationファイル

バリデーションの前に、Laravelアプリケーションを作成してください。ここでは、以下のようなスキーマとします。id, name, age, emailのカラムを持ちます。

public function up()
{
    Schema::create('my_users', function (Blueprint $table) {
        $table->id();
        $table->string('name');
        $table->integer('age');
        $table->string('email');
        $table->timestamps();
    });
}

public function up()

{

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

$table->id();

$table->string('name');

$table->integer('age');

$table->string('email');

$table->timestamps();

});

}

バリデーションルールの記述

Laravelのバリデーションはcontrollerに記述します。ここでは、データ登録時にバリデーションチェックします。実際のソースコードを見てみましょう。

/**
 * Store a newly created resource in storage.
 *
 * @param  \Illuminate\Http\Request  $request
 * @return \Illuminate\Http\Response
 */
public function store(Request $request)
{
    $myUser = new MyUser;

    // バリデーションの追加
    $rules = [
        'name' => ['required', 'string'],
        'age' => ['required', 'integer', 'between:1,99'],
        'email' => ['required', 'email']
    ];
    $this->validate($request, $rules);
    // ここまで

    $myUser->name = request('name');
    $myUser->age = request('age');
    $myUser->email = request('email');
    $myUser->save();
    return redirect('/myusers');
}

/**

* Store a newly created resource in storage.

* @param \Illuminate\Http\Request $request

* @return \Illuminate\Http\Response

public function store(Request $request)

{

$myUser = new MyUser;

// バリデーションの追加

$rules = [

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

'age' => ['required', 'integer', 'between:1,99'],

'email' => ['required', 'email']

];

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

// ここまで

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

$myUser->age = request('age');

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

$myUser->save();

return redirect('/myusers');

}

Laravelのバリデーションは複数チェックすることもできます。
requiredは必須項目、stringは文字列、integerは整数値、betweenは範囲指定、emailはe-mail形式のチェックが可能です。

バリデーションエラーの表示

バリデーションのチェック結果をviewに表示します。実際のソースコードを見てみましょう。

<!DOCTYPE html>
<html>
    <head>
        <title>User List</title>
        <!-- CSS And JavaScript -->
        <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Roboto:300,300italic,700,700italic">
        <link rel="stylesheet" href="//cdn.rawgit.com/necolas/normalize.css/master/normalize.css">
        <link rel="stylesheet" href="//cdn.rawgit.com/milligram/milligram/master/dist/milligram.min.css">
    </head>
    <body>
        <div class="container">
            <h1>User List</h1>
            <!-- Laravelバリデーションのエラー表示 -->
            @if(count($errors) > 0)
            <div class="alert alert-danger">
            <ul>
                @foreach ($errors->all() as $error)
                    <li>{{ $error }}</li>
                @endforeach
            </ul>
            </div>
            @endif
            <form action="/myusers" method="POST" class="form-horizontal">
                {{ csrf_field() }}
                <!-- User Name -->
                <div class="form-group">
                    <label for="myuser" class="col-sm-3 control-label">Name</label>
                    <div class="col-sm-6">
                        <input type="text" name="name" id="myuser-name" class="form-control">
                    </div>
                    <label for="myuser" class="col-sm-3 control-label">Age</label>
                    <div class="col-sm-6">
                        <input type="text" name="age" id="myuser-age" class="form-control">
                    </div>
                    <label for="myuser" class="col-sm-3 control-label">Email</label>
                    <div class="col-sm-6">
                        <input type="text" name="email" id="myuser-email" class="form-control">
                    </div>
                </div>

                <!-- Add User Button -->
                <div class="form-group">
                    <div class="col-sm-offset-3 col-sm-6">
                        <button type="submit" class="btn btn-default">
                            <i class="fa fa-plus"></i> Add User
                        </button>
                    </div>
                </div>
            </form>

            <!-- Current Users -->
            <h2>Current Users</h2>
            <table class="table table-striped task-table">
                <thead>
                    <th>Name</th><th>Birthday</th><th>Email</th><th> </th>
                </thead>

                <tbody>
                    @foreach ($myusers as $myuser)
                        <tr>
                            <!-- User Name -->
                            <td>
                                <div>{{ $myuser->name }}</div>
                            </td>
                            <td>
                                <div>{{ $myuser->age }}</div>
                            </td>
                            <td>
                                <div>{{ $myuser->email }}</div>
                            </td>
                            <td>
                                <form action="/myusers/{{ $myuser->id }}" method="POST">
                                    {{ csrf_field() }}
                                    {{ method_field('DELETE') }}                    
                                    <button>Delete User</button>
                                </form>
                            </td>
                        </tr>
                    @endforeach
                </tbody>
            </table>
        </div>
    </body>
</html>

<!DOCTYPE html>

<html>

<head>

</head>

<body>

@if(count($errors) > 0)

<ul>

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

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

@endforeach

</ul>

</div>

@endif

</div>

</div>

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

</div>

<i class="fa fa-plus"></i> Add User

</button>

</div>

</form>

<h2>Current Users</h2>

<thead>

<th>Name</th><th>Birthday</th><th>Email</th><th> </th>

</thead>

<tbody>

@foreach ($myusers as $myuser)

<tr>

<td>

<div>{{ $myuser->name }}</div>

</td>

<td>

<div>{{ $myuser->age }}</div>

</td>

<td>

<div>{{ $myuser->email }}</div>

</td>

<td>

<form action="/myusers/{{ $myuser->id }}" method="POST">

<button>Delete User</button>

</form>

</td>

</tr>

@endforeach

</tbody>

</table>

</div>

</body>

</html>

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

The name field is required.
The age field is required.
The email field is required.

The name field is required.

The age field is required.

The email field is required.

バリデーションエラーの日本語化

Laravelバリデーションのチェック結果はデフォルトでは英語で表示されます。日本語にする方法を紹介します。controllerを以下のように修正します。

/**
 * Store a newly created resource in storage.
 *
 * @param  \Illuminate\Http\Request  $request
 * @return \Illuminate\Http\Response
 */
public function store(Request $request)
{
    $myUser = new MyUser;

    // バリデーションの追加
    $this->validate($request, [
        'name' => ['required', 'string'],
        'age' => ['required', 'integer', 'between:1,99'],
        'email' => ['required', 'email'],
    ], [
        'name.required' => ':attributeは必須です。',
        'age.required' => ':attributeは必須です。',
        'age.between' => ':attributeは:minから:maxまでです。',
        'email.required' => 'メールアドレスは必須です。',
    ], [
        'name' => '名前',
        'age' => '年齢',
    ]);
    // ここまで

    $myUser->name = request('name');
    $myUser->age = request('age');
    $myUser->email = request('email');
    $myUser->save();
    return redirect('/myusers');
}

/**

* Store a newly created resource in storage.

* @param \Illuminate\Http\Request $request

* @return \Illuminate\Http\Response

public function store(Request $request)

{

$myUser = new MyUser;

// バリデーションの追加

$this->validate($request, [

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

'age' => ['required', 'integer', 'between:1,99'],

'email' => ['required', 'email'],

], [

'name.required' => ':attributeは必須です。',

'age.required' => ':attributeは必須です。',

'age.between' => ':attributeは:minから:maxまでです。',

'email.required' => 'メールアドレスは必須です。',

], [

'name' => '名前',

'age' => '年齢',

]);

// ここまで

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

$myUser->age = request('age');

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

$myUser->save();

return redirect('/myusers');

}

何も入力せずに実行すると、以下のメッセージが表示されます。

名前は必須です。
年齢は必須です。
メールアドレスは必須です。

名前は必須です。

年齢は必須です。

メールアドレスは必須です。

氏名とメールアドレスを入力し、年齢に100などと入力して実行すると、以下のメッセージが表示されます。

年齢は1から99までです。

1	年齢は1から99までです。

システム エンジニア: 英語でエラー表示されるのでつまづいていた気がします。日本語で表示できるなら理解しやすいですね。

プロジェクト マネージャー: そうなんです。Webサービスでは必ず使われる機能なので頑張ってマスターしてください。

まとめ

いかがでしたでしょうか。Laravelでのバリデーションの使い方について説明しました。

controllerにバリデーションのルールを記述することで、簡単に入力チェックが可能です。複数のルールを指定することもできます。また、バリデーションエラーのメッセージを日本語化する方法についても紹介しました。

ぜひご自身でLaravelのソースコードを書いて、理解を深めてください。

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

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

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

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

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

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

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

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

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

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

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

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

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

Laravelでのバリデーションの使い方｜バリデーションルールの記述・エラーの表示と日本語化

Laravelでのバリデーションの使い方を紹介します！

migrationファイル

バリデーションルールの記述

バリデーションエラーの表示

バリデーションエラーの日本語化

まとめ

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

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

充実した研修制度

資格取得を応援

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

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

PHP新着案件New Job

ECサイトの開発/HTML/東京都千代田区/【WEB面談可】/在宅勤務

採用管理システム運用保守/Apache/東京都渋谷区/【WEB面談可】

採用管理システム開発のテスター/Apache/東京都渋谷区/【WEB面談可】

社内システムの開発/PHP/神奈川県相模原市/【WEB面談可】/在宅勤務

販売管理システム開発支援SE/PHP/東京都渋谷区/【WEB面談可】/テレワーク

採用管理システムリプレース、追加開発/Apache/東京都渋谷区/【WEB面談可】

Laravelでのバリデーションの使い方｜バリデーションルールの記述・エラーの表示と日本語化

Laravelでのバリデーションの使い方を紹介します！

migrationファイル

バリデーションルールの記述

バリデーションエラーの表示

バリデーションエラーの日本語化

まとめ

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

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

充実した研修制度

資格取得を応援

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

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

PHP新着案件New Job

ECサイトの開発/HTML/東京都千代田区/【WEB面談可】/在宅勤務

採用管理システム運用保守/Apache/東京都渋谷区/【WEB面談可】

採用管理システム開発のテスター/Apache/東京都渋谷区/【WEB面談可】

社内システムの開発/PHP/神奈川県相模原市/【WEB面談可】/在宅勤務

販売管理システム開発支援SE/PHP/東京都渋谷区/【WEB面談可】/テレワーク

採用管理システムリプレース、追加開発/Apache/東京都渋谷区/【WEB面談可】

関連記事Related Posts

Laravelの主な特徴とは？Laravelの導入方法とおすすめ理由7選も解説

Laravel入門｜PHPフレームワークによるWebサイトの作成方法について解説！

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

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

Laravelとは？Docker-compose.ymlの作成・Laravel開発環境を構築する方法