Bouncer's Book is a PHP form validator.
This README is currently the only documentation.
PHP 5.3 or higher and Composer. The tests require Corn Wand.
The project is on GitHub. The source code is one class.
All the tests are in the test directory.
Each PHP script in the top level test directory is a separate test.
You need to run composer install in the test directory before running any of the tests.
Tests 1-3 test the first, second and third constructor parameters respectively.
Test 4 tests the more() method.
Install using composer:
{
"require": {
"bouncers-book/bouncers-book": "0.5.0",
}
}Set up a form validator class:
namespace silver\validator;
class Validator1 extends \bbook\FormValidator {
public function __construct() {
//list all the form inputs
parent::__construct(array(
'input1',
'input2'));
}
//validate form inputs with validate_ methods
//return null if valid
protected function validate_input1($value) {
if(!preg_match('/^[a-z0-9]{1,10}$/i', $value)) {
return 'Input 1 must be 1-10 characters; letters and numbers only';
}
}
//validate method for input2
protected function validate_input2($value) {
if(strlen($value) < 6) {
return 'Input 2 must be 6 or more characters';
}
}
}Validate $_POST with validate():
require 'vendor/autoload.php';
$validator = new silver\validator\Validator1();
if(list($input_values, $errors) = $validator->validate()) {
$content = $errors
//re-display form if there is an error
? form1($input_values, $errors)
//no errors, process form data
: c\pre(print_r($input_values, true));
}
else {
//form not submitted, first time user arrives at website
$content = form1($validator->values());
$autofocus = c\focus('input1');
}
include 'src/silver/html/template.php';Use the second constructor parameter to specify which submitted inputs are optional:
namespace silver\validator;
class Validator2 extends \bbook\FormValidator {
public function __construct() {
parent::__construct(
//list form inputs and default values
array(
'input1',
'pizzas' => array()),
//list optional inputs, pizzas is checkboxes
array('pizzas'));
}
protected function validate_input1($value) {
if(!preg_match('/^[a-z0-9]{1,10}$/i', $value)) {
return 'Input 1 must be 1-10 characters; letters and numbers only';
}
}
protected function validate_pizzas($value) {
if(count($value) != 2) {
return 'Choose 2 types of pizza';
}
}
}Use the third constructor parameter to specify the data to validate:
namespace silver\validator;
class Validator3 extends \bbook\FormValidator {
public function __construct() {
parent::__construct(
//list form inputs
array(
'input1',
'input2'),
//which are optional? none
array(),
//validate this data instead of $_POST
array(
'input1' => 'Fred?',
'input2' => '123456'));
}
protected function validate_input1($value) {
if(!preg_match('/^[a-z0-9]{1,10}$/i', $value)) {
return 'Input 1 must be 1-10 characters; letters and numbers only';
}
}
protected function validate_input2($value) {
if(strlen($value) < 6) {
return 'Input 2 must be 6 or more characters';
}
}
}Use more() to validate more than one value at a time:
namespace silver\validator;
class Validator4 extends \bbook\FormValidator {
public function __construct() {
parent::__construct(array(
'input1',
'input2'));
}
protected function validate_input1($value) {
if(trim($value) == '') {
return 'Please enter a value for Input 1';
}
}
protected function validate_input2($value) {
if(trim($value) == '') {
return 'Please enter a value for Input 2';
}
}
protected function more($values) {
if(trim($values['input1']) != '' &&
trim($values['input2']) != '' &&
$values['input1'] != $values['input2'])
{
return 'Input 1 and Input 2 must be the same';
}
}
}