一、服务器环境说明
宝塔 7.0.3 或更新版本
Linux Server(本文用的是 CentOs 7.4.6 64位)
Apache 或者 Nginx(本文用的是 Nginx 1.16.0)
MySQL 5.6+(本文使用 MySQL 5.7,原因请看下方引用)
PHP 7.1+(本文 PHP-7.3)
phpMyAdmin 4.7
MySQL 自 5.7 开始支持 FULLTEXT 中文搜索,后续方便我们优化 Flarum 论坛的中文关键词搜索。
【安装扩展】,安装 fileinfo(opcache、exif 非必选)
二、安装 Composer
2.1 更新服务器软件包
使用 SSH 执行下方命令:
yum update -y
更新完左下角会提示 “ Complete! ”
2.2 解除 PHP 函数禁用
宝塔面板默认禁用一些安装 Composer 要用到的 3 个函数 putenv() 、 pcntl_signal() 、 proc_open(),我们需要解除禁用,否则导致步骤 4.3 Composer 变更源地址时报错、步骤 5.3 Composer 安装 Flarum 时报错。
2.3 安装 Composer
使用 SSH 依次执行以下命令:
# (此步骤可省略)进入当前用户家目录
cd
# 将安装脚本下载到当前目录
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
# 运行安装脚本
php composer-setup.php --install-dir=bin --filename=composer
# 删除安装脚本
php -r "unlink('composer-setup.php');"
由于 Composer 的服务器在国外,可能导致下载 Flarum 已经依赖包会很慢,所以我们需要更换一下源地址。至于 Composer 是啥,其实就是 PHP 的一个包管理,类似 Java 的 Maven 和 Gradle 工具。
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
三、安装 Flarum
3.0 设置设置PHP配置文件:
最大脚本运行时间(max_execution_time):600
脚本内存限制(memory_limit):512M 或 1024M
3.1 新建存放 Flarum 的网站
前往宝塔面板 – 【网站】 – 【添加站点】,同时创建用于 Flarum 的数据库。最后提交。数据库字符集一定要是 utf8mb4
3.2 配置完成后,请注意开启 “ 强制 HTTPS ”!否则在 6.2 步骤中无法正常访问网站
在 SSH 中执行:# 解除 .user.ini 的文件锁定,否则该文件无法被删除
chattr -i .user.ini
3.3 composer create-project flarum/flarum .
执行成功后会下载 Flarum 并更新依赖包。更新依赖包会根据服务器地理位置花费 十几秒 至 三十分钟 不等的时间,请耐心等待。
Flarum 以及对应的依赖安装完成应该是这个样子的:
四、配置运行
4.1 修改 Nginx 配置
进入宝塔面板,打开站点设置,修改网站配置文件:(可对照下图修改)
root:需要在路径后面加上 public,比如原本是 root /www/wwwroot/example.com;,需要修改为 root /www/wwwroot/example.com/public;。
引入 Flarum 提供的伪静态配置,在 server name 下方加上 include /www/wwwroot/example.com/.nginx.conf;,网站目录不要忘记更换成自己的。
五、Flarum 安装引导
在浏览器中访问安装 Flarum 的站点网址。
可以看到出现下面的情况:
这是因为没有给予网站目录写入的权限,我们加一下权限即可:
安装完成后会发现不支持中文,所以我们需要安装中文语言包。还有一些常用的插件
Flarum开源论坛安装搭建、二次开发 QQ扫一扫