Laravel Bildirimleri Uygulamada: E-posta, Veritabanı, Kuyruklar ve Temiz Testler

Laravel Bildirimleri Uygulamada: E-posta, Veritabanı, Kuyruklar ve Temiz Testler

Modern web uygulamalarında kullanıcılarla etkileşim kurmak, onların deneyimini zenginleştirmek ve önemli olaylardan haberdar etmek kritik bir öneme sahiptir. Laravel, bu ihtiyacı karşılamak üzere güçlü ve esnek bir bildirim sistemi sunar. Bu makalede, Laravel bildirimlerinin e-posta, veritabanı ve kuyruklar gibi farklı kanallar aracılığıyla nasıl kullanılacağını derinlemesine inceleyecek, ayrıca uygulamalarınızın güvenilirliğini sağlamak için bildirimleri nasıl temiz bir şekilde test edeceğinizi ele alacağız.

Laravel Bildirimlerine Giriş ve Temel Kullanım

Laravel’in bildirim sistemi, uygulamanızdaki çeşitli olaylar hakkında kullanıcılara veya diğer “bildirilebilir” varlıklara bilgi göndermenin basit ve tutarlı bir yolunu sunar. Bir kullanıcı kaydolduğunda, bir sipariş verildiğinde veya bir yorum yapıldığında, bildirimler sayesinde ilgili tarafları kolayca bilgilendirebilirsiniz.

Bildirim Nedir ve Neden Kullanılır?

Bir bildirim, belirli bir olayın gerçekleştiğini duyuran bir mesajdır. Laravel’de bildirimler, genellikle bir olay (event) tetiklendiğinde veya doğrudan bir işlem sonucunda gönderilir. Örneğin, yeni bir kullanıcı kaydolduğunda hoş geldin e-postası göndermek, bir siparişin durumu değiştiğinde müşteriye SMS göndermek veya bir hata oluştuğunda yöneticilere Slack mesajı göndermek gibi senaryolarda bildirimler devreye girer. Bu sistem, farklı iletişim kanallarını tek bir arayüz altında toplayarak geliştirme sürecini basitleştirir ve kod tekrarını azaltır.

Temel Bildirim Sınıfı Oluşturma

Laravel’de bir bildirim sınıfı oluşturmak oldukça basittir. Artisan komutunu kullanarak yeni bir bildirim sınıfı oluşturabilirsiniz:

php artisan make:notification UserRegistered

Bu komut, app/Notifications dizini altında UserRegistered.php adında bir dosya oluşturur. Her bildirim sınıfı, bildirimlerin hangi kanallar aracılığıyla gönderileceğini belirten bir via() metoduna sahiptir. Bu metod, bir dizi kanal adı döndürür:

Bildirim Gönderme Mekanizmaları
Bir bildirimi göndermek için iki temel yöntem bulunur:

Notifiable Trait Kullanarak: Kullanıcı veya diğer modellerinize Illuminate\Notifications\Notifiable trait'ini ekleyerek, doğrudan model üzerinden notify() metodunu çağırabilirsiniz.
use App\Models\User;
use App\Notifications\UserRegistered;

$user = User::find(1);
$user->notify(new UserRegistered());


Notification Facade Kullanarak: Belirli bir bildirimi birden fazla "bildirilebilir" varlığa aynı anda göndermek için Notification facade'ını kullanabilirsiniz.
use Illuminate\Support\Facades\Notification;
use App\Models\User;
use App\Notifications\UserRegistered;

$users = User::all();
Notification::send($users, new UserRegistered());



E-posta Bildirimleri (Mail Notifications)
E-posta, kullanıcılarla iletişim kurmanın en yaygın yollarından biridir ve Laravel'in bildirim sistemi, e-posta göndermeyi son derece kolaylaştırır.
Mail Kanalını Yapılandırma
E-posta bildirimleri gönderebilmek için öncelikle Laravel uygulamanızın e-posta ayarlarını .env dosyasında yapılandırmanız gerekir. SMTP, Mailgun, Postmark, Amazon SES gibi çeşitli sürücüler desteklenir:
MAIL_MAILER=smtp
MAIL_HOST=mailpit
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null
MAIL_FROM_ADDRESS="hello@example.com"
MAIL_FROM_NAME="${APP_NAME}"


MAIL_MAILER genellikle yerel geliştirme için log veya mailpit/mailhog olarak ayarlanır, üretim ortamında ise bir e-posta hizmeti sağlayıcısı kullanılır.
Bildirim İçeriğini Özelleştirme (Markdown/View)
E-posta bildirimlerinin içeriği, bildirim sınıfındaki toMail() metodu içinde tanımlanır. Bu metod, bir MailMessage nesnesi döndürür. Bu nesne, e-postanın konusunu, gövdesini, aksiyon düğmelerini ve diğer öğelerini belirlemenizi sağlar.
use Illuminate\Notifications\Messages\MailMessage;

public function toMail(object $notifiable): MailMessage
{
    $url = url('/account');

    return (new MailMessage)
                ->subject('Hesabınız Oluşturuldu!')
                ->greeting('Merhaba ' . $notifiable->name . '!')
                ->line('Hesabınız başarıyla oluşturuldu. Aşağıdaki butona tıklayarak hesabınıza giriş yapabilirsiniz.')
                ->action('Hesabıma Git', $url)
                ->line('Uygulamamızı kullandığınız için teşekkür ederiz!');
}


Daha karmaşık e-posta tasarımları için Markdown e-posta şablonlarını veya özel Blade view'larını kullanabilirsiniz. Markdown e-postaları, Laravel'in varsayılan e-posta bileşenlerini kullanarak temiz ve duyarlı e-postalar oluşturur. Özel bir Blade view kullanmak için view() metodunu kullanabilirsiniz:
public function toMail(object $notifiable): MailMessage
{
    return (new MailMessage)
                ->subject('Özel Şablonlu E-posta')
                ->view('emails.user-registered', ['user' => $notifiable]);
}


Gelişmiş E-posta Özellikleri
Laravel e-posta bildirimleri, ekler (attachments), özel başlıklar (headers) ve farklı gönderen adresleri gibi gelişmiş özellikler sunar:

Ekler: attach() metodu ile dosya ekleyebilirsiniz.
->attach(public_path('docs/invoice.pdf'), [
    'as' => 'Fatura.pdf',
    'mime' => 'application/pdf',
]);


Özel Başlıklar: withSwiftMessage() metodu ile SwiftMailer (Laravel 9 öncesi) veya Symfony Mailer (Laravel 9 ve sonrası) mesajına doğrudan erişerek özel başlıklar ekleyebilirsiniz.
->withSymfonyMessage(function (Email $message) {
    $message->getHeaders()->addTextHeader('X-Custom-Header', 'Değer');
});



Veritabanı Bildirimleri (Database Notifications)
Veritabanı bildirimleri, uygulamanızın içinde kullanıcı arayüzünde görüntülenecek bildirimleri saklamak için idealdir. Örneğin, bir sosyal medya uygulamasında yeni bir takipçi veya beğeni bildirimi gibi.
Veritabanı Kanalını Kurulumu
Veritabanı bildirimlerini kullanabilmek için öncelikle bildirimleri saklayacak bir tabloya ihtiyacınız vardır. Laravel, bu tabloyu oluşturmak için bir Artisan komutu sağlar:
php artisan notifications:table
php artisan migrate


Bu komutlar, notifications adında bir tablo oluşturur ve bu tablo, bildirimin kimliğini, tipini, bildirimi alan varlığın kimliğini, veri yükünü (payload) ve oluşturulma zamanını saklar.
Bildirimleri Saklama ve Erişim
Veritabanı kanalını kullanmak için bildirim sınıfınızdaki via() metoduna 'database' kanalını eklemeniz ve toDatabase() metodunu uygulamanız gerekir:
use Illuminate\Notifications\Notification;

class NewComment extends Notification
{
    // ...
    public function via(object $notifiable): array
    {
        return ['database'];
    }

    public function toDatabase(object $notifiable): array
    {
        return [
            'comment_id' => $this->comment->id,
            'post_title' => $this->comment->post->title,
            'user_name' => $this->comment->user->name,
        ];
    }
}


toDatabase() metodu, bildirimin veritabanında saklanacak verilerini içeren bir dizi döndürür. Bu veriler, notifications tablosunun data sütununda JSON olarak saklanır. Bildirilebilir varlık (örneğin User modeli), kendisine gönderilen bildirimlere notifications ilişkisi aracılığıyla erişebilir:
$user = User::find(1);

foreach ($user->notifications as $notification) {
    echo $notification->type; // App\Notifications\NewComment
    echo $notification->data['post_title']; // Bildirimin verilerine erişim
}


Okundu/Okunmadı İşaretleme
Veritabanı bildirimlerinin önemli bir özelliği, onların okundu/okunmadı durumlarını yönetebilmektir. Bir bildirim ilk oluşturulduğunda read_at sütunu null olur. Bildirimi okundu olarak işaretlemek için:
$user->unreadNotifications->markAsRead(); // Tüm okunmamış bildirimleri okundu yapar
$notification->markAsRead(); // Belirli bir bildirimi okundu yapar
$notification->markAsUnread(); // Bildirimi tekrar okunmadı yapar


Okunmuş ve okunmamış bildirimlere ayrı ayrı erişmek için readNotifications ve unreadNotifications ilişkilerini kullanabilirsiniz:
$unreadNotifications = $user->unreadNotifications;
$readNotifications = $user->readNotifications;


Kuyruklar ile Bildirimleri Yönetme (Queues for Notifications)
E-posta gönderme veya SMS gibi harici servislerle iletişim kurma gibi işlemler zaman alıcı olabilir ve web isteğinin yanıt süresini uzatabilir. Laravel kuyrukları, bu tür işlemleri arka planda asenkron olarak yürüterek uygulama performansını önemli ölçüde artırır.
Kuyrukların Önemi ve Faydaları
Kuyruklar, uygulamanızın yanıt verme hızını artırmanın yanı sıra, zaman alıcı işlemleri daha güvenilir hale getirir. Bir e-posta servisi geçici olarak kullanılamaz olduğunda, kuyruktaki işler daha sonra tekrar denenebilir. Kuyruk kullanmanın temel faydaları:

Performans: Kullanıcı isteği hemen yanıtlanır, zaman alıcı işlemler arka plana taşınır.
Güvenilirlik: İşlemler başarısız olduğunda otomatik olarak yeniden denenebilir.
Ölçeklenebilirlik: İş yükü arttığında, daha fazla kuyruk işçisi ekleyerek kolayca ölçeklenebilir.

Bildirimleri Kuyruğa Alma
Bir bildirimi kuyruğa almak için bildirim sınıfınızın ShouldQueue arayüzünü uygulaması yeterlidir. Ayrıca, Queueable trait'ini de kullanmanız önerilir:
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Notifications\Notification;

class UserRegistered extends Notification implements ShouldQueue
{
    use Queueable;

    // ...
}


Bu arayüzü uyguladıktan sonra, Laravel bildirimi otomatik olarak yapılandırılmış kuyruk sürücünüz aracılığıyla arka planda gönderecektir. Kuyruk sürücünüzü .env dosyasındaki QUEUE_CONNECTION ayarıyla belirleyebilirsiniz (örneğin, sync, database, redis, sqs).
Kuyruk İşleyicilerini Yapılandırma
Kuyruğa alınmış bildirimlerin işlenebilmesi için bir kuyruk işçisinin (queue worker) çalışıyor olması gerekir. İşçiyi başlatmak için aşağıdaki Artisan komutunu kullanabilirsiniz:
php artisan queue:work


Bu komut, kuyruktaki işleri sürekli olarak dinler ve işler. Üretim ortamında, bu işçinin sürekli çalışır durumda kalmasını sağlamak için Supervisor gibi bir süreç yöneticisi kullanmanız tavsiye edilir.
Temiz ve Etkili Test Stratejileri
Bildirimler, uygulamanızın kritik bir parçası olduğundan, doğru çalıştıklarından emin olmak için kapsamlı bir şekilde test edilmeleri gerekir. Laravel, bildirimleri test etmek için güçlü ve sezgisel araçlar sunar.
Bildirimleri Test Etmenin Önemi
Bildirimlerin test edilmesi, sadece gönderilip gönderilmediğini değil, aynı zamanda doğru içeriğe sahip olup olmadığını ve doğru kanallar aracılığıyla gönderilip gönderilmediğini doğrulamak anlamına gelir. Yanlış veya eksik bildirimler, kullanıcı deneyimini olumsuz etkileyebilir ve hatta iş süreçlerinde aksaklıklara yol açabilir.
Notification Facade Kullanımı
Laravel'in Notification facade'ı, bildirimleri test ederken sahte (fake) hale getirmenizi sağlar. Bu, bildirimlerin gerçekten gönderilmesini engeller ve bunun yerine, gönderilme olaylarını yakalamanıza olanak tanır.
use Illuminate\Support\Facades\Notification;
use App\Models\User;
use App\Notifications\UserRegistered;
use Tests\TestCase;

class UserRegistrationTest extends TestCase
{
    public function test_user_receives_welcome_notification_on_registration(): void
    {
        Notification::fake(); // Bildirimleri sahte hale getir

        $user = User::factory()->create();

        // Belirli bir kullanıcıya belirli bir bildirimin gönderildiğini doğrula
        Notification::assertSentTo(
            $user,
            UserRegistered::class,
            function (UserRegistered $notification, array $channels) use ($user) {
                return $channels === ['mail', 'database'] &&
                       $notification->notifiable->is($user);
            }
        );

        // Hiçbir bildirimin gönderilmediğini doğrula
        Notification::assertNothingSent();

        // Belirli bir bildirimin gönderilmediğini doğrula
        Notification::assertNotSentTo($user, AnotherNotification::class);

        // Belirli bir bildirimin belirli sayıda gönderildiğini doğrula
        Notification::assertSentToTimes($user, UserRegistered::class, 1);
    }
}


Notification::fake() metodunu çağırdıktan sonra, tüm bildirimler sahte hale getirilir ve gerçekte gönderilmez. Daha sonra assertSentTo(), assertNotSentTo(), assertSentToTimes() gibi metodlarla bildirimlerin davranışını doğrulayabilirsiniz. assertSentTo() metodunun üçüncü parametresi, bildirimin içeriğini ve kanallarını daha detaylı kontrol etmenizi sağlayan bir callback fonksiyonudur.
E-posta ve Veritabanı Bildirimlerini Test Etme
Bildirimlerin içeriğini test etmek için assertSentTo() callback'ini kullanabilirsiniz. Örneğin, e-posta bildiriminin konusunu veya veritabanı bildiriminin veri yükünü kontrol edebilirsiniz:
Notification::assertSentTo($user, UserRegistered::class, function ($notification) {
    // E-posta bildirim içeriğini test etme
    $mailData = $notification->toMail($notification->notifiable)->toArray();
    $this->assertStringContainsString('Hesabınız Oluşturuldu!', $mailData['subject']);
    $this->assertStringContainsString('Hesabıma Git', $mailData['actionText']);

    // Veritabanı bildirim içeriğini test etme (eğer toDatabase() metodu varsa)
    // $databaseData = $notification->toDatabase($notification->notifiable);
    // $this->assertEquals('some_value', $databaseData['key']);

    return true;
});


Kuyruğa Alınan Bildirimleri Test Etme
Eğer bildirimleriniz kuyruğa alınıyorsa (ShouldQueue arayüzünü uyguluyorsa), Notification::fake() aynı zamanda kuyruk işlemlerini de sahte hale getirir. Bildirimlerin kuyruğa başarıyla itildiğini doğrulamak için assertPushedOn() metodunu kullanabilirsiniz:
Notification::fake();

$user = User::factory()->create();
$user->notify(new UserRegistered());

Notification::assertPushedOn('default', UserRegistered::class); // Varsayılan kuyruğa itildiğini doğrula
Notification::assertPushedOn('emails', UserRegistered::class); // 'emails' adlı kuyruğa itildiğini doğrula (eğer özelleştirildiyse)


Bu metod, bildirimin belirtilen kuyruğa itilip itilmediğini kontrol eder. Bu sayede, kuyruk mekanizmanızın doğru çalıştığından emin olabilirsiniz.
Gelişmiş Kullanım Senaryoları ve İpuçları
Laravel bildirim sistemi, temel kullanımın ötesinde birçok gelişmiş senaryo için esneklik sunar.
Özel Bildirim Kanalları Oluşturma
Laravel, e-posta, veritabanı, SMS (Nexmo/Twilio) ve Slack gibi popüler kanallar için yerleşik destek sunar. Ancak, uygulamanızın özel bir bildirim kanalına (örneğin, bir anlık bildirim servisi veya özel bir API) ihtiyacı varsa, kendi kanalınızı kolayca oluşturabilirsiniz.
Bir özel kanal, send() metodunu içeren bir sınıf olmalıdır. Bu metod, bildirimi ve bildirilebilir varlığı parametre olarak alır:
toCustomSms($notifiable);

        // SMS gönderme mantığı buraya gelir
        // Örneğin: ThirdPartySmsApi::send($notifiable->phone, $message);
    }
}


Daha sonra bildirim sınıfınızda bu kanalı via() metodunda belirtebilir ve toCustomSms() metodunu uygulayabilirsiniz:
public function via(object $notifiable): array
{
    return ['custom-sms'];
}

public function toCustomSms(object $notifiable): string
{
    return 'Merhaba ' . $notifiable->name . ', bu özel bir SMS bildirimidir.';
}


Son olarak, AppServiceProvider içinde kanalınızı kaydedin:
use App\Channels\CustomSmsChannel;
use Illuminate\Support\Facades\Notification;

public function boot(): void
{
    Notification::extend('custom-sms', function ($app) {
        return new CustomSmsChannel();
    });
}


Bildirimleri Yerelleştirme
Uygulamanız birden fazla dili destekliyorsa, bildirimlerinizi kullanıcının tercih ettiği dilde göndermek önemlidir. Laravel, locale() metodu ile bildirimleri yerelleştirmeyi destekler:
$user->notify((new UserRegistered())->locale($user->locale));


Bu, bildirim gönderilmeden önce uygulamanın dilini geçici olarak $user->locale değerine ayarlar ve bildirim işlendikten sonra orijinal diline geri döner. Bildirim şablonlarınızda veya toMail() gibi metodlarda çeviri anahtarlarını kullanabilirsiniz (örneğin, __('welcome.greeting')).
Çoklu Kanallar ve Koşullu Bildirimler
Bir bildirim, aynı anda birden fazla kanala gönderilebilir. via() metodunda birden fazla kanal adı döndürerek bunu sağlayabilirsiniz:
public function via(object $notifiable): array
{
    return ['mail', 'database', 'slack'];
}


Ayrıca, belirli koşullara bağlı olarak bildirim göndermek isteyebilirsiniz. Örneğin, bir kullanıcı bildirimleri devre dışı bıraktıysa göndermemek gibi. Bildirim sınıfınızda shouldSend() metodunu uygulayarak bu kontrolü yapabilirsiniz:
public function shouldSend(object $notifiable, string $channel): bool
{
    return $notifiable->prefers_notifications;
}


Bu metod false döndürürse, bildirim ilgili kanala gönderilmez.
Sonuç
Laravel'in bildirim sistemi, modern web uygulamalarının vazgeçilmez bir parçası olan kullanıcı iletişimi için güçlü, esnek ve kullanımı kolay bir çözüm sunar. E-posta, veritabanı ve kuyruklar gibi temel kanalları etkin bir şekilde kullanarak uygulamanızın performansını ve kullanıcı deneyimini artırabilirsiniz. Ayrıca, bildirimleri temiz ve kapsamlı bir şekilde test etmek, uygulamanızın güvenilirliğini sağlamanın anahtarıdır. Kendi özel kanallarınızı oluşturarak veya yerelleştirme gibi gelişmiş özelliklerden faydalanarak, Laravel bildirimlerini uygulamanızın benzersiz ihtiyaçlarına göre özelleştirebilirsiniz. Bu sayede, kullanıcılarınızla daha etkili bir şekilde iletişim kurabilir ve uygulamanızın değerini artırabilirsiniz.
SSS (Sık Sorulan Sorular)
1. Laravel bildirimleri ile e-posta gönderemiyorum, ne yapmalıyım?
Öncelikle .env dosyanızdaki e-posta yapılandırma ayarlarınızı (MAIL_MAILER, MAIL_HOST, MAIL_PORT vb.) kontrol edin. Yerel geliştirme ortamında Mailpit veya Mailhog gibi bir SMTP sunucusu kullanıyorsanız, bunların çalıştığından emin olun. Üretimde ise kullandığınız e-posta servis sağlayıcısının kimlik bilgilerini ve ayarlarını doğrulayın. Ayrıca, config/mail.php dosyasındaki ayarların doğru olduğundan emin olun.
2. Bildirimler neden kuyruğa alınmıyor?
Bildirim sınıfınızın Illuminate\Contracts\Queue\ShouldQueue arayüzünü uyguladığından ve Illuminate\Bus\Queueable trait'ini kullandığından emin olun. Ayrıca, .env dosyanızdaki QUEUE_CONNECTION değerinin sync dışında (örneğin database, redis) bir değere ayarlandığından ve bir kuyruk işçisinin (php artisan queue:work) çalıştığından emin olun.
3. Veritabanı bildirimlerindeki verileri nasıl güncelleyebilirim?
Veritabanı bildirimleri data sütununda JSON olarak saklandığından, doğrudan güncellenemezler. Genellikle, bir bildirimin verisi değiştiğinde yeni bir bildirim gönderilir ve eski bildirim ya silinir ya da okunmuş olarak işaretlenir. Eğer sadece okundu/okunmadı durumu değişecekse, markAsRead() veya markAsUnread() metodlarını kullanabilirsiniz.
4. Bir bildirimin hangi kanallara gönderileceğini dinamik olarak nasıl belirleyebilirim?
Bildirim sınıfınızdaki via() metoduna bir koşul ekleyerek bunu yapabilirsiniz. Örneğin, kullanıcının tercihlerine göre farklı kanallar döndürebilirsiniz:
public function via(object $notifiable): array
{
    $channels = ['database'];

    if ($notifiable->prefers_email) {
        $channels[] = 'mail';
    }

    return $channels;
}


5. Bildirim testlerinde gerçek e-postaların gönderilmesini nasıl engellerim?
Testlerinizin başında Notification::fake(); metodunu çağırarak tüm bildirimleri sahte hale getirebilirsiniz. Bu, bildirimlerin gerçekten gönderilmesini engeller ve bunun yerine, gönderilme olaylarını yakalamanıza olanak tanır. Böylece testleriniz daha hızlı ve izole bir şekilde çalışır.