Laravel Scout ve Meilisearch ile Full-Text Arama Nasıl Yapılır?

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

Milyonlarca satırlık ürün veya blog tablosunda SQL LIKE araması yapmak tam tablo taramasına (Full Table Scan) ve sistemin çökmesine neden olur.

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: Composer ile 'composer require laravel/scout meilisearch/meilisearch-php' kurun.
• Adım: Docker ile Meilisearch konteynerini ayağa kaldırın.
• Adım: Aranacak modele 'Laravel\Scout\Searchable' trait'ini ekleyin.

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

use Illuminate\Database\Eloquent\Model;
use Laravel\Scout\Searchable;

class Article extends Model
{
    use Searchable;

    public function toSearchableArray(): array
    {
        return [
            'id' => (int) $this->id,
            'title' => $this->title,
            'content' => strip_tags($this->content),
            'category' => $this->category,
        ];
    }
}

// Controller Kullanımı:
// $results = Article::search('yapay zeka')->paginate(15);

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

Searchable trait'i model kaydedildiğinde Meilisearch indeksini otomatik senkronize eder. search() metodu arama motorundan hızlı sonuç çeker.

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:

• İndeksleme işlemlerini 'SCOUT_QUEUE=true' ile kuyruğa aktarın.
• toSearchableArray içinde yalnızca aranacak metin alanlarını barındırın.
• Yazım hatalarını tolere eden typo tolerance ayarlarını yapılandırın.

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

Büyük tabloları ilk kez indekslerken 'php artisan scout:import' komutunu kuyruksuz çalıştırmak PHP hafıza limitini aşabilir.

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

Scout + Meilisearch, modern e-ticaret sitelerinde arama deneyimini Google hızına ulaştırır.

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.