mirror of https://github.com/Respect/Validation.git synced 2026-03-17 15:50:03 +01:00

Henrique Moody 562d98d805

Refactor the NotEmpty rule

Since we have the ability to use `not` as a prefix, having rules that
validate negative behaviour makes them a bit inflexible, verbose, and
harder to understand.

This commit will refactor the `NotEmpty`, and rename it to `Falsy`. It
will no longer trim strings, because Blank does a much better job at it;
it only simulates the behaviour of PHP’s native `empty()` function.

Because `Falsy`, `Blank`, and `Undef` have similar behaviour, I created
a page to demonstrate the difference and show when the user should use
one or the other.

Assisted-by: Cursor (claude-4.5-opus-high)

2025-12-29 12:48:35 +01:00

1.8 KiB

Raw Blame History

Blank

Blank()

Validates if the given input is a blank value (null, zeros, empty strings or empty arrays, recursively).

We recommend you to check Comparing empty values for more details.

v::blank()->isValid(null); // true
v::blank()->isValid(''); // true
v::blank()->isValid([]); // true
v::blank()->isValid(' '); // true
v::blank()->isValid(0); // true
v::blank()->isValid('0'); // true
v::blank()->isValid(0); // true
v::blank()->isValid('0.0'); // true
v::blank()->isValid(false); // true
v::blank()->isValid(['']); // true
v::blank()->isValid([' ']); // true
v::blank()->isValid([0]); // true
v::blank()->isValid(['0']); // true
v::blank()->isValid([false]); // true
v::blank()->isValid([[''], [0]]); // true
v::blank()->isValid(new stdClass()); // true

It's similar to Falsy, but way stricter.

Templates

`Blank::TEMPLATE_STANDARD`

Mode	Template
`default`	{{subject}} must be blank
`inverted`	{{subject}} must not be blank

Template placeholders

Placeholder	Description
`subject`	The validated input or the custom validator name (if specified).

Categorization

Miscellaneous

Changelog

Version	Description
3.0.0	Renamed to `Blank` and changed the behavior
1.0.0	Created as `NotBlank`

1.8 KiB Raw Blame History