renanhangai/validator

Validate any php variable using a very simple sintax.

Validator

Validate objects against easily defined rules (See API Reference), _(*1)

Installation

composer require renanhangai/validator

Getting Started

Simply validate some data, _(*2)

use libweb\Validator as v;

// Data to be validated
$data = array(
    "name" => "John Doe",
    "age"  => "45",
);
// Validate the data against the rule
$data = v::validate( $data, array(
    "name" => v::s(), //< String validator
    "age"  => v::i(), //< Integer validator
    "address?" => v::s(), //< Optional string validator
));

$data->name === "John Doe";
$data->age === 45;
$data->address === null;

Another Example

Simply validate some data, _(*3)

use libweb\Validator as v;

$data = array(
    "name" => "John Doe",
    "age"  => "45",
    "password" => "123456",
    "children" => array(
        array( "name" => "John Doe Jr", "age" => 15 ),
        array( "name" => "Mary Doe", "age" => 17 ),
    ),
);

$data = v::validate( $data, array(
    "name" => v::s(), //< String validator
    "age"  => v::i(), //< Integer validator
    "password" => v::s()->minlen( 6 ),
    "children" => v::arrayOf(array(
        "name" => v::s(),
        "age"  => v::i(),
    )),
));

Chainability

Every method can be chained by using ->, _(*4)

v::s()->str_replace( "foo", "bar" )->regex('/testbar$/')->minlen(10)
// Will pass on "mytestfoo", "another_testfoo", "testbar", "mytestbar"

, _(*5)

API Reference

Summary

• Type validators
  • any()
  • arrayOf($rule)
  • boolval()
  • b()
  • date($format = null, $out = null)
  • decimal($digits, $decimal, $decimalSeparator = null, $thousandsSeparator = null)
  • floatval($decimal = null, $thousands = null, $asString = false)
  • f($decimal = null, $thousands = null, $asString = false)
  • instanceOf($type)
  • intval()
  • i()
  • obj($definition)
  • strval($trim = true)
  • s($trim = true)
• String rules
  • blacklist($chars)
  • len($min, $max = null)
  • minlen($min)
  • preg_replace($search, $replace)
  • regex($pattern)
  • str_replace($search, $replace)
  • whitelist($chars)
• Mixed
  • call($fn)
  • map($map)
  • set($items)
• Locale rules
  • cnpj()
  • cpf()
• Meta
  • dependsOn()
• Obligatoriness
  • optional()
  • required()
  • skippable()
• Numeric rules
  • range($min, $max)

Methods

• any(), _(*6)

  Validate all objects, _(*7)

• arrayOf($rule), _(*8)

  Validate every element on the array against the $rule, _(*9)

• blacklist($chars), _(*10)

  Remove any char found in $chars from the string, _(*11)

• boolval(), _(*12)

  Convert the value to a boolean, _(*13)

• call($fn), _(*14)

  Call the function $fn to validate the value, _(*15)

• cnpj(), _(*16)

  Brazilian CNPJ validator, _(*17)

• cpf(), _(*18)

  Brazilian CPF validator, _(*19)

• date($format = null, $out = null), _(*20)

  Convert the value to a date using the format (or keep if alredy a \DateTime), _(*21)

• decimal($digits, $decimal, $decimalSeparator = null, $thousandsSeparator = null), _(*22)

  Convert the value to a decimal with $digits and $decimal (needs rtlopes\Decimal), _(*23)

• dependsOn(), _(*24)

  Add a rule dependency. (Only works for objects), _(*25)

• floatval($decimal = null, $thousands = null, $asString = false), _(*26)

  Convert the value to a float, _(*27)

• instanceOf($type), _(*28)

  Check if the object is an instance of the given type, _(*29)

• intval(), _(*30)

  Convert the value to an int and fails if cannot be safely convertible, _(*31)

• len($min, $max = null), _(*32)

  Check for string or array length, _(*33)

• map($map), _(*34)

  Map a value to another, _(*35)

• minlen($min), _(*36)

  Check if string has at least $min length, _(*37)

• obj($definition), _(*38)

  Convert the value to an object and validate its fields, _(*39)

• optional(), _(*40)

  Optional validator (Bypass if null or ''), _(*41)

• preg_replace($search, $replace), _(*42)

  Replace the $search pattern on the string using $replace (Callback or string), _(*43)

• range($min, $max), _(*44)

  Range validator, _(*45)

• regex($pattern), _(*46)

  Validate the value against the $pattern, _(*47)

• required(), _(*48)

  Required validator (Fails if null or ''), _(*49)

• set($items), _(*50)

  Check if value is in set, _(*51)

• skippable(), _(*52)

  Skippable validator (Bypass if null or '' and does not set the property), _(*53)

• str_replace($search, $replace), _(*54)

  Replace the characters on the string, _(*55)

• strval($trim = true), _(*56)

  Convert the object to a string value, _(*57)

• whitelist($chars), _(*58)

  Remove any char NOT found in $chars from the string, _(*59)