⚡ Esora Документация

Валидация данных

Назначение и когда использовать

Validator проверяет parsed body/query до бизнес-логики. Используйте напрямую в коротком handler или FormRequest для повторного authorization + rules lifecycle.

Пошагово

use Esora\Http\ResponseFactory;
use Esora\Validation\Validator;

$validator = new Validator($request->getParsedBody() ?: [], [
    'name' => 'required|string|min:2|max:80',
    'email' => 'required|email',
    'age' => 'numeric',
    'status' => 'in:draft,published',
]);
if ($validator->fails()) {
    return ResponseFactory::json(['errors' => $validator->errors()], 422);
}
$data = $validator->validated();

Конструктор принимает array $data и array $rules, сразу валидирует. Реальные методы: passes(): bool, fails(): bool, errors(): array, validated(): array. Поддерживаются required, email, numeric, string, min:n, max:n, in:a,b; правила можно задавать строкой через | или списком.

Для класса запроса:

final class StorePostRequest extends FormRequest
{
    public function authorize(): bool { return true; }
    public function rules(): array { return ['title' => 'required|string|min:3']; }
}

FormRequest принимает ServerRequestInterface, all() объединяет query/body (JSON body тоже), input() читает значение, validated() возвращает только разрешённые поля. Ошибка — ValidationException; unauthorized — RuntimeException 403.

Lifecycle и troubleshooting

Input → constructor validation → passes/fails → 422 или allowlist validated. Не вызывайте validated() при ошибках. min/max для numeric сравнивают число, для string — длину; неизвестное правило игнорируется, поэтому опечатки проверяйте тестом.