Flarum的搜索引擎有哪些很好支持中文的说到 Flarum，自带的搜索对中文文字不好用，于是整理出一些全文检索方案给大家参考。本文教程所使用环境 Flarum版本: v1.6.2 Nginx1.2 + Mysql 8 + PHP 8 — 支持中文搜索的方案 1、Sonic 2、Meilisearch 3、Algolia 4、Elasticsearch 性能、部署难度、数据规模、分词能力 1、从安装使用难度如下： Algolia < Sonic < Meilisearch < Elasticsearch 2、服务器性能占用大小 Algolia < Sonic < Meilisearch < Elasticsearch 3、功能、数据规模和分词能力 //2022-11-26更正 Sonic < Algolia < Meilisearch < Elasticsearch 安装部署的方式一、Algolia Algolia （www.algolia.com）不需要在自己服务器部署，不用担心影响服务器的性能，只需从 Algolia 官网申请一个API ，然后在 Flarum 安装一个 Scout Search 扩展，启用后，填写Algolia API 即可。 Algolia 免费方案仅可使用 10,000 次/月的查询量，超出的量可以查阅官方价格 https://www.algolia.com/pricing/ ，假如你的论坛使用量不多，可以试试这个。部署和配置方式： 1、到Algolia （www.algolia.com）注册一个账号，并且创建API，整个过程大概需要几分钟时间 2、Flarum需要安装 Scout Search （ https://extiverse.com/extension/clarkwinkelmann/flarum-ext-scout ）这个扩展并启用 3、进入Flarum管理后台，在 Scout Search 选择Algolia 并填写刚才申请的API，如下图： 4、SSH进入Flarum安装目录，运行 php flarum scout:import-all 这句命令创建索引成功会提示如下：二、Sonic Sonic最好的使用方式便是docker，所以请先确保你会简单的使用docker，仅仅需要知道一些概念即可，不过Sonic 的分词功能不是很好，不一定所有关键词都能搜到，但也比原生的好。部署和配置方式： 1、安装 Docker 2、安装Sonic https://github.com/valeriansaliou/sonic#installation 3、安装 ganuonglachanh/sonic 插件 https://extiverse.com/extension/ganuonglachanh/sonic 4、启用插件，设置默认即可，不需要修改 5、创建索引，在 Flarum 安装目录运行 php flarum sonic:addtoindex 命令详细部署方式参考 https://forum.gitzaai.com/d/48-flarum-search-by-sonic-he-dockeran-zhuang-ji-lu 三、Meilisearch MeiliSearch （ https://www.meilisearch.com/ ）是一个强大、快速、开源、易于使用和部署的搜索引擎。搜索和索引都是高度可定制的。提供开箱即用的功能，如错字容忍、过滤器和同义词。对服务器的性能要求有点高，详细请查阅官网。部署和配置方式： 1、安装 Meilisearch 轻量级搜索引擎 2、安装 Meilisearch SDK ，在 Flarum 安装目录运行 composer require meilisearch/meilisearch-php 3、安装 Scout Search 扩展 https://extiverse.com/extension/clarkwinkelmann/flarum-ext-scout 4、启用 Scout Search ，填写 Meilisearch 的API 5、创建索引，在 Flarum 安装目录运行 php flarum scout:import-all 这句命令如果成功就会返回如下信息详细安装方式参考如下 https://forum.gitzaai.com/d/79-yong-meilisearch-ti-dai-flarum-de-zhong-wen-sou-suo-gong-neng 四、Elasticsearch 这个太高级了，需要掌握的知识面非常多，我也不会。部署和配置方式： 1、部署 Elasticsearch 2、安装 blomstra/search 或者同类插件 https://extiverse.com/extension/blomstra/search 3、启用插件，填写Elasticsearch API 4、创建索引，在 Flarum 安装目录运行 php flarum blomstra:search:index 这句命令总结如果你不懂使用简单的Docker命令，或者 Linux 基础知识（创建文件、解压缩文件，文件权限、文件目录），并且你的用户量很少，推荐使用 Algolia ， Meilisearch 其实这两者所需用到的知识不是很多，只不过Meilisearch 所需的服务器性比Sonic能高一点点。希望这篇文章能帮到大家，作为新手的我，如果写得不好，请多多指教，如有错漏，欢迎留言补充。

Flarum支持中文的搜索方案

CharlieK

null o 感谢楼主的总结，想问一下meilisearch和sonic的性能差异大概有多少呢？

null o

CharlieK
相差20%

Golden

试了下， meilisearch/meilisearch-php (v0.25.0 降级到 v0.24.2)，v0.29.2 的 Meilisearch 就能正常创建索引了。

遇到的两个问题：

SEO 插件好像跟这个不兼容，开着 SEO 不能创建索引。

$ php flarum scout:import-all
PHP Warning:  Missing arginfo for bt_echo() in Unknown on line 0
Imported [Flarum\Discussion\Discussion] models up to ID: 551
Imported [Flarum\Discussion\Discussion] models up to ID: 1329
Imported [Flarum\Discussion\Discussion] models up to ID: 2127
Imported [Flarum\Discussion\Discussion] models up to ID: 2656
Imported [Flarum\Discussion\Discussion] models up to ID: 3485
Imported [Flarum\Discussion\Discussion] models up to ID: 3995
All [Flarum\Discussion\Discussion] records have been imported.
PHP Fatal error:  Uncaught TypeError: V17Development\FlarumSeo\Formatter\FormatLinks::__invoke(): Argument #1 ($renderer) must be of type s9e\TextFormatter\Renderer, __PHP_Incomplete_Class given, called in /www/wwwroot/discuss.flarum.org.cn/vendor/flarum/core/src/Foundation/ContainerUtil.php on line 30 and defined in /www/wwwroot/discuss.flarum.org.cn/vendor/v17development/flarum-seo/src/Formatter/FormatLinks.php:56
Stack trace:
#0 /www/wwwroot/discuss.flarum.org.cn/vendor/flarum/core/src/Foundation/ContainerUtil.php(30): V17Development\FlarumSeo\Formatter\FormatLinks->__invoke()
#1 /www/wwwroot/discuss.flarum.org.cn/vendor/flarum/core/src/Formatter/Formatter.php(114): Flarum\Foundation\ContainerUtil::Flarum\Foundation\{closure}()
#2 /www/wwwroot/discuss.flarum.org.cn/vendor/flarum/core/src/Post/CommentPost.php(174): Flarum\Formatter\Formatter->render()
#3 /www/wwwroot/discuss.flarum.org.cn/vendor/clarkwinkelmann/flarum-ext-scout/extend.php(98): Flarum\Post\CommentPost->formatContent()
#4 /www/wwwroot/discuss.flarum.org.cn/vendor/clarkwinkelmann/flarum-ext-scout/src/ScoutModelWrapper.php(165): Flarum\Extension\Extension->ClarkWinkelmann\Scout\{closure}()
#5 /www/wwwroot/discuss.flarum.org.cn/vendor/laravel/scout/src/Engines/MeiliSearchEngine.php(62): ClarkWinkelmann\Scout\ScoutModelWrapper->toSearchableArray()
#6 [internal function]: Laravel\Scout\Engines\MeiliSearchEngine->Laravel\Scout\Engines\{closure}()
#7 /www/wwwroot/discuss.flarum.org.cn/vendor/illuminate/collections/Collection.php(695): array_map()
#8 /www/wwwroot/discuss.flarum.org.cn/vendor/illuminate/database/Eloquent/Collection.php(350): Illuminate\Support\Collection->map()
#9 /www/wwwroot/discuss.flarum.org.cn/vendor/laravel/scout/src/Engines/MeiliSearchEngine.php(71): Illuminate\Database\Eloquent\Collection->map()
#10 /www/wwwroot/discuss.flarum.org.cn/vendor/clarkwinkelmann/flarum-ext-scout/src/ScoutServiceProvider.php(100): Laravel\Scout\Engines\MeiliSearchEngine->update()
#11 /www/wwwroot/discuss.flarum.org.cn/vendor/illuminate/macroable/Traits/Macroable.php(124): Illuminate\Database\Eloquent\Collection->ClarkWinkelmann\Scout\{closure}()
#12 /www/wwwroot/discuss.flarum.org.cn/vendor/clarkwinkelmann/flarum-ext-scout/src/FlarumSearchableScope.php(46): Illuminate\Support\Collection->__call()
#13 /www/wwwroot/discuss.flarum.org.cn/vendor/illuminate/database/Concerns/BuildsQueries.php(139): ClarkWinkelmann\Scout\FlarumSearchableScope->ClarkWinkelmann\Scout\{closure}()
#14 /www/wwwroot/discuss.flarum.org.cn/vendor/clarkwinkelmann/flarum-ext-scout/src/FlarumSearchableScope.php(49): Illuminate\Database\Eloquent\Builder->chunkById()
#15 /www/wwwroot/discuss.flarum.org.cn/vendor/illuminate/database/Eloquent/Builder.php(1639): ClarkWinkelmann\Scout\FlarumSearchableScope->ClarkWinkelmann\Scout\{closure}()
#16 /www/wwwroot/discuss.flarum.org.cn/vendor/clarkwinkelmann/flarum-ext-scout/src/ScoutStatic.php(37): Illuminate\Database\Eloquent\Builder->__call()
#17 /www/wwwroot/discuss.flarum.org.cn/vendor/clarkwinkelmann/flarum-ext-scout/src/Console/ModifiedImportTrait.php(22): ClarkWinkelmann\Scout\ScoutStatic::makeAllSearchable()
#18 /www/wwwroot/discuss.flarum.org.cn/vendor/clarkwinkelmann/flarum-ext-scout/src/Console/ImportAllCommand.php(29): ClarkWinkelmann\Scout\Console\ImportAllCommand->handleClass()
#19 /www/wwwroot/discuss.flarum.org.cn/vendor/illuminate/container/BoundMethod.php(36): ClarkWinkelmann\Scout\Console\ImportAllCommand->handle()
#20 /www/wwwroot/discuss.flarum.org.cn/vendor/illuminate/container/Util.php(40): Illuminate\Container\BoundMethod::Illuminate\Container\{closure}()
#21 /www/wwwroot/discuss.flarum.org.cn/vendor/illuminate/container/BoundMethod.php(93): Illuminate\Container\Util::unwrapIfClosure()
#22 /www/wwwroot/discuss.flarum.org.cn/vendor/illuminate/container/BoundMethod.php(37): Illuminate\Container\BoundMethod::callBoundMethod()
#23 /www/wwwroot/discuss.flarum.org.cn/vendor/illuminate/container/Container.php(653): Illuminate\Container\BoundMethod::call()
#24 /www/wwwroot/discuss.flarum.org.cn/vendor/illuminate/console/Command.php(136): Illuminate\Container\Container->call()
#25 /www/wwwroot/discuss.flarum.org.cn/vendor/symfony/console/Command/Command.php(298): Illuminate\Console\Command->execute()
#26 /www/wwwroot/discuss.flarum.org.cn/vendor/illuminate/console/Command.php(121): Symfony\Component\Console\Command\Command->run()
#27 /www/wwwroot/discuss.flarum.org.cn/vendor/symfony/console/Application.php(1058): Illuminate\Console\Command->run()
#28 /www/wwwroot/discuss.flarum.org.cn/vendor/symfony/console/Application.php(301): Symfony\Component\Console\Application->doRunCommand()
#29 /www/wwwroot/discuss.flarum.org.cn/vendor/symfony/console/Application.php(171): Symfony\Component\Console\Application->doRun()
#30 /www/wwwroot/discuss.flarum.org.cn/vendor/flarum/core/src/Console/Server.php(42): Symfony\Component\Console\Application->run()
#31 /www/wwwroot/discuss.flarum.org.cn/flarum(24): Flarum\Console\Server->listen()
#32 {main}
  thrown in /www/wwwroot/discuss.flarum.org.cn/vendor/v17development/flarum-seo/src/Formatter/FormatLinks.php on line 56

curl 错误，导致索引中断，meilisearch docker 服务一直停止运行，重启后立马停运。最后删除存储卷重建容器 + 重建索引。

In CurlFactory.php line 211:
                                                                                                                 
  cURL error 56: Recv failure: Connection reset by peer (see https://curl.haxx.se/libcurl/c/libcurl-errors.html  
  ) for http://127.0.0.1:7700/indexes/posts/documents?primaryKey=id

null o

Golden
我安装的是v0.29.2 ，开着SEO都没问题，但是A和B站点通用使用一个方案，A站点却不行，不清楚是哪里问题

拜瑞

null o 不知道为什么，我的meilisearch在搜索中文+英文混合内容的时候无法搜索出相应内容

meilisearch:docker的latest

可能是因为我之前用的是sonic不能import？还是这个机制就是这样的

null o

拜瑞我测试了好几个组合没发现有问题

拜瑞

null o 那就奇怪了，我测中文站和我站的都是一样(搜索"WIP 论坛小程序")

null o

拜瑞 Image description

拜瑞

null o 貌似是搜索展现内容的顺序和逻辑不一样，sonic是默认完全匹配后才是其他的，meilisearch的逻辑明显不同，试了试那些没搜到的只是在太下面了而已

Golden

拜瑞是这样的，我也打算换了

kai

感謝大神~
原本使用MYSQL 5.7自帶搜索，照著教學，咱把Meilisearch搞定
本來搜不到的一些英文單字詞及中文單字母，目前找的著，反應速度也快了

juneleung

请问我部署meilisearch的时候，在php那一步 (5、创建索引，在 Flarum 安装目录运行 php flarum sonic:addtoindex 命令) 会一直提示错误，这个是那个地方出问题了呢谢谢！

Image description

null o

juneleung 你看看你的meilisearch是否开启了

systemctl status meilisearch

还有 MASTER_KEY 有没有错

juneleung

null o

我是在mac下docker运行的，好像没有linux的systemctl的命令，我看docker里显示的containers正在运行, 里边也显示了设置了master key

Image description

null o

juneleung docker我不熟

拜瑞

null o 不过Sonic 的分词功能不是很好，不一定所有关键词都能搜到，但也比原生的好

sonic官方是支持中文分词的，效果还不错，只不过~~天杀的~~作者没有贴出简中繁中这些语言环境的代码（因为汉语是一种宏语言，分支太多了，如果仅仅是 zh, chs 这种广义上的中文代码，难免会在一些地区方言上起冲突）。对于简中，可以将语言环境设置成 cmn ，然后再运行 php flarum sonic:addtoindex ，分词效果会好很多，其他汉语分支可以对照着 ISO639-3 里面 Individual Languages 去寻找对应的代码。

lain

感谢楼主教程！meilisearch也可以部署在别的服务器，通过域名反代访问

Meilisearch Host：https://your_domin.com
Meilisearch Key：your_key

米开朗基杨

感谢楼主，我写了一篇文章介绍如何将 flarum 接入 meilisearch：

https://mp.weixin.qq.com/s/udeF1B_LJ3GBOPc6GAniSg

null o

米开朗基杨你站我收了，你写得太好了

ink

米开朗基杨```
php flarum scout:import-all
Imported [Flarum\Discussion\Discussion] models up to ID: 121
All [Flarum\Discussion\Discussion] records have been imported.

In XmlUtils.php line 66:

[ERROR 4] Start tag expected, ‘<’ not found (in n/a - line 1, column 1)

scout:import-all [-c|–chunk [CHUNK]]

我使用Meilisearch建立索引会出这样的错不知道为啥