前言

Flarum是一款轻论坛程序，该程序安装后的论坛页面简洁轻快，样式排版也比较合理好看。关于Flarum的更多特点这里就不介绍了，可以到官网查看。
Flarum官网：https://flarum.org/
GitHub：https://github.com/justjavac/flarum
官方文档：https://github.com/justjavac/flarum-doc/blob/master/using/installation.md


Flarum已经于北京时间 2021年5月27日 17:00 发布了第一个正式版。

1.教程步骤

1.1环境要求

内存：>=2GB
MySQL：5.7+ //开启中文搜索功能需要 MySQL 5.7 及以上。
PHP：>=7.3
Composer：宝塔Linux面板默认已安装

本教程默认安装服务器环境：CentOS 7.9，宝塔Linux面板。环境程序的安装过程这里就不说了，宝塔直接点击安装即可。

官方安装文档很久没有更新，里面有部分内容是错误的，只可参考。

1.2创建站点

首先我们在宝塔面板正常创建一个站点，同时创建MySQL数据库。

1.3删除站点目录文件

创建站点后默认宝塔面板会在站点目录内生成几个文件，我们需要将这几个文件全部删除。保持站点目录为空的状态。

1.4删除PHP禁用函数

宝塔面板的默认PHP安装后会禁用一些危险函数。我们需要将这些函数在禁用列表删除。

putenv，pcntl_signal，proc_open

1.4安装fileinfo扩展

程序需要使用到fileinfo这个PHP扩展，我们需要安装一下。

1.5确认Composer 状态

进入服务器SSH，输入命令Composer查看服务器是否安装了Composer 。

如果未安装，可使用下面命令进行安装。

php -r "copy('https://install.phpcomposer.com/installer', 'composer-setup.php');"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer

1.6安装Flarum

SSH中进入站点目录：cd 目录地址

其中diqizhan.com其实就是你宝塔中新增的空站点路径
然后在改路径下使用下面命令安装Flarum

composer create-project flarum/flarum . --stability=beta

安装完成后会显示如下界面：

1.7伪静态设置

Flarum需要添加伪静态规则。规则其实就是网站目录里的.nginx.conf。这里不要使用官方文档里的伪静态，否则无法打开后台地址，报404。

1.7.1 Nginx

# Pass requests that don't refer directly to files in the filesystem to index.php
location / {
try_files $uri $uri/ /index.php?$query_string;
}

# Uncomment the following lines if you are not using a `public` directory
# to prevent sensitive resources from being exposed.
# location ~* ^/(\.git|composer\.(json|lock)|auth\.json|config\.php|flarum|storage|vendor) {
# deny all;
# return 404;
# }

# The following directives are based on best practices from H5BP Nginx Server Configs
# https://github.com/h5bp/server-configs-nginx

# Expire rules for static content
location ~* \.(?:manifest|appcache|html?|xml|json)$ {
add_header Cache-Control "max-age=0";
}

location ~* \.(?:rss|atom)$ {
add_header Cache-Control "max-age=3600";
}

location ~* \.(?:jpg|jpeg|gif|png|ico|cur|gz|svg|mp4|ogg|ogv|webm|htc)$ {
add_header Cache-Control "max-age=2592000";
access_log off;
}

location ~* \.(?:css|js)$ {
add_header Cache-Control "max-age=31536000";
access_log off;
}

location ~* \.(?:ttf|ttc|otf|eot|woff|woff2)$ {
add_header Cache-Control "max-age=2592000";
access_log off;
}

# Gzip compression
gzip on;
gzip_comp_level 5;
gzip_min_length 256;
gzip_proxied any;
gzip_vary on;
gzip_types
application/atom+xml
application/javascript
application/json
application/ld+json
application/manifest+json
application/rss+xml
application/vnd.geo+json
application/vnd.ms-fontobject
application/x-font-ttf
application/x-web-app-manifest+json
application/xhtml+xml
application/xml
font/opentype
image/bmp
image/svg+xml
image/x-icon
text/cache-manifest
text/css
text/javascript
text/plain
text/vcard
text/vnd.rim.location.xloc
text/vtt
text/x-component
text/x-cross-domain-policy;

其他环境的伪静态规则都可以在网站目录内找到，composer执行后会下载下来。这里就不再贴了。

1.8更改运行目录

将网站运行目录更改为站点目录下面的public目录

1.9更改文件夹权限

storage文件夹权限设为777，用户组root

public/assets文件夹权限设为777，用户组root

1.10填写配置信息

前面步骤做完后访问网站(IP/域名)地址就进入了安装界面。

1.11安装完成

到这里程序的安装就完成了，访问/admin可以进入管理后台

2.其他问题

安装中文语言包
在SSH中执行下面命令，然后管理后台启用即可。

composer require flarum-lang/chinese-simplified
php flarum cache:clear

3.开启中文搜索

Flarum默认不支持中文搜索，我们需要对数据库进行一些设置。

提醒！以下操作需要 MySQL 5.7 及以上版本才支持！

MySQL 自 5.7 开始支持多语种文字全文索引。

3.1更改MySQL配置文件

在配置文件中的mysqld加上
ngram_token_size=2

保存后重启MySQL。