Valitronの使い方 サーバ側フォームバリデーション

composer require vlucas/valitron

% ls
composer.json composer.lock vendor
% less composer.json
{
    "require": {
        "vlucas/valitron": "^1.4"
    }
}

<?php
//ライブラリの読み込み
require_once __DIR__.'/vendor/autoload.php';

//フォームから渡されるデータの配列
$_POST = array(
  'name' => '勘解由小路まさを',
  'email' => ''
);

//インスタンスを作成
$検証 = new Valitron\Validator($_POST);

//バリデーションのルールを適用
$検証->rule('required', ['name', 'email']);
$検証->rule('email', 'email');

//バリデーションの実行
if($検証->validate()) {
  echo 'バリデーションは成功しました';
}
else{
  echo 'バリデーションは失敗しました';
}

//エラーメッセージが入った配列
var_dump($検証->errors());
/*
array(1) {
  ["email"]=>
  array(2) {
    [0]=>
    string(17) "Email is required"
    [1]=>
    string(34) "Email is not a valid email address"
  }
}
*/

//1つのフィールドにルールを適用する場合
$検証->rule('ルール名', 'フィールド名');

//2つ以上のフィールドにルールを適用する場合
$検証->rule('ルール名', ['フィールド名1', 'フィールド名2', ...]);

//ルールによっては3つ以上の引数を取ることもあります
$検証->rule('length', 'username', 10);

//フォームから渡されるデータの配列
$_POST = array(
  'animal' => array(
    array('name' => 'インパラ'),
    array('name' => 'チベットスナギツネ'),
    array('name' => 'マンドリル'),
    array('name' => '')
    )
);

//バリデーションのルールを適用
$検証->rule('required', 'animal.*.name');

Valitron\Validator::addRule(
  'ゆんゆん',
  function($field, $value, array $params, array $fields){
    if($value == 'ゆんゆん'){
      return true;
    }
    else{
      return false;
    }
  },
  '{field}はゆんゆんしてません。'
);

//エラーメッセージの日本語化
Valitron\Validator::lang('ja');

//インスタンスを作成
$検証 = new Valitron\Validator($_POST);

//フィールド名の日本語化
$検証->labels([
  'name' => '名前',
  'email' => 'メールアドレス'
]);

//ja.phpがあるディレクトリを設定
Valitron\Validator::langDir(__DIR__.'/custom-lang');
//エラーメッセージの日本語化
Valitron\Validator::lang('ja');

//ルールの後ろにチェーンする
$検証->rule('required', 'name')->message('{field}の入力は必須だっちゃ');

//さらにフィールド名を設定することも可能
$検証->rule('required', 'name')->message('{field}の入力は必須だっちゃ')->label('名前');

$ルール = [
  'required' => ['name','email'],
  'email' => 'email',
  'lengthMin' => [['email', 5]]
];

$検証->rules($ルール);
$検証->validate();

$ルール = [
  'name' => 'required',
  'email' => ['required', 'email', ['lengthMin', 5]]
];

$検証->mapFieldsRules($ルール);
$検証->validate();