Büyük bir Laravel uygulaması için bir hizmeti/mimariyı nasıl yapılandırırsınız?

Question

Accepted Answer

Bir Laravel uygulaması büyüdükçe, varsayılan "şişman controller / şişman model" yaklaşımı bakımını zorlaştırır. Daha büyük uygulamalar, işletme mantığını organize, test edilebilir ve bakımı yapılabilir tutmak için **ek mimari katmanlardan** — hizmet sınıfları, aksiyon sınıfları, depolar, form istekleri ve açık alan organizasyonu — yararlanır.

## Problem: mantık yanlış yerlerde kalıyor

```text
Small apps: logic in controllers and models is fine.
Large apps: controllers get bloated, models become "god objects", logic is duplicated
→ hard to test, maintain, and reason about. Extract logic into dedicated layers.
```

## Hizmet sınıfları — işletme mantığını kapsülle

```php
<?php
// move complex business logic out of controllers into a service
class OrderService {
    public function __construct(
        private PaymentGateway $payments,
        private InventoryService $inventory,
    ) {}

public function placeOrder(User $user, array $items): Order {
        // orchestrate the business process — reusable, testable, focused
        DB::transaction(function () use ($user, $items) { /* ... */ });
    }
}

// the controller stays THIN — just delegates
public function store(StoreOrderRequest $request, OrderService $orders) {
    return $orders->placeOrder($request->user(), $request->validated());
}
```

**Hizmet sınıfları** işletme mantığını barındırır, controllerları ince tutarak (sadece HTTP işleme) ve modelleri veriye odaklanmaya zorlar — ve mantığı yeniden kullanılabilir ve bağımsız olarak test edilebilir yapar.

## Büyük uygulamalar için diğer yararlı desenler

```text
✓ Action classes — a single class per use-case (e.g. CreateUserAction) — very focused
✓ Form Requests — extract validation + authorization out of controllers
✓ API Resources — control response shape, separate from models
✓ Repository pattern — abstract data access behind interfaces (when you need it;
  often Eloquent suffices, so don't add it reflexively)
✓ Events/listeners — decouple side effects from core logic
✓ Domain-oriented organization — group code by feature/domain, not just by type
  (e.g. a modules/ structure) as the app grows
✓ Dependency injection + interfaces — for loose coupling and testability
```

## Yol gösterici ilkeler

```text
✓ Thin controllers (HTTP only) → services/actions (business logic) → models (data)
✓ Single Responsibility — each class does one thing
✓ Depend on abstractions (interfaces) for testability and flexibility
✗ Don't over-engineer — add layers when complexity justifies them, not prematurely
```

## Neden önemli

Büyük bir Laravel uygulamasının nasıl yapılandırılacağını anlamak, üst düzey bilgi olması açısından önemlidir, çünkü küçük uygulamalar için işe yarayan kurallar (mantık controllerler ve modellerde) ölçekte çöker — şişman controllerlara, "tanrı" modellerine, yinelenen mantığa ve test etmesi ve bakımı zor olan koda yol açar.

Ek mimari katmanları — özellikle **hizmet sınıflarını** (işletme mantığını kapsülleyerek controllerları ince ve modelleri odaklanmış tutmak, aynı zamanda mantığı yeniden kullanılabilir ve test edilebilir yapmak), artı aksiyon sınıflarını, Form İsteklerini (doğrulama/yetkilendirmeyi çıkarmak), API Kaynaklarını (çıktıyı kontrol etmek), depo desenini (gerektiğinde veri erişimini soyutlamak), olayları (yan etkileri ayırmak) ve **alan yönelimli organizasyonu** (uygulama büyüdükçe özelliğe göre gruplandırma) bilmek — bakımı yapılabilir, ölçeklenebilir uygulamalar oluşturmanıza olanak sağlayan şeydir.

Kılavuz ilkeler önemlidir: **ince controllerler → hizmetler → modeller** katmanlaması, tek sorumluluk ve test edilebilirlik ve gevşek bağlantı için soyutlamalara (arayüzlere) bağımlılık.

Eşit derecede önemli olan, **aşırı mühendislik yapmamak için yargıdır** — karmaşıklık onları gerçekten haklı gösterdiğinde katmanlar eklemek yerine zamanından önce (Laravel'in varsayılanları daha basit uygulamalar için iyidir ve otomatik olarak depolar/soyutlamalar eklemek gereksiz karmaşıklık ekler).

Bu mimari desenleri ve onları uygulama için ilkeleri (ve tutumu) anlamak, büyüyebilecek, uzun ömürlü Laravel uygulamaları oluşturmak için değerlidir — geliştiricileri ölçeklenebilir uygulamaları mimarya edebilen ve büyüyen uygulamaları karmaşık, bakımı zor koda çöktüren olanlarından ayırt eder.

Bu mimari yargı, kıdemli Laravel geliştirmesinin ve ciddiye alınan, büyüyen uygulamalar için sık ilgili bir kaygının bir işareti olur.