ServBay’de Meilisearch Arama Motorunu Kurma ve Kullanma

Meilisearch, güçlü, son derece hızlı ve kullanımı kolay bir açık kaynak arama motorudur; özellikle “yazdıkça arama” hissiyatı için tasarlanmıştır. Basit RESTful API’leriyle zengin fonksiyonlar sunar. ServBay sayesinde, macOS yerel ortamınızda tam donanımlı bir Meilisearch örneğini kurmak hiç olmadığı kadar kolaydır.

Genel Bakış

ServBay, Meilisearch’i grafiksel arayüzüne entegre ederek, geliştiricilerin tek tıkla kurulum ve kolay yapılandırma yapmasını sağlar; karmaşık komut satırları veya bağımlılıklarla uğraşmanıza gerek kalmaz. Ayrıca, ServBay Meilisearch için otomatik olarak yerleşik bir web paneli yapılandırır; bu panele https://meilisearch.servbay.host/ adresinden kolayca erişebilir, indekslerinizi yönetebilir, arama testleri yapabilir ve servisin durumunu görüntüleyebilirsiniz.

Ön Koşullar

• macOS sisteminizde ServBay başarılı şekilde kurulmuş ve çalışıyor olmalı.
• Arama fonksiyonu entegre etmek istediğiniz bir geliştirme projeniz olmalı.
• Arama motorunun temel kavramları (indeks, doküman, API anahtarı gibi) hakkında temel bilginiz olmalı.

Adım Adım Kurulum

1. Meilisearch Paketini Kurun

Öncelikle, ServBay'in paket yöneticisinden Meilisearch’i kurmanız gerekir:

1. ServBay uygulamasını açın.
2. Sol menüden Paketler (Packages) seçeneğine tıklayın.
3. Paket listesinde Arama başlığı altında Meilisearch’i bulun.
4. Meilisearch’in sağındaki yükleme düğmesine tıklayın ve kurulumun tamamlanmasını bekleyin.
5. Etkinleştirme düğmesine basarak Meilisearch servisini aktif edin.

2. Meilisearch Servisini Yapılandırın

Kurulum tamamlandıktan sonra, Meilisearch’i detaylı şekilde yapılandırabilirsiniz:

1. ServBay sol menüsünde Search sekmesine tıklayın.

2. Açılan menüden Meilisearch’i seçin ve yapılandırma ekranına girin.

   

3. İhtiyacınıza göre şu ayarları düzenleyebilirsiniz:

   • Bind IP (IP Bağlama): Meilisearch’in dinleyeceği IP adresi. Varsayılan 127.0.0.1 değeri, servisin yalnızca yerel makineden erişilebilir olmasını sağlar. Bu, yerel geliştirme için en güvenli uygulamadır.
   • Port (Port): Meilisearch API’ının çalıştığı port. Varsayılan port 7700’dür. Servis bu portta çalışsa da, etkileşim için ServBay’in sağladığı https://meilisearch.servbay.host domainini kullanmanız şiddetle tavsiye edilir.
   • Master Key (Ana Anahtar): Meilisearch örneğinizi koruyan en önemli kimlik bilgisidir. Tüm API isteklerinin (indeks oluşturma, güncelleme, silme dahil) yetkilendirilmesi gerekir. Karmaşık ve benzersiz bir anahtar belirleyin ve güvenle saklayın.
   • Data Path (Veri Yolu): Meilisearch’in tüm indeks ve veritabanı dosyalarını sakladığı yerel yol. Varsayılan yol: /Applications/ServBay/data/meilisearch. Sağdaki klasör simgesine tıklayarak bu dizini Finder’da hızlıca açabilirsiniz.
   • Runtime Environment (Çalışma Ortamı): Development (Geliştirme) veya Production (Üretim) arasında seçim yapabilirsiniz. Development daha ayrıntılı hata raporları ve API ipuçları sunar, gelişim sürecinde faydalıdır. Production ise bu detayları kapatır ve performansı artırır.
   • Log Level (Kayıt Düzeyi): Kayıtların ayrıntı seviyesi; INFO, DEBUG, WARN, ERROR gibi seçenekler sunar ve hata ayıklamayı kolaylaştırır.

3. Ayarları Kaydedin ve Servisi Başlatın

1. Tüm ayarlarınızı yaptıktan sonra, sağ alt köşedeki Kaydet (Save) butonuna tıklayın.
2. ServBay ayarlarınızı uygular ve Meilisearch servisini otomatik olarak başlatır veya yeniden başlatır.
3. Meilisearch satırının yanındaki durum ışığını gözleyin; yeşil ise servis başarılı şekilde çalışıyor demektir.

4. Meilisearch Web Paneline Erişim

ServBay, Meilisearch’in yerleşik yönetim paneline erişmeyi oldukça kolaylaştırır:

1. Yöntem 1 (Tavsiye Edilen): Meilisearch ayar ekranının sağ üst köşesindeki tarayıcı simgesine (pusula şeklinde) tıklayarak dashboard’ı varsayılan tarayıcınızda otomatik açabilirsiniz.

2. Yöntem 2: Tarayıcınızın adres çubuğuna https://meilisearch.servbay.host/ yazabilirsiniz.

   

Bu panelde şunları yapabilirsiniz:

• İndeksleri oluşturmak ve yönetmek
• Arama sorgularını görsel olarak test etmek ve sonuçları görmek
• Görev durumlarını izleme (doküman ekleme, ayar güncelleme vb.)
• API anahtarlarını yönetmek

5. Uygulamanıza Meilisearch’i Entegre Etme

Resmi veya topluluk tarafından sağlanan Meilisearch istemci kütüphanelerinden herhangi biriyle yerel örneğinizle kolayca iletişim kurabilirsiniz.

Bağlanırken şu bilgileri kullanmalısınız:

• Host (Ana Makine): https://meilisearch.servbay.host (mutlaka https:// ile)
• API Key (API Anahtarı): 2. adımda belirlediğiniz Master Key

PHP için Kod Örneği (meilisearch/meilisearch-php kullanılarak)

İlk olarak, PHP projenize istemci kütüphanesini ekleyin:

composer require meilisearch/meilisearch-php

Ardından, kodunuzda bağlantı ve işlemler için:

<?php
require_once 'vendor/autoload.php';

use MeiliSearch\Client;

// Meilisearch istemcisini başlat
$client = new Client('https://meilisearch.servbay.host', 'YOUR-STRONG-MASTER-KEY'); // Burayı kendi Master Key'iniz ile değiştirin

try {
    // 1. Bir indeks oluşturun veya alın
    $index = $client->index('movies');

    // 2. Belgeleri ekleyin
    $documents = [
        ['id' => 1, 'title' => 'Carol', 'genres' => ['Romance', 'Drama']],
        ['id' => 2, 'title' => 'Wonder Woman', 'genres' => ['Action', 'Adventure']],
        ['id' => 3, 'title' => 'Life of Pi', 'genres' => ['Adventure', 'Drama']],
        ['id' => 4, 'title' => 'Mad Max: Fury Road', 'genres' => ['Action', 'Adventure']],
        ['id' => 5, 'title' => 'Moana', 'genres' => ['Fantasy', 'Action']],
        ['id' => 6, 'title' => 'Philadelphia', 'genres' => ['Drama']],
    ];
    $index->addDocuments($documents);
    echo "Belgeler 'movies' indeksine eklendi.\n";

    // Meilisearch'in indeksleme görevini işlemesi için biraz bekleyin
    sleep(1); 

    // 3. Arama sorgusu çalıştırın
    $searchResults = $index->search('max');
    print_r($searchResults->getHits());

} catch (\Exception $e) {
    echo "Meilisearch Hatası: {$e->getMessage()}\n";
}

Sıkça Sorulan Sorular (SSS)

• S: Master Key’imi unuttum, ne yapmalıyım?
  • C: ServBay’in Meilisearch ayar ekranında yeni bir Master Key girip Kaydet (Save) tıklayın. ServBay servisi yeniden başlatır ve yeni anahtarı uygular.
• S: Meilisearch servisi başlatılamıyor, ne yapmalıyım?
  • C: Öncelikle Meilisearch ayar ekranının sağ üstündeki kayıt simgesine tıklayarak canlı logları görüntüleyin; burada genellikle hata detayları bulunur. Ayrıca, yerel port 7700’ün başka bir programca kullanılmadığından emin olun.
• S: “Runtime Environment” ayarındaki Development ve Production arasındaki farklar neler?
  • C: Development modunda, API yanıtları hatalar sırasında çok ayrıntılı yığın izleri içerebilir ve debug için idealdir; ancak iç detayları açığa çıkarabilir. Production ise sadece genel hata mesajları döndürür, bu da güvenli ve yüksek performanslıdır. Canlıya çıkarken veya ayrıntılı debug’a ihtiyacınız yoksa bu mod önerilir.

Sonuç

ServBay ile Meilisearch’in birleşimi, macOS geliştiricilerine güçlü ve sorunsuz bir yerel arama geliştirme deneyimi sunar. Basitleştirilmiş grafiksel yönetim ve yerleşik web paneli sayesinde enerjinizi temel arama özelliklerini inşa etmeye odaklayabilir, karmaşık ortam ayarlarıyla vakit kaybetmezsiniz.