Konfigurasi dan Penggunaan Enjin Carian Meilisearch di ServBay

Meilisearch ialah enjin carian sumber terbuka yang sangat berkuasa, sangat pantas dan mudah digunakan, direka khas untuk memberikan pengalaman “cari sambil taip” yang luar biasa. Ia menawarkan pelbagai fungsi melalui RESTful API yang mudah. Dengan bantuan ServBay, penyebaran Meilisearch yang lengkap dalam persekitaran tempatan macOS kini lebih mudah berbanding sebelum ini.

Ringkasan

ServBay mengintegrasikan Meilisearch secara natif ke dalam antara muka pengurusan grafiknya, membolehkan pembangun memasang dan mengkonfigurasi hanya dengan satu klik, tanpa perlu berurusan dengan baris perintah atau kebergantungan yang rumit. ServBay juga secara automatik menyediakan papan pemuka web terbina dalam untuk Meilisearch yang boleh diakses dengan mudah melalui domain https://meilisearch.servbay.host/ untuk mengurus indeks, menguji carian dan memantau status servis.

Prasyarat

• macOS anda telah dipasang dan menjalankan ServBay dengan berjaya.
• Anda mempunyai projek pembangunan yang memerlukan ciri carian.
• Anda memahami asas konsep enjin carian (seperti Index, Document, API Key).

Langkah-langkah Operasi

1. Pasang Pakej Meilisearch

Pertama sekali, anda perlu memasang Meilisearch melalui pengurus pakej ServBay:

1. Buka aplikasi ServBay.
2. Dalam bar navigasi sebelah kiri, klik Pakej (Packages).
3. Cari Carian - Meilisearch dalam senarai pakej.
4. Klik butang pasang di sebelah Meilisearch dan tunggu proses pemasangan selesai.
5. Klik butang dayakan untuk mengaktifkan servis Meilisearch.

2. Konfigurasi Servis Meilisearch

Selepas pemasangan, anda boleh membuat konfigurasi terperinci untuk Meilisearch:

1. Dalam bar navigasi kiri ServBay, klik Search.

2. Pilih Meilisearch dalam menu tarik-turun untuk masuk ke paparan konfigurasi.

   

3. Laraskan pilihan berikut mengikut keperluan anda:

   • Bind IP (Alamat IP): Alamat IP yang dipantau oleh servis Meilisearch. Nilai lalai 127.0.0.1 bermaksud servis hanya terbuka untuk hos tempatan – amalan keselamatan terbaik untuk pembangunan tempatan.
   • Port (Port): Port bawah yang digunakan oleh API Meilisearch. Lalai ialah 7700. Walaupun servis dijalankan pada port ini, amat disarankan untuk berinteraksi melalui domain yang disediakan ServBay iaitu https://meilisearch.servbay.host.
   • Master Key (Kunci Utama): Ini ialah kelayakan terpenting untuk melindungi instans Meilisearch anda. Semua permintaan API (termasuk ciptaan, kemaskini dan penghapusan indeks) mesti dibenarkan dengan kunci ini. Tetapkan kunci yang kompleks dan unik serta simpan dengan selamat.
   • Data Path (Laluan Data): Laluan setempat tempat Meilisearch menyimpan semua indeks dan fail pangkalan data. Lalai ialah /Applications/ServBay/data/meilisearch. Anda boleh klik ikon folder di sebelah kanan untuk membuka direktori ini dengan pantas dalam Finder.
   • Runtime Environment (Persekitaran Masa Jalan): Pilih antara Development (Pembangunan) atau Production (Produksi). Mod Development memberi laporan ralat dan petunjuk API yang lebih terperinci, sesuai untuk fasa pembangunan. Mod Production akan mematikan maklumat ini bagi prestasi lebih baik.
   • Log Level (Tahap Log): Kawal tahap perincian log. Pilihan seperti INFO, DEBUG, WARN, ERROR membantu proses penyahpepijatan.

3. Simpan Konfigurasi dan Mulakan Servis

1. Selepas anda selesai menyesuaikan konfigurasi, klik butang Simpan (Save) di kanan bawah.
2. ServBay akan memproses tetapan anda dan cuba memulakan/menghidupkan semula servis Meilisearch.
3. Perhatikan lampu status di sebelah entri Meilisearch; hijau bermaksud servis berjalan dengan berjaya.

4. Akses Papan Pemuka Web Meilisearch

ServBay menyediakan cara mudah untuk mengakses konsol pengurusan terbina dalam Meilisearch:

1. Kaedah 1 (Disyorkan): Dalam antara muka konfigurasi Meilisearch, klik ikon pelayar (berbentuk kompas) di penjuru kanan atas. ServBay akan membuka papan pemuka dalam pelayar lalai anda.

2. Kaedah 2: Masukkan alamat https://meilisearch.servbay.host/ secara manual dalam pelayar anda.

   

Dalam papan pemuka ini, anda boleh:

• Mencipta dan mengurus indeks.
• Mencuba carian dan melihat hasilnya secara langsung.
• Memantau status tugas (seperti penambahan dokumen, pengemaskinian seting, dan lain-lain).
• Mengurus API Key.

5. Integrasi Meilisearch ke Dalam Aplikasi Anda

Anda boleh berinteraksi dengan instans tempatan anda menggunakan mana-mana pustaka klien Meilisearch rasmi atau komuniti.

Untuk sambungan, gunakan maklumat berikut:

• Host: https://meilisearch.servbay.host (termasuk https://)
• API Key: Master Key yang anda tetapkan dalam langkah 2

Contoh Kod PHP (menggunakan meilisearch/meilisearch-php)

Pasang pustaka klien dalam projek PHP anda:

composer require meilisearch/meilisearch-php

Kemudian, lakukan sambungan dan operasi dalam kod anda:

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

use MeiliSearch\Client;

// Inisialisasi klien Meilisearch
$client = new Client('https://meilisearch.servbay.host', 'YOUR-STRONG-MASTER-KEY'); // Gantikan dengan Master Key anda sendiri

try {
    // 1. Cipta atau ambil indeks sedia ada
    $index = $client->index('movies');

    // 2. Tambah dokumen
    $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 "Dokumen berjaya ditambah ke indeks 'movies'.\n";

    // Tunggu sebentar untuk Meilisearch memproses tugas pengindeksan
    sleep(1); 

    // 3. Jalankan carian
    $searchResults = $index->search('max');
    print_r($searchResults->getHits());

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

Soalan Lazim (FAQ)

• S: Saya terlupa Master Key. Apa yang perlu saya lakukan?
  • J: Dalam paparan konfigurasi Meilisearch di ServBay, anda boleh terus masukkan Master Key baharu, kemudian klik Simpan (Save). ServBay akan memulakan semula servis dan menggunakan kunci baharu anda.
• S: Servis Meilisearch gagal dimulakan; apa langkah penyelesaian masalah?
  • J: Pertama, klik ikon log di penjuru kanan atas antara muka konfigurasi Meilisearch untuk melihat log masa nyata yang biasanya memaparkan sebab ralat. Selain itu, pastikan port tempatan 7700 tidak digunakan oleh aplikasi lain.
• S: Apakah perbezaan antara Development dan Production dalam “Runtime Environment”?
  • J: Dalam mod Development, respons API bagi ralat akan mengandungi maklumat stack trace yang sangat terperinci, memudahkan proses debugging – tetapi ia juga mendedahkan butiran dalaman. Mod Production pula hanya memaparkan maklumat ralat umum, lebih selamat dan berprestasi tinggi serta sesuai untuk persekitaran produksi atau bila debugging terperinci tidak diperlukan.

Rumusan

Gabungan ServBay dan Meilisearch menawarkan pengalaman pembangunan carian tempatan yang sangat lancar dan bertenaga untuk pembangun macOS. Dengan pengurusan grafik yang ringkas dan papan pemuka web sedia guna, anda boleh menumpukan sepenuhnya pada pembinaan fungsi carian teras aplikasi anda tanpa perlu bergelut dengan konfigurasi persekitaran yang kompleks.