ave-cms/help/en/helpers/Valid.md

Valid - validation

App\Helpers\Valid - value validation. Two modes:

1. Batch checking an array according to the rules → array of errors.
2. Single static checks → bool.

use App\Helpers\Valid;

---

Mode 1: batch checking

Valid::check(array $data, array $rules, array $labels = []): array

Returns ['field' => 'error message']; empty array = everything is valid. The first triggered error is taken for the field.

Rules format: string through | (or an array of rules). Parameters - via :, several parameters - via ,. Empty value if there is no required skips the rest of the field rules.

$errors = Valid::check($_POST, [
    'email' => 'required|email',
    'name'  => 'required|maxLength:255',
    'age'   => 'required|int|min:1|max:120',
    'slug'  => 'slug',
    'when'  => 'date:Y-m-d',
], [
    'email' => 'E-mail',        // подписи полей для сообщений
    'name'  => 'Имя',
]);

if ($errors) {
    // например, отдать в форму / вернуть 422
    return $this->error('Проверьте поля', $errors);
}

Available rule names: required, email, url, ip, numeric, int/integer, float, alpha, alphaNum, slug, phone, date:FORMAT, min:N, max:N, minLength:N, maxLength:N, length:N, regex:PATTERN, inArray:a,b,c.

Your error texts:

Valid::setMessages([
    'required'  => ':label обязательно для заполнения',
    'maxLength' => ':label — не длиннее :param символов',
]);

⚠️ Nuance: the rule int/integer in check() only checks “this is an integer” and ignores the range (int:1,120 will not work as boundaries). For range add separate min: / max:. The range for int() only works when direct static call (see below).

---

Mode 2: single checks (bool)

Method	Checks
required($v)	Not empty.
email($v) / url($v) / ip($v) / ipv4($v) / ipv6($v)	Formats.
numeric($v)	Number (including a string).
int($v, $min = null, $max = null)	Integer with range.
float($v)	Fractional.
alpha($v) / alphaNum($v)	Only letters/letters+numbers.
slug($v)	Correct CNC slug.
minLength/maxLength/length($v, $n)	Line length.
regex($v, $pattern)	On a regular basis.
inArray($v, array $allowed)	From the white list.
phone($v)	Telephone.
date($v, $format = 'Y-m-d')	Date by format.
min($v, $min) / max($v, $max)	Numerical boundaries.

if (!Valid::email($email))          { $err['email'] = 'Неверный e-mail'; }
if (!Valid::int($age, 1, 120))      { $err['age']   = 'Возраст 1–120'; }   // диапазон работает
if (!Valid::inArray($sort, ['asc', 'desc'])) { $sort = 'asc'; }             // нормализация

---

Recipes

Form validation in controller with response 422:

$errors = Valid::check($_POST, [
    'title'     => 'required|maxLength:255',
    'rubric_id' => 'required|int',
]);
if ($errors) { return $this->error('Проверьте поля', $errors); }

Quick check of one value before use:

$email = Valid::email($raw) ? $raw : '';