Flarum论坛程序详细安装教程
Flarum是一款轻论坛程序,该程序安装后的论坛页面简洁轻快,样式排版也比较合理好看。关于Flarum的更多特点这里就不介绍了,可以到官网查看。
Flarum已经于北京时间 2021年5月27日 17:00 发布了第一个正式版。
相关链接
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
安装fileinfo扩展
程序需要使用到fileinfo这个PHP扩展,我们需要安装一下。
确认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
安装Flarum
SSH中进入站点目录:cd 目录地址
然后使用下面命令安装Flarum
composer create-project flarum/flarum . --stability=beta
安装完成后会显示如下界面:
伪静态设置
Flarum需要添加伪静态规则。规则其实就是网站目录里的.nginx.conf。这里不要使用官方文档里的伪静态,否则无法打开后台地址,报404。
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目录。
更改文件夹权限
storage文件夹权限设为777,用户组root
public/assets文件夹权限设为777,用户组root
填写配置信息
前面步骤做完后访问网站地址就进入了安装界面。
看不懂英文可以浏览器翻译,或者对照下面图片来填。
安装完成
到这里程序的安装就完成了,访问/admin可以进入管理后台。
其他问题
安装中文语言包
在SSH中执行下面命令,然后管理后台启用即可。
composer require flarum-lang/chinese-simplified php flarum cache:clear
开启中文搜索
Flarum默认不支持中文搜索,我们需要对数据库进行一些设置。
提醒!以下操作需要 MySQL 5.7 及以上版本才支持!
MySQL 自 5.7 开始支持多语种文字全文索引。
更改MySQL配置文件
在配置文件中的mysqld加上
ngram_token_size=2
保存后重启MySQL。
重建数据库索引
这一步我们使用PHPmyadmin,没有的就在宝塔安装下。
安装后在宝塔面板数据库页面,点击管理就进入了数据库管理页面。
一般会自动登录数据库,如果没有登陆,就填入数据库账号密码登陆一下。
在sql查询中执行下面的代码
USE YourFlarumDataBaseName; // 这里替换为你的 Flarum 数据库的名字 ALTER TABLE posts DROP INDEX content; CREATE FULLTEXT INDEX content ON `posts` (`content`) WITH PARSER ngram;
执行成功后,再执行下面的代码。
USE YourFlarumDataBaseName; // 这里替换为你的 Flarum 数据库的名字 ALTER TABLE discussions DROP INDEX title; CREATE FULLTEXT INDEX title ON `discussions` (`title`) WITH PARSER ngram;
完成后等待一下,强制刷新浏览器缓存查看效果吧。
(本教程受演示服务器内存限制,只安装了 MySQL 5.6 ,中文搜索功能步骤无法提供命令执行截图。演示站点也无法搜索中文。)
Discussion
New Comments
暂无评论。 成为第一个!