正文

Flarum论坛程序详细安装教程

Flarum是一款轻论坛程序,该程序安装后的论坛页面简洁轻快,样式排版也比较合理好看。关于Flarum的更多特点这里就不介绍了,可以到官网查看。

Flarum论坛程序详细安装教程Flarum论坛程序详细安装教程

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

相关链接

官网:https://flarum.org.cn/

GitHub:https://github.com/justjavac/flarum

官方文档:https://github.com/justjavac/flarum-doc/blob/master/using/installation.md

教程搭建站点为:www.diqizhang.com(随时会删除)

教程步骤

环境要求

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

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

本教程受演示服务器内存限制,只安装了 MySQL 5.6 ,中文搜索功能步骤无法提供命令执行截图。演示站点也无法搜索中文。

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

创建站点

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

删除站点目录文件

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

删除PHP禁用函数

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

putenv,pcntl_signal,proc_open

Flarum论坛程序详细安装教程Flarum论坛程序详细安装教程

安装fileinfo扩展

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

Flarum论坛程序详细安装教程Flarum论坛程序详细安装教程

确认Composer 状态

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

Flarum论坛程序详细安装教程Flarum论坛程序详细安装教程

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

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

安装Flarum

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

Flarum论坛程序详细安装教程Flarum论坛程序详细安装教程

然后使用下面命令安装Flarum

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

Flarum论坛程序详细安装教程Flarum论坛程序详细安装教程

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

Flarum论坛程序详细安装教程Flarum论坛程序详细安装教程

伪静态设置

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

Flarum论坛程序详细安装教程Flarum论坛程序详细安装教程

 

Flarum论坛程序详细安装教程Flarum论坛程序详细安装教程

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执行后会下载下来。这里就不再贴了。

更改运行目录

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

Flarum论坛程序详细安装教程Flarum论坛程序详细安装教程

更改文件夹权限

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

Flarum论坛程序详细安装教程Flarum论坛程序详细安装教程

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

Flarum论坛程序详细安装教程Flarum论坛程序详细安装教程

填写配置信息

前面步骤做完后访问网站地址就进入了安装界面。

Flarum论坛程序详细安装教程Flarum论坛程序详细安装教程

看不懂英文可以浏览器翻译,或者对照下面图片来填。

Flarum论坛程序详细安装教程Flarum论坛程序详细安装教程

安装完成

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

Flarum论坛程序详细安装教程Flarum论坛程序详细安装教程

Flarum论坛程序详细安装教程Flarum论坛程序详细安装教程

其他问题

安装中文语言包

在SSH中执行下面命令,然后管理后台启用即可。

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

Flarum论坛程序详细安装教程Flarum论坛程序详细安装教程

Flarum论坛程序详细安装教程Flarum论坛程序详细安装教程

Flarum论坛程序详细安装教程Flarum论坛程序详细安装教程

开启中文搜索

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

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

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

更改MySQL配置文件

在配置文件中的mysqld加上

ngram_token_size=2

Flarum论坛程序详细安装教程Flarum论坛程序详细安装教程

保存后重启MySQL。

重建数据库索引

这一步我们使用PHPmyadmin,没有的就在宝塔安装下。

安装后在宝塔面板数据库页面,点击管理就进入了数据库管理页面。

一般会自动登录数据库,如果没有登陆,就填入数据库账号密码登陆一下。

Flarum论坛程序详细安装教程Flarum论坛程序详细安装教程

在sql查询中执行下面的代码

USE YourFlarumDataBaseName; // 这里替换为你的 Flarum 数据库的名字
ALTER TABLE posts DROP INDEX content;
CREATE FULLTEXT INDEX content ON `posts` (`content`) WITH PARSER ngram;

Flarum论坛程序详细安装教程Flarum论坛程序详细安装教程

执行成功后,再执行下面的代码。

USE YourFlarumDataBaseName; // 这里替换为你的 Flarum 数据库的名字
ALTER TABLE discussions DROP INDEX title;
CREATE FULLTEXT INDEX title ON `discussions` (`title`) WITH PARSER ngram;

完成后等待一下,强制刷新浏览器缓存查看效果吧。

(本教程受演示服务器内存限制,只安装了 MySQL 5.6 ,中文搜索功能步骤无法提供命令执行截图。演示站点也无法搜索中文。)