respect-validation/docs/rules/Digit.md
Henrique Moody 951c16e8e6
Refactor the NotEmoji 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 `NotEmoji` and rename it to `Emoji`. It
will no longer check if the string contains emojis, but rather if the
string is an emoji or not. I’m also adding support to more emojis, since
the rule was a bit outdated.

This change will make the validator more strict, but will make it useful
in other scenarios. However, later on, I would like to create a rule
called `has` which, could use a validator like `Emoji` to check if the
input _has_ emojis.

Assisted-by: Cursor (claude-4.5-opus-high)
2025-12-29 11:16:25 +01:00

2 KiB

Digit

  • Digit()
  • Digit(string ...$additionalChars)

Validates whether the input contains only digits.

v::digit()->isValid('020 612 1851'); // false
v::digit(' ')->isValid('020 612 1851'); // true
v::digit()->isValid('172.655.537-21'); // false
v::digit('.', '-')->isValid('172.655.537-21'); // true

Templates

Digit::TEMPLATE_STANDARD

Mode Template
default {{subject}} must contain only digits (0-9)
inverted {{subject}} must not contain digits (0-9)

Digit::TEMPLATE_EXTRA

Mode Template
default {{subject}} must contain only digits (0-9) and {{additionalChars}}
inverted {{subject}} must not contain digits (0-9) and {{additionalChars}}

Template placeholders

Placeholder Description
additionalChars Additional characters that are considered valid.
subject The validated input or the custom validator name (if specified).

Categorization

  • Numbers
  • Strings

Changelog

Version Description
2.0.0 Removed support to whitespaces by default
0.5.0 Renamed from Digits to Digit
0.3.9 Created as Digits

See also: