宝塔面包安装搭建Flarum开源论坛程序 文档教程

一、服务器环境说明

宝塔 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扫一扫