在 ServBay 中配置和使用 Meilisearch 搜索引擎

Meilisearch 是一款功能强大、速度极快且易于使用的开源搜索引擎，专为提供卓越的“键入即搜索”体验而构建。它通过简单的 RESTful API 提供了丰富的功能。借助 ServBay，在 macOS 本地环境中部署一个功能完备的 Meilisearch 实例变得前所未有的简单。

概述

ServBay 将 Meilisearch 集成到其图形化管理界面中，让开发者可以一键安装并轻松配置，无需处理复杂的命令行和依赖关系。ServBay 还为 Meilisearch 自动配置了一个内置的 Web 仪表板，您可以通过一个方便的域名 https://meilisearch.servbay.host/ 直接访问，用于管理索引、测试搜索和查看实例状态。

前提条件

您的 macOS 系统已成功安装并运行 ServBay。
您有一个需要集成搜索功能的开发项目。
对搜索引擎的基本概念（如索引 Index, 文档 Document, API 密钥）有基本了解。

操作步骤

1. 安装 Meilisearch 软件包

首先，您需要在 ServBay 的软件包管理器中安装 Meilisearch：

打开 ServBay 应用程序。
在左侧导航栏中，点击 软件包 (Packages)。
在软件包列表中找到搜索 - Meilisearch。
点击 Meilisearch 右侧的安装按钮，等待安装完成。
点击启用按钮，启用 Meilisearch 服务。

2. 配置 Meilisearch 服务

安装完成后，您可以对 Meilisearch 进行详细配置：

在 ServBay 左侧导航栏中，点击 Search。
在下拉菜单中选择 Meilisearch，进入其配置界面。
根据您的需求调整以下配置项：
- Bind IP (绑定 IP): Meilisearch 服务监听的 IP 地址。默认值 127.0.0.1 表示服务仅对本机开放，这是本地开发环境的最佳安全实践。
- Port (端口): Meilisearch API 的底层监听端口。默认值为 7700。虽然服务运行在此端口，但我们强烈推荐您通过 ServBay 提供的 https://meilisearch.servbay.host 域名进行交互。
- Master Key (主密钥): 这是保护您的 Meilisearch 实例的最重要凭证。所有 API 请求（包括创建、更新和删除索引）都必须使用此密钥进行授权。请设置一个复杂且唯一的密钥，并妥善保管。
- Data Path (数据路径): Meilisearch 存储所有索引和数据库文件的本地路径。默认路径为 /Applications/ServBay/data/meilisearch。您可以点击右侧的文件夹图标在 Finder 中快速打开此目录。
- Runtime Environment (运行环境): 您可以选择 Development (开发) 或 Production (生产)。Development 模式会提供更详细的错误报告和 API 提示，非常适合开发阶段。Production 模式则会关闭这些详细信息以提升性能。
- Log Level (日志级别): 控制日志输出的详细程度，可选 INFO, DEBUG, WARN, ERROR 等，便于调试问题。

3. 保存配置并启动服务

完成所有配置调整后，点击右下角的 Save (保存) 按钮。
ServBay 会自动应用您的设置并尝试启动/重启 Meilisearch 服务。
观察 Meilisearch 条目旁边的状态指示灯，绿色表示服务已成功运行。

4. 访问 Meilisearch Web 仪表板

ServBay 提供了非常便捷的方式来访问 Meilisearch 的内置管理面板：

方法一 (推荐): 在 Meilisearch 的配置界面右上角，点击浏览器图标 (形如指南针)，ServBay 将自动在您的默认浏览器中打开仪表板。
方法二: 手动在浏览器地址栏输入 https://meilisearch.servbay.host/。

在这个仪表板中，您可以：

创建和管理索引。
直观地测试搜索查询并查看结果。
查看任务状态（如文档添加、设置更新等）。
管理 API 密钥。

5. 在应用中集成 Meilisearch

您可以使用任何官方或社区提供的 Meilisearch 客户端库与您的本地实例进行交互。

连接时，请使用以下信息：

Host (主机): https://meilisearch.servbay.host (包含 https://)
API Key (API 密钥): 您在步骤 2 中设置的 Master Key

PHP 代码示例 (使用 `meilisearch/meilisearch-php`)

首先，在您的 PHP 项目中安装客户端库：

bash

composer require meilisearch/meilisearch-php

然后，在您的代码中进行连接和操作：

php

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

use MeiliSearch\Client;

// 初始化 Meilisearch 客户端
$client = new Client('https://meilisearch.servbay.host', 'YOUR-STRONG-MASTER-KEY'); // 替换为您自己的 Master Key

try {
    // 1. 创建或获取一个索引
    $index = $client->index('movies');

    // 2. 添加文档
    $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 "Documents added to 'movies' index.\n";

    // 等待一会以便 Meilisearch 处理索引任务
    sleep(1); 

    // 3. 执行搜索
    $searchResults = $index->search('max');
    print_r($searchResults->getHits());

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

常见问题 (FAQ)

Q: 我忘记了 Master Key，该怎么办？
- A: 在 ServBay 的 Meilisearch 配置界面，您可以直接输入一个新的 Master Key，点击 Save (保存)。ServBay 会为您重启服务并应用新的密钥。
Q: Meilisearch 服务启动失败了，如何排查？
- A: 首先，点击 Meilisearch 配置界面右上角的日志图标，查看实时日志，这通常会包含明确的错误信息。其次，确认本地端口 7700 没有被其他程序占用。
Q: “Runtime Environment” 中的 Development 和 Production 有什么具体区别？
- A: Development 模式下的 API 响应在出错时会包含非常详细的堆栈信息，便于调试，但会暴露一些内部细节。Production 模式则会返回通用的错误信息，更安全、性能也更高，适合生产环境或当您不需要详细调试信息时使用。

总结

ServBay 与 Meilisearch 的结合为 macOS 开发者提供了一个强大而流畅的本地搜索开发体验。通过简化的图形化管理和预置的 Web 仪表板，您可以将精力完全集中在构建应用的核心搜索功能上，而不是在繁琐的环境配置中挣扎。

在 ServBay 中配置和使用 Meilisearch 搜索引擎 ​

概述 ​

前提条件 ​

操作步骤 ​

1. 安装 Meilisearch 软件包 ​

2. 配置 Meilisearch 服务 ​

3. 保存配置并启动服务 ​

4. 访问 Meilisearch Web 仪表板 ​

5. 在应用中集成 Meilisearch ​

PHP 代码示例 (使用 meilisearch/meilisearch-php) ​

常见问题 (FAQ) ​

总结 ​