Как перехватить данные запроса перед сохранением в БД?

Перехват данных запроса перед сохранением в БД в PHP

В современной PHP-разработке перехват данных перед сохранением в базу данных — это критически важная задача, которая решается на нескольких уровнях. Вот основные подходы и техники, которые я применяю в проектах.

Уровни перехвата данных

1. Валидация на уровне контроллера/обработчика

Первый и самый очевидный уровень — это валидация входных данных сразу после получения запроса:

// Пример валидации с использованием Laravel
public function store(Request $request)
{
    $validated = $request->validate([
        'email' => 'required|email|max:255',
        'name' => 'required|string|min:2|max:100',
        'price' => 'required|numeric|min:0'
    ]);
    
    // Далее можно модифицировать данные перед сохранением
    $validated['slug'] = Str::slug($validated['name']);
    $validated['created_by'] = auth()->id();
    
    return Product::create($validated);
}

2. Mutators в моделях Eloquent (Laravel)

В Laravel используются мутаторы для преобразования данных перед записью в БД:

class User extends Model
{
    // Автоматическое хеширование пароля перед сохранением
    public function setPasswordAttribute($value)
    {
        $this->attributes['password'] = bcrypt($value);
    }
    
    // Приведение email к нижнему регистру
    public function setEmailAttribute($value)
    {
        $this->attributes['email'] = strtolower($value);
    }
    
    // Форматирование номера телефона
    public function setPhoneAttribute($value)
    {
        $this->attributes['phone'] = preg_replace('/[^0-9]/', '', $value);
    }
}

3. Событийная модель (Model Events)

Использование событий моделей позволяет централизованно перехватывать данные:

// В boot методе модели
protected static function boot()
{
    parent::boot();
    
    static::saving(function ($model) {
        // Логирование изменений
        $model->updated_at = now();
        
        // Очистка HTML-тегов из полей
        if (isset($model->description)) {
            $model->description = strip_tags($model->description);
        }
        
        // Генерация slug, если нужно
        if (empty($model->slug) && isset($model->title)) {
            $model->slug = Str::slug($model->title);
        }
    });
    
    static::creating(function ($model) {
        $model->created_at = now();
        $model->uuid = Str::uuid(); // Генерация UUID
    });
}

4. Middleware для глобальной обработки

Для перехвата всех входящих запросов можно использовать middleware:

class SanitizeInputMiddleware
{
    public function handle($request, Closure $next)
    {
        // Очистка всех строковых параметров
        $input = $request->all();
        
        array_walk_recursive($input, function (&$value) {
            if (is_string($value)) {
                $value = trim($value);
                $value = htmlspecialchars($value, ENT_QUOTES, 'UTF-8');
            }
        });
        
        $request->merge($input);
        
        return $next($request);
    }
}

Паттерны и лучшие практики

Data Transfer Objects (DTO)

Использование DTO для строгой типизации и валидации:

class CreateProductDTO
{
    public function __construct(
        public readonly string $name,
        public readonly float $price,
        public readonly ?string $description = null
    ) {
        // Валидация в конструкторе
        if ($price < 0) {
            throw new InvalidArgumentException('Price cannot be negative');
        }
    }
    
    public static function fromRequest(Request $request): self
    {
        return new self(
            name: $request->input('name'),
            price: (float) $request->input('price'),
            description: $request->input('description')
        );
    }
    
    public function toArray(): array
    {
        return [
            'name' => $this->name,
            'price' => $this->price,
            'description' => $this->description,
            'slug' => Str::slug($this->name)
        ];
    }
}

Service Layer и Repository Pattern

Вынесение бизнес-логики в сервисный слой:

class ProductService
{
    public function createProduct(array $data): Product
    {
        // Валидация и преобразование данных
        $sanitizedData = $this->sanitizeData($data);
        $enrichedData = $this->enrichData($sanitizedData);
        
        // Дополнительные проверки
        $this->validateBusinessRules($enrichedData);
        
        return Product::create($enrichedData);
    }
    
    private function sanitizeData(array $data): array
    {
        return [
            'name' => trim($data['name']),
            'price' => (float) $data['price'],
            'description' => strip_tags($data['description'] ?? '')
        ];
    }
    
    private function enrichData(array $data): array
    {
        return array_merge($data, [
            'slug' => Str::slug($data['name']),
            'created_by' => auth()->id(),
            'created_at' => now()
        ]);
    }
}

Критические аспекты перехвата данных

• Безопасность: Всегда экранируйте HTML-теги, проверяйте типы данных
• Производительность: Не добавляйте избыточные операции валидации
• Атомарность: Обработка должна быть либо полной, либо откатываться
• Логирование: Фиксируйте изменения для аудита и отладки
• Консистентность: Поддерживайте единый формат данных в БД

Рекомендуемый стек для enterprise-проектов

1. Валидация: Laravel Validator или Symfony Validator Component
2. Санкционирование: Пользовательские middleware + DTO
3. Трансформация: Мутаторы моделей + события
4. Аудит: Логирование изменений через Observer
5. Тестирование: Unit-тесты для всех преобразований

Правильный подход к перехвату данных — это комбинация этих методов, адаптированная под конкретный проект. Важно соблюдать баланс между безопасностью, производительностью и поддерживаемостью кода.