Laravel'de controller nedir?

Question

Accepted Answer

**Controller**lar ilgili istek işleme mantığını sınıflar halinde gruplayır. Tüm mantığı route kapatmaları içine koymak yerine, controller'lar bir uygulamanın eylemlerini (örn. kullanıcıyla ilgili tüm işlemler) metotlar halinde düzenler — route'ları temiz ve kodu organize tutar.

## Temel bir controller

```php
<?php
class UserController extends Controller {
    public function index() {
        return User::all();              // list users
    }
    public function show(User $user) {   // route model binding — auto-fetch by id
        return $user;
    }
    public function store(Request $request) {
        $validated = $request->validate(['name' => 'required', 'email' => 'required|email']);
        return User::create($validated);  // create
    }
}
```

Artisan ile oluşturun: `php artisan make:controller UserController`. Her metot bir eylemi işler ve route'lar onlara işaret eder.

## Kaynak controller'ları (RESTful CRUD)

```php
// generate a controller with all 7 RESTful methods stubbed
// php artisan make:controller PostController --resource

Route::resource('posts', PostController::class);   // maps routes to the methods:
// index() create() store() show() edit() update() destroy()
```

Bir **kaynak controller'ı** standart CRUD metotlarına sahiptir ve `Route::resource` ile eşleştirilir — tipik CRUD kaynakları için minimal boilerplate sağlayan geleneksel RESTful yönlendirme.

## Controller'larda bağımlılık enjeksiyonu

```php
class OrderController extends Controller {
    // type-hinted dependencies are AUTO-INJECTED by Laravel's service container
    public function __construct(private OrderService $orders) {}

public function store(Request $request, Mailer $mailer) {   // method injection too
        // $request and $mailer are resolved & injected automatically
    }
}
```

Laravel'in servis konteyneri **otomatik olarak** constructor'lar ve metotlara yazım ipucu verilmiş bağımlılıkları enjekte eder (`Request` dahil) — temiz, test edilebilir kod.

## Controller'ları ince tutun

```text
✓ Controllers should handle HTTP concerns (validate input, call services, return responses)
✗ Business logic belongs in SERVICES/models, not bloated controllers ("thin controllers")
```

## Neden önemli

Controller'lar Laravel'in temel yapı taşıdır — istek işleme mantığını uyumlu sınıflar halinde düzenlerler, bu da önemsiz route'ların ötesindeki herhangi bir uygulama için gereklidir.

Controller'ların nasıl oluşturulacağını, route'ların metotlarına nasıl eşlendirileceğini ve özellikle minimal boilerplate ile geleneksel RESTful CRUD sağlayan `Route::resource` ile **kaynak controller'larının** nasıl kullanılacağını anlamak, Laravel uygulamaları oluştururken günlük bilgidir.

Temel bir Laravel özelliği, servis konteyneri aracılığıyla controller'lara **otomatik bağımlılık enjeksiyonu**dur — yazım ipucu verilmiş bağımlılıklar (servisler, istek, mailer'lar) otomatik olarak çözümlenir ve enjekte edilir, temiz, test edilebilir, gevşek bağlı kodu etkinleştirir.

Eşit derecede önemli olan, controller'ları **ince** tutmanın en iyi uygulamasıdır — yalnızca HTTP endişelerini (doğrulama, servisleri çağırma, yanıt döndürme) işlemek ve iş mantığını servislere/modellere devretmek, kodu bakımı yapılabilir ve test edilebilir tutar.

Controller'lar, yönlendirme ve modeller ile birlikte Laravel'in istek işlemenin omurgasını oluşturur ve onları iyi organize edilmiş, profesyonel Laravel uygulamaları oluşturmak için temel kılar.