Laravel Model Observer ile Veri Değişiklikleri ve Loglama Nasıl Yapılır?

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

Bir sipariş silindiğinde veya kullanıcı güncellendiğinde log tutma kodlarını controller'ların içine saçmak kod karmaşası yaratır.

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:observer OrderObserver --model=Order' komutunu çalıştırın.
• Adım: Observer'ı AppServiceProvider veya Order modelinde register edin.

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\Observers;

use App\Models\Order;
use Illuminate\Support\Facades\Log;

class OrderObserver
{
    public function created(Order $order): void
    {
        Log::info("Yeni sipariş oluşturuldu: #{$order->id}, Tutar: {$order->total_amount}");
    }

    public function updated(Order $order): void
    {
        if ($order->isDirty('status')) {
            Log::warning("Sipariş #{$order->id} durumu '{$order->getOriginal('status')}' -> '{$order->status}' olarak değişti.");
        }
    }

    public function deleted(Order $order): void
    {
        Log::critical("Sipariş #{$order->id} silindi! İşlemi yapan: " . auth()->id());
    }
}

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

isDirty() metodu sadece hangi alanın değiştiğini tespit ederken, getOriginal() eski değeri verir. Böylece detaylı değişiklik logu tutulur.

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:

• Ağır işlemleri (e-posta gönderimi gibi) Observer içinde doğrudan çalıştırmak yerine kuyruğa aktarın.
• Toplu güncellemelerde (update query) Observer'ın tetiklenmeyeceğini unutmayın.
• Veritabanı ilişkili modellerde cascade silmeler için deleting hook'unu değerlendirin.

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

Observer içinde aynı modeli tekrar 'save()' çağırarak sonsuz döngüye sokmak yaygın bir hatadır.

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

Observer mimarisi, kurumsal ERP projelerinde yasal uyumluluk ve denetim loglaması için vazgeçilmezdir.

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.