kubinyete / assertation
There is no license information available for the latest version (1.0.4) of this package.
Provides a Assert class that enables you to valide your data
1.0.4
2023-12-22 20:45 UTC
Requires (Dev)
- phpunit/phpunit: ^9.5
- symfony/var-dumper: ^5.4
README
Assertation is a free and simple to use validation library, it's built to allow a more expressive syntax while applying data validation and mantaining an assert-oriented approach.
Getting started
To get started, please use our own package directly with Composer:
composer require kubinyete/assertation
Usage
First of all, we can start understanding the objective of this approach by looking at some examples and comparisons,
below are some equivalent validations with and without assertation
.
$data = ' Spaced text '; // This validation: $validated = ($data = trim($data)) && strlen($data) > 2; if (!$validated) { throw new UnexpectedValueException('Data is required with at least 2 characters'); } // Is equivalent to: $data = Assert::value($data)->asTrim()->lgt(2)->validate()->get(); // And also equivalent to: $data = Assert::value($data)->rules('asTrim;lgt,2')->get();
The following examples are a more complex validation, for simple ones it's easier to do natively, but when our validation
rules become more complex, assertation
can easily validate and modify our data in a more expressive way.
$data = Assert::value($data)->rules('null|str;asTrim;asUppercase;asTruncate,100;lgt,1')->get(); // Data can either be null or a string that has a minimum of 1 character and has every character in uppercase // while limiting the maximum size to 100 characters with a ellipsis cutoff. $data = Assert::value($data)->rules('null|float|asDecimal')->get(); // Data can either be null, a float or a string with a decimal number (Ex: 123.23). $data = Assert::value($data)->null()->or()->asUppercase()->asTrim()->in(['HELLO', 'WORLD'])->get(); // Data can either be null or be 'hello' or 'world' with case insensitivity, resulting only in a upper case result.