harp-orm / validate
Object validaiton library
Installs: 1 110
Dependents: 3
Suggesters: 0
Security: 0
Stars: 1
Watchers: 6
Forks: 0
Open Issues: 1
This package is auto-updated.
Last update: 2024-10-21 20:46:43 UTC
README
Harp Validate is a validation library. It generates errors for objects based on a predefined assertions.
Quick Example:
use Harp\Validate\Assert; use Harp\Validate\Asserts; $asserts = new Asserts(array( new Assert\Present('title'), new Assert\LengthBetween('title', 20, 100), new Assert\Email('newsletter_email'), )); $subject = new stdClass(); $subject->title = 'small title'; $subject->newsletter_email = 'invalid email'; // title should be between 10 and 20 letters, newsletter_email should be a valid email echo $asserts->getErrors($subject);
Errors
The result of $asserts->getErrors($subject)
is actually an Errors
object. It's an Iterator that holds all the erorrs and has ->humanize()
mehtod to display all the errors.
You can also foreach it and get all the errors separately. Casting it to string calls ->humanize()
automatically.
$errors = $asserts->getErrors($subject); foreach($errors => $error) { echo $error->getName(); echo $error->getMessage(); }
You can also traverse through the Errors object using getFirst
and getNext
methods.
$errors = $asserts->validate($subject); echo $errors->getFirst(); echo $errors->getNext();
ValidateTrait
You can also add a special trait to an object to make it "validatable".
use Harp\Validate\ValidateTrait; use Harp\Validate\Asserts; use Harp\Validate\Assert\Present; class Model { use ValidateTrait; public $test; public function getValidationAsserts() { return new Asserts(array( new Present('test'), )); } }
It will addd these methods to your class:
Available Asserts
Callback
Assert that the result of a given callback is true. You must use a closure object, and will recieve the subject and the value as arguments.
new Callback('state', function ($subject, $value) { return $value !== 'test'; })
Assert if the value is not a proper email address. uses a small and fast regex which should handle most cases.
new Email('email_address') new Email('email_address', 'some custom message')
EmailStrict
Assert if the value is not a proper email address. Uses a slower but more comprehensive check thane Email
.
new EmailStrict('email_address') new EmailStrict('email_address', 'some custom message')
GreaterThan
Assert that the value is greater than a set length. Value can be int or float or even numeric string
new GreaterThan('price', 20) new GreaterThan('price', 20, 'some custom message')
InArray
Assert if the value is present in an array, uses a simple in_array
call. Will throw InvalidArgumentException if the array is empty.
new InArray('state', array('big', 'small')) new InArray('state', array('big', 'small'), 'some custom message')
IP
Assert that the value's is a valid IP address uses filter_var()
internally
new IP('last_login_ip') new IP('last_login_ip', 'some custom message')
IsInstanceOf
Assert if the value is an object of a given class is_a
call. Will throw InvalidArgumentException if the class does not exist.
new IsInstanceOf('state', 'My\Example\Item') new IsInstanceOf('state', 'My\Example\Item', 'some custom message')
LengthBetween
Assert that the value's string length is between two set lengths (including). Uses mb_strlen()
internally.
new LengthLessThan('name', 10, 200) new LengthLessThan('name', 10, 200, 'some custom message')
LengthEquals
Assert that the value is of exact string length. Uses mb_strlen()
internally.
new LengthEquals('name', 20), new LengthEquals('name', 20, 'some custom message')
LengthGreaterThan
Assert that the value's string length is longer than a set length. Uses mb_strlen()
internally.
new LengthGreaterThan('name', 20) new LengthGreaterThan('name', 20, 'some custom message')
LengthLessThan
Assert that the value's string length is shorter than a set length. Uses mb_strlen()
internally.
new LengthLessThan('name', 20) new LengthLessThan('name', 20, 'some custom message')
LessThan
Assert that the value is less than a set length. Value can be int or float or even numeric string
new LessThan('price', 20) new LessThan('price', 20, 'some custom message')
Matches
Assert that a value of one property matches to the value of another
new Matches('password', 'password_confirmation') new Matches('password', 'password_confirmation', 'some custom message')
IsInteger
Assert that the value is a integer number.
new IsInteger('quantity') new IsInteger('quantity', 'some custom message')
IsFloat
Assert that the value is a float number.
new IsFloat('frequency') new IsFloat('frequency', 'some custom message')
Present
Assert if the value is empty
new Present('title') new Present('title', 'some custom message if needed')
RegEx
Assert that the value matches a given regex. Passed directly to preg_match()
new RegEx('card_number', '/\d{20}/') new RegEx('card_number', '/\d{20}/', 'some custom message')
URL
Assert if the value is a valid url. Converts all UTF related charecters in the url to their proper encoding. It also will convert non-ASCII domain names, using "idn" if the "intl" extension is available. This is similar to what browsers normally do.
new URL('website') new URL('website', 'some custom message')
URLStrict
Assert if the value is a valid url. Uses php's filter_var()
method.
new URLStrict('website') new URLStrict('website', 'some custom message')
AssertsTrait
This trait gives you the ability to easily add assertions to another object.
class TestConfig { use AssertsTrait; } $config = new TestConfig(); $config ->assertPresent('name') ->assertURL('homepage', 'must have a valid homepage'); // Return the Asserts object $config->getAsserts();
Here are all the methods added by this trait.
License
Copyright (c) 2014, Clippings Ltd. Developed by Ivan Kerin as part of clippings.com
Under BSD-3-Clause license, read LICENSE file.