Какие инструменты используются для валидации запросов в Laravel?

Инструменты валидации запросов в Laravel

Laravel предоставляет мощный и гибкий набор инструментов для валидации входящих запросов, который является одной из сильнейших сторон фреймворка. Вот основные инструменты, которые я использую в профессиональной разработке.

1. Встроенный валидатор Laravel

Базовый и наиболее часто используемый инструмент - это встроенная система валидации через фасад Validator или метод validate() контроллера.

// В контроллере
public function store(Request $request)
{
    $validated = $request->validate([
        'email' => 'required|email|unique:users,email',
        'password' => 'required|min:8|confirmed',
        'age' => 'required|integer|min:18',
        'terms' => 'accepted'
    ]);
    
    // Данные уже валидированы
    User::create($validated);
}

2. Form Request Validation

Для сложной валидации я использую Form Request - специальные классы, которые инкапсулируют логику валидации.

// Создаем Form Request
php artisan make:request StoreUserRequest

// В классе StoreUserRequest
public function rules()
{
    return [
        'email' => ['required', 'email', 'unique:users'],
        'password' => ['required', 'min:8', 'confirmed'],
        'profile_photo' => ['image', 'max:2048']
    ];
}

public function messages()
{
    return [
        'password.required' => 'Пароль обязателен для заполнения',
        'email.unique' => 'Этот email уже используется'
    ];
}

3. Кастомные правила валидации

Когда стандартных правил недостаточно, я создаю кастомные правила:

// Создание кастомного правила
php artisan make:rule StrongPassword

// Реализация правила
class StrongPassword implements Rule
{
    public function passes($attribute, $value)
    {
        return preg_match('/^(?=.*[a-z])(?=.*[A-Z])(?=.*\d).+$/', $value);
    }
    
    public function message()
    {
        return 'Пароль должен содержать буквы в верхнем и нижнем регистре и цифры';
    }
}

4. Валидация для API-ресурсов

Для API часто используются дополнительные инструменты:

• JSON-валидация через $request->validate()
• Conditional Validation - условные правила
• Array Validation - валидация массивов и вложенных данных

$request->validate([
    'products' => 'required|array',
    'products.*.id' => 'required|exists:products,id',
    'products.*.quantity' => 'required|integer|min:1',
    'discount_code' => 'nullable|string|min:3'
]);

5. Пакеты для расширенной валидации

В сложных проектах я использую дополнительные пакеты:

• Laravel Jetstream или Sanctum - для аутентификации и связанной валидации
• laravel-json-api - для валидации по спецификации JSON:API
• spatie/laravel-query-builder - для валидации параметров запроса

6. Валидация на стороне клиента и сервера

Важный аспект - комбинирование валидации:

1. Первичная валидация на клиенте (JavaScript) для UX
2. Основная валидация на сервере для безопасности
3. Бизнес-валидация в сервисных слоях

7. Практики и best practices

Из моего опыта, ключевые практики включают:

• Ранняя валидация - валидируйте данные как можно раньше в pipeline запроса
• Реюзабельность - используйте Form Request для повторного использования правил
• Ясные сообщения об ошибках - кастомизируйте сообщения для пользователей
• Локализация - поддерживайте мультиязычные сообщения об ошибках
• Тестирование - пишите тесты для правил валидации

// Тестирование валидации
public function test_store_user_validation()
{
    $response = $this->post('/users', [
        'email' => 'invalid-email',
        'password' => '123'
    ]);
    
    $response->assertSessionHasErrors(['email', 'password']);
}

8. Валидация сложных структур

Для сложных данных я использую:

• Nested array validation с синтаксисом array_field.*.nested_field
• Conditional rules с required_if, required_unless
• Database validation rules как exists, unique с дополнительными условиями

$rules = [
    'invoice.items.*.product_id' => 'required|exists:products,id',
    'invoice.items.*.quantity' => 'required|integer|min:1',
    'invoice.discount' => 'required_if:invoice.has_discount,true|numeric'
];

Заключение

Инструменты валидации в Laravel образуют целостную экосистему, которая покрывает 95% потребностей веб-приложений. Ключ к эффективной валидации - правильный выбор инструмента под задачу: простые случаи решаются встроенными методами, сложная бизнес-логика требует Form Request, а специфичные проверки реализуются через кастомные правила. Важно помнить, что валидация - это не только проверка синтаксиса данных, но и важный слой безопасности приложения, который должен быть тщательно протестирован и документирован.