Laravel 11 Form Request ile Temiz ve Güvenli Validasyon Nasıl Yapılır?

1. Giriş ve Karşılaşılan Temel Zorluklar

Controller içine yazılan onlarca satırlık validate kuralları kod tekrarına, spagetti koda ve yetersiz güvenlik denetimlerine yol açar.

Modern kurumsal yazılım mimarisinde bu adımı doğru tasarlamak; hem uygulamanın bakım maliyetini (maintainability) düşürür hem de gelecekteki ölçekleme (scaling) süreçlerinde refactor ihtiyacını en aza indirir. Bu rehberde, sektörde kabul görmüş standartlar ışığında adım adım uygulamayı ele alıyoruz.

2. Ortam Hazırlığı ve Gerekli Bağımlılıklar

Geliştirmeye başlamadan önce sistem ortamınızın ve ilgili paketlerin hazır olduğundan emin olmalısınız. Terminalinizde aşağıdaki komutları çalıştırarak ilgili yapılandırmayı tamamlayın:

• Adım: Terminalde 'php artisan make:request StoreProductRequest' komutunu çalıştırın.
• Adım: App\Http\Requests klasörü altındaki dosyayı açın.

3. Uygulama Mimarisi ve Kod Örneği

Aşağıdaki kod bloğunda, temiz kod (Clean Code) prensiplerine ve SOLID standartlarına uygun olarak tasarlanmış örnek implementasyonu inceleyebilirsiniz:

<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Validation\Rule;

class StoreProductRequest extends FormRequest
{
    public function authorize(): bool
    {
        // Yalnızca ürün ekleme yetkisi olan yöneticiler
        return $this->user()?->can('create-products') ?? false;
    }

    public function rules(): array
    {
        return [
            'name' => ['required', 'string', 'max:255'],
            'sku' => ['required', 'string', 'uppercase', Rule::unique('products', 'sku')],
            'price' => ['required', 'numeric', 'min:0'],
            'category_id' => ['required', 'exists:categories,id'],
            'image' => ['nullable', 'image', 'max:2048', 'mimes:jpg,webp,png'],
        ];
    }
}

4. Kod Analizi ve Çalışma Mantığı

authorize() metodu HTTP isteği controller'a düşmeden önce yetkiyi kontrol eder. rules() metodu ise hatalı girdilerde otomatik 422 JSON yanıtı üretir.

Yukarıdaki implementasyonda dikkat edilmesi gereken en kritik husus, işlemlerin bağımsız (decoupled) ve test edilebilir şekilde katmanlara ayrılmış olmasıdır. Bu yaklaşım, birim testlerin (Unit Tests) ve entegrasyon testlerinin hızlıca yazılabilmesine olanak tanır.

5. Performans ve Güvenlik İpuçları

Canlı üretim (production) ortamında sistemin kararlı çalışması için aşağıdaki pratikleri mutlaka dikkate almalısınız:

• Özel hata mesajları için messages() metodunu override edin.
• Dönüştürme işlemleri için prepareForValidation metodunu kullanın.
• Karmaşık iş kurallarında Custom Rule sınıflarından faydalanın.

6. En Sık Yapılan Hatalar ve Hata Ayıklama (Troubleshooting)

authorize() metodunu true yapmayı unutup 403 Forbidden hatasıyla karşılaşmak en yaygın dikkatsizliktir.

Eğer beklenmedik bir hata ile karşılaşırsanız; öncelikle log dosyalarını incelemeli, ortam değişkenlerinin (.env) doğru tanımlandığını doğrulamalı ve önbellek (cache) mekanizmalarını temizleyerek sistemi yeniden başlatmalısınız.

7. Sonuç ve Mimari Değerlendirme

Form Request katmanı, Single Responsibility (SRP) prensibinin Laravel'deki kusursuz bir uygulamasıdır.

Cengiz Bozdemir olarak 18 yılı aşkın kurumsal yazılım mimarlığı deneyimimle tavsiyem; sistem tasarımında her zaman sürdürülebilirlik, güvenlik ve yüksek eşzamanlılık (high concurrency) hedeflerini ön planda tutmanızdır. Kurumsal projelerinizde özel mimari danışmanlık veya uçtan uca yazılım geliştirme desteği için bizimle iletişime geçebilirsiniz.