Repository navigation
First major release
The Respect development team announces the immediate availability of
Respect\Validation 1.0.0.
This version is going to be supported until 2017-02-24.
This release adds 26 new rules, add some features (specially on exceptions),
removes existing features, and fixes some bugs.
Another version of this file is available with the source on the
CHANGELOG.md file.
We would like to thanks to the PHPSP community for all the support on the
first TestFest Respect\Validation, that brings us 51 commits, 135 created
integration tests, 12 improved unit tests, 2 bugs found, 4 new rules and 1
improved rule: you guys are awesome!
New rules
BoolVal;Bsn;CallableType;Countable;CurrencyCode;Extension;Factor;Finite;FloatType;Identical;Imei;Infinite;IntType;Iterable;KeyNested;KeySet;KeyValue;Mimetype;NotBlank;NotOptional;Optional;ResourceType;ScalarVal;Size;SubdivisionCode(252 countries);VideoUrl.
New features
The main new features are related to the exceptions:
- Nested messages are now displayed on a Markdown list format;
- Does not display parent message if the rule has only one child;
- Creates method
getMessages()for nested exceptions
(NestedValidationException); - Converts
Arrayto string; - Converts
Exceptionto string; - Converts
Traversableto string; - Converts resources to string;
- Improves
Objectconversion to string; - Improves conversion of all values by using JSON.
But also there are a few improvements for some rules:
- Adds
alpha-3andnumericformats forCountryCoderule - Adds
{{countryCode}}to the message ofPostalCodeexception rule - Adds generic top-level domains
Bug fixes
- Nested exceptions with missing keys did not display the proper message
AbstractRelated(Attribute,CallandKeyrules) defines names for
children rulesTrueandFalserules (nowTrueValandFalseVal) had an awkward
behavior, now they usefilter_var()withFILTER_VALIDATE_BOOLEANto
validate their inputs
PHP support
- Drops support for PHP 5.3
- Adds support for PHP 7
Backwards Compatibility Breaks
The main change of this version it that, despite what happens since version
0.6, now all rules are mandatory, so they do not accept an empty string
('') as valid value, and because of this you don't need to add NotEmpty
to every chain you want as mandatory. That change was only made after many
opened bugs reporting problems on this feature and since this feature cannot
work property with the code-base we have without an ugly hard-coded workaround.
Plus, there were lots of people complaining about what should be optional or
not, and many of them consider null as an optional value too.
However, you're still able work with optional values (that now are an empty
string '' and null) by using the Optional rule:
v::optional(v::intType())->validate(''); // true
v::optional(v::intType())->validate(null); // trueAlso, there is the NotOptional rule that may be very useful for you when
dealing with non-optional values.
Some rule needed to be renamed to be compatible with PHP 7:
BooltoBoolTypeFalsetoFalseValFloattoFloatValInttoIntValStringtoStringTypeTruetoTrueVal
Then, to keep consistency, other rules got renamed as well:
ArrtoArrayValNullValuetoNullTypeObjecttoObjectType
The old Arr rule, now ArrayVal, got splitted into 4 rules:
ArrayVal: validates if the input is an array or if the input can be used as
an array;ArrayType: validates whether the type of the input is array;Countable: validates if the input is countable, in other words, if you're
able to use count() function on it;Iterable: validates if the input is iterable, in other words, if you're
able to iterate over it with foreach language
construct.
The Equals rule got splitted into 2 rules:
Equals: validates if the input is equal to some value, with not longer
supports the second argument on its constructor for identical checking;Identical: Validates if the input is identical to some value.
Rules that validate intervals are now inclusive, by default:
BetweenMaxMin
Some exception classes had the Abstract prefix, but they were not really
abstract, then they got renamed:
AbstractGroupedExceptiontoGroupedValidationExceptionAbstractNestedExceptiontoNestedValidationException
Some exception interfaces were not really necessary, then they got removed:
NestedValidationExceptionInterface:
Ontry/catchblocks you can simply useNestedValidationExceptioninsteadValidationExceptionInterface:
Ontry/catchblocks you can simply useValidationExceptioninstead
All deprecated rules were removed:
Consonantsin favor ofConsonant;Digits: in favor ofDigitHexain favor ofXdigits;Vowels: in favor ofVowel
Also, all shortcuts were removed:
addOr()shortcutnot()shortcut