Валидация данных
Назначение и когда использовать
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 — длину; неизвестное правило игнорируется, поэтому опечатки проверяйте тестом.