Laravel Geliştirme Desenleri

Ölçeklenebilir, bakım yapılabilir uygulamalar için üretim seviyesi Laravel mimari desenleri.

Ne Zaman Kullanılır

• Laravel web uygulamaları veya API'ler oluşturma
• Controller'lar, servisler ve domain mantığını yapılandırma
• Eloquent model'ler ve ilişkiler ile çalışma
• Resource'lar ve sayfalama ile API tasarlama
• Kuyruklar, event'ler, caching ve arka plan işleri ekleme

Nasıl Çalışır

• Uygulamayı net sınırlar etrafında yapılandırın (controller'lar -> servisler/action'lar -> model'ler).
• Routing'i öngörülebilir tutmak için açık binding'ler ve scoped binding'ler kullanın; erişim kontrolü için yetkilendirmeyi yine de uygulayın.
• Domain mantığını tutarlı tutmak için typed model'leri, cast'leri ve scope'ları tercih edin.
• IO-ağır işleri kuyruklarda tutun ve pahalı okumaları önbelleğe alın.
• Config'i config/* içinde merkezileştirin ve ortamları açık tutun.

Örnekler

Proje Yapısı

Net katman sınırları (HTTP, servisler/action'lar, model'ler) ile geleneksel bir Laravel düzeni kullanın.

Önerilen Düzen

app/
├── Actions/            # Tek amaçlı kullanım durumları
├── Console/
├── Events/
├── Exceptions/
├── Http/
│   ├── Controllers/
│   ├── Middleware/
│   ├── Requests/       # Form request validation
│   └── Resources/      # API resources
├── Jobs/
├── Models/
├── Policies/
├── Providers/
├── Services/           # Domain servislerini koordine etme
└── Support/
config/
database/
├── factories/
├── migrations/
└── seeders/
resources/
├── views/
└── lang/
routes/
├── api.php
├── web.php
└── console.php

Controllers -> Services -> Actions

Controller'ları ince tutun. Orkestrasyon'u servislere ve tek amaçlı mantığı action'lara koyun.

final class CreateOrderAction
{
    public function __construct(private OrderRepository $orders) {}

    public function handle(CreateOrderData $data): Order
    {
        return $this->orders->create($data);
    }
}

final class OrdersController extends Controller
{
    public function __construct(private CreateOrderAction $createOrder) {}

    public function store(StoreOrderRequest $request): JsonResponse
    {
        $order = $this->createOrder->handle($request->toDto());

        return response()->json([
            'success' => true,
            'data' => OrderResource::make($order),
            'error' => null,
            'meta' => null,
        ], 201);
    }
}

Routing ve Controllers

Netlik için route-model binding ve resource controller'ları tercih edin.

use Illuminate\Support\Facades\Route;

Route::middleware('auth:sanctum')->group(function () {
    Route::apiResource('projects', ProjectController::class);
});

Route Model Binding (Scoped)

Çapraz kiracı erişimini önlemek için scoped binding'leri kullanın.

Route::scopeBindings()->group(function () {
    Route::get('/accounts/{account}/projects/{project}', [ProjectController::class, 'show']);
});

İç İçe Route'lar ve Binding İsimleri

• Çift iç içe geçmeyi önlemek için prefix'leri ve path'leri tutarlı tutun (örn. conversation vs conversations).
• Bound model'e uyan tek bir parametre ismi kullanın (örn. Conversation için {conversation}).
• İç içe geçirirken üst-alt ilişkilerini zorlamak için scoped binding'leri tercih edin.

use App\Http\Controllers\Api\ConversationController;
use App\Http\Controllers\Api\MessageController;
use Illuminate\Support\Facades\Route;

Route::middleware('auth:sanctum')->prefix('conversations')->group(function () {
    Route::post('/', [ConversationController::class, 'store'])->name('conversations.store');

    Route::scopeBindings()->group(function () {
        Route::get('/{conversation}', [ConversationController::class, 'show'])
            ->name('conversations.show');

        Route::post('/{conversation}/messages', [MessageController::class, 'store'])
            ->name('conversation-messages.store');

…