Flaurm实现中文搜索

摘要

  Flarum本身对中文支持并不理想，但随着版本更新，逐渐加强了对中文的优化。然而在1.8.5版本，却还是不支持中文搜索网站文章内容。作者在检索了全网教程，对于Flarum支持中文搜索的教程都很复杂。本人比较怕麻烦，再加上数据才迁移到新的服务器上，生怕再出问题，故需要一个简单、稳定的方法，就有了这篇文章。

此方法会在一定程度上影响数据库性能，请明确需求后再进行操作。

需求

让Flarum搜索框，支持搜索中文，方法简单、稳定，实现效果如下：

image-20240210231853277

本文涉及环境情况如下

序号 环境名称 版本
1 Flarum 1.8.5
2 MYSQL 8.2.0

解决方案

本文涉及部分危险操作，有可能会造成数据丢失，请在开始操作前，备份数据库及重要文件！

1.对ngram_token_size进行设置。打开MySQL配置文件mysql.cnf，加入如下内容

1
2
[mysqld]
ngram_token_size=2

image-20240211001012211

此步操作详细解释参考下面折叠内容

查看详细解释

对ngram_token_size进行设置的详情解释。

具体来说：

  • ngram_token_size 是一个配置参数，用于指定 Ngram 全文索引的 token 大小。Ngram 是一种文本分析方法，它将文本分割成一系列的 n-gram（即长度为 n 的字符串序列）。在全文索引中，这种方法特别适用于处理像中文或日文这样的语言，因为这些语言不像英文那样使用空格分隔单词。
  • =2 表明了 ngram 的长度被设置为 2。这意味着系统将在创建全文索引时，将文本分割成长度为 2 个字符的序列。例如，对于中文文本，“中华人民”将被分割为“中华”、“华人”、“人民”这样的序列。

这个设置对于处理中文、日文等语言的全文搜索特别有用，因为它允许数据库更有效地索引和搜索这些语言的文本内容。通过将 ngram_token_size 设置为 2，MySQL 能够更好地理解和索引这些语言的结构，从而提高搜索的准确性和效率。

2.重启MySQL生效配置

3.删除原索引文件

1
2
3
# 如有前缀直接复制本段 0，若没有前缀，请去除flarum_
ALTER TABLE flarum_posts DROP INDEX content;
ALTER TABLE flarum_discussions DROP INDEX title;

image-20240210234951790

请备份所有数据再进行操作，此操作可能会导致网站不可用！

如果出现报错1091 - Can't DROP 'title'; check that column/key exists，原因主要做如下

  • 不存在索引或列
  • 索引或列名有误
  • 权限问题
  • 服务器问题

4.重建新的索引文件

（1）文章内容索引创建

1
2
3
# 如有前缀直接复制本段 0，若没有前缀，请去除flarum_
SELECT * FROM `flarum_posts`;	
CREATE FULLTEXT INDEX content ON flarum_posts (content) WITH PARSER ngram;

image-20240210235636770

（2）讨论内容索引创建

1
2
3
# 如有前缀直接复制本段 0，若没有前缀，请去除flarum_
SELECT * FROM `flarum_discussions`;	
CREATE FULLTEXT INDEX title ON flarum_discussions (title) WITH PARSER ngram;

执行截图如下

image-20240210234412389

SELECT * FROM可以省略

最终效果

image-20240211000342376