Form Request sınıfları nedir?

Question

Accepted Answer

**Form Request** sınıfları, belirli bir istek için **doğrulama (ve yetkilendirme) mantığını kapsülleyen** özel istek sınıflarıdır. Doğrulama kurallarını denetleyicilerden çıkarıp adanmış, yeniden kullanılabilir sınıflara taşırlar — denetleyicileri ince tutarak ve doğrulamayı organize ederler.

## Form Request oluşturma ve kullanma

```php
<?php
// php artisan make:request StoreUserRequest
class StoreUserRequest extends FormRequest {
    public function authorize(): bool {
        return $this->user()->can('create', User::class);   // AUTHORIZATION check
    }

public function rules(): array {
        return [                                              // VALIDATION rules
            'name' => 'required|string|max:100',
            'email' => 'required|email|unique:users',
            'password' => 'required|min:8|confirmed',
        ];
    }

public function messages(): array {
        return ['email.unique' => 'That email is already taken.'];   // custom messages
    }
}
```

```php
// type-hint the Form Request in the controller — validation runs AUTOMATICALLY
public function store(StoreUserRequest $request) {
    // if we reach here, validation AND authorization already PASSED
    User::create($request->validated());   // get the validated data
}
```

Bir denetleyici yöntemine Form Request yazarken, Laravel **yöntem çalıştırılmadan önce otomatik olarak yetkilendirme ve doğrulamayı çalıştırır** — ikisinden biri başarısız olursa, istek reddedilir (yetkilendirme için 403, doğrulama için 422/yönlendirme) ve yönteminiz hiç çalışmaz. Böylece yöntemin içinde, verilerin geçerli olduğunu ve işlemin yetkili olduğunu bilirsiniz.

## Faydaları

```text
✓ Thin controllers — validation/authorization logic lives in the Form Request, not the controller
✓ Reusable — use the same request class across multiple endpoints
✓ Organized — rules, messages, and authorization for a request are in one place
✓ Combines validation AND authorization — both checked automatically before the controller
✓ Access prepared/validated data cleanly via $request->validated()
```

## Neden önemli

Form Request sınıfları, doğrulama ve yetkilendirmeyi temiz bir şekilde organize etmek için önemli bir Laravel en iyi uygulamasıdır — trivial olmayan herhangi bir doğrulama için önerilen yaklaşımdırlar, bu nedenle onları anlamak, bakımı kolay Laravel uygulamaları yazmak için değerlidir.

Bunların temel faydası **denetleyicileri ince tutmaktır**: doğrulama kurallarını ve yetkilendirme mantığını adanmış bir sınıfa taşıyarak (Laravel denetleyici yönteminden önce otomatik olarak çalıştırır), denetleyici temel mantığına odaklanır ve veriler zaten doğrulandığı ve işlem yetkilendirildiği için çalıştığında güvenceye sahip olur.

Bu ayrım kodu daha **organize** hale getirir (tüm kurallar, özel mesajlar ve bir istek için yetkilendirme uyumlu bir yerde), **yeniden kullanılabilir** (aynı Form Request birden çok uç nokta arasında kullanılabilir) ve temiz hale getirir.

Bir sınıfta **doğrulama ve yetkilendirmenin** otomatik kombinasyonu — ikisi de denetleyici çalışmadan önce kontrol edilir, geçersiz veya yetkisiz istekleri otomatik olarak reddeder — zarif ve demirbaş kodu azaltır.

Form Request'leri anlamak, bunların otomatik olarak nasıl çalıştığını ve doğrulama/yetkilendirmeyi denetleyicilerden çıkarmanın faydalarını anlamak, olgun Laravel uygulamasını yansıtır ve iyi yapılandırılmış uygulamalar oluşturmak için önemlidir, çünkü doğrulama ve yetkilendirme her yerde karşılaşılan meselelerdir ve Form Request'ler — profesyonel, bakımı kolay Laravel kodunun ayırıcı özelliği — bunları trivial olmayan durumlar için ele almak için Laravel'in temiz, diyomatik yoludur.