<< Piece_Rightユーザーズマニュアル

はじめに

概要

Piece_RightはPHPのためのバリデーションフレームワークです。

Piece_RightはWebアプリケーション上で入力値の検証を簡単に行えるようにする、汎用のバリデーションシステムを提供します。 Piece_Rightには、すぐに使えるビルトインバリデータがたくさん含まれています。これによって、既存のWebアプリケーションやWebアプリケーションフレームワークで、Piece_Rightをすぐに使い始めることができます。

使用例

下記は、姓と名を入力値とするフォームの検証(バリデーション)例です。Piece_Rightでは、バリデーションの対象となるフィールドのリスト及び各フィールドが満たさなければならないルールをYAML¹フォーマットで記述されたファイルとして用意することができます。この場合、PHPコードにはYAMLファイルの名称を記述します。

---

1. 1. データ表現に適したフォーマット。詳細については、プログラマーのための YAML 入門 (初級編)を参照ください。

/path/to/Example.yaml:

- name: firstName
  description: First Name
  required:
    message: %_description% is required
  validator:
    - name: Length
      rule:
        min: 1
        max: 255
      message: The length of %_description% must be less than %_max% characters

- name: lastName
  description: Last Name
  required:
    message: %_description% is required
  validator:
    - name: Length
      rule:
        min: 1
        max: 255
      message: The length of %_description% must be less than %_max% characters

<?php
require_once 'Piece/Right.php';

$_SERVER['REQUEST_METHOD'] = 'POST';

$right = new Piece_Right('.');
var_dump($right->validate('Example'));
$results = $right->getResults();
var_dump($results->getErrorFields());

$_POST['firstName'] = 'Roland';

$right = new Piece_Right('.');
var_dump($right->validate('Example'));
$results = $right->getResults();
var_dump($results->getErrorFields());

$_POST['firstName'] = 'Roland';
$_POST['lastName'] = 'Deschain';

$right = new Piece_Right('.');
var_dump($right->validate('Example'));
$results = $right->getResults();
var_dump($results->getErrorFields());
?>

上記の例の出力結果は下記のようになります。

bool(false)
array(2) {
  [0]=>
  string(9) "firstName"
  [1]=>
  string(8) "lastName"
}
bool(false)
array(1) {
  [0]=>
  string(8) "lastName"
}
bool(true)
array(0) {
}

---

<< Piece_Rightユーザーズマニュアル

ユーザコメント

Error: Failed to load processor AddComment

No macro or processor named 'AddComment' found