List of Validators

The Zoop Validator Component is used by a number of the other components, particularly guiControl and Forms.

It provides type based validation that can be used to validate user_input, or anything else you can think of.

Here is a table of the current validators:

Using Validate

All the validation functions are statically callable. They follow the following pattern, using Int as an example.

The Call:

Validator::validateInt($value, array('min' => 3, 'max' => 7));

Returns an array ($result), with the following structure:

$result['result'] = false; // or true depending on validation
$result['message'] = "Message to Display to the User when False";

GuiControls and Forms both use integrate the use of validator. Simple by defining the validate parameters of either, you will be using validator.

There are also a handful of special functions to help you in implementing validation in your code.

Special Functions

Validate

validate wrapper for the functions in this class.

The validate array must have 'type' => $type set for this to work. The type is any found in the above table (and php able).

This function also permits 'required' as a parameter in the array(). Without required set to true, a value will validate as true if it is either empty, null, or validates.

Example:

Validator::validate($value, array('type' => 'email', 'required' => 'true'));

boolValidate

validate wrapper for the functions in this class. Works like validate, but returns a boolean (true / false) value rather than an array.

The validate array must have 'type' => $type set for this to work. The type is any found in the above table (and php able).

Example:

Validator::boolValidate($value, array('type' => 'email'));

validateStack

This function will validate more than one validator, stacked in order one at a time. Permits validating things like Alpahnumeric & Length together for example.

It will return as soon as one of the validators fails. This is particularly useful if one of the validators performs a sql check.

The validate array must have 'validators' => array of individual "validate" arrays  set for this to work.validate wrapper for the functions in this class.

Example:

Validator::validateStack($value, array('required' => true, 
   'validators' =>
      array(
	array('type' => 'AlphaNumeric'),
	array('type' => 'length', "min" => 4, "max" => 20),
	array('type' => 'dbUnique', 'field' => 'username', 'table' => 'users')
 )));

validateMerge

This function will validate more than one validator, stacked in order one at a time. Permits validating things like Alpahnumeric & Length together for example.

It will perform all validations before it returns the combined results.

The validate array must have 'validators' => array of individual "validate" arrays  set for this to work.validate wrapper for the functions in this class.

Example:

Validator::validateMerge($value, array('required' => true, 
   'validators' =>
      array(
	array('type' => 'AlphaNumeric'),
	array('type' => 'length', "min" => 4, "max" => 20),
	array('type' => 'dbUnique', 'field' => 'username', 'table' => 'users')
 )));