Flarum部署教程

这是一款优秀漂亮的论坛程序，在这里记录一下搭建教程，以防忘记

准备环境

• Apache（启用 mod_rewrite）或Nginx
• **PHP 7.3+**，具有以下扩展：curl、dom、fileinfo、gd、json、mbstring、openssl、pdo _ mysql、tokenizer、zip
• MySQL 5.6+/8.0.23+或MariaDB 10.0.5+

配置PHP

第一步：安装PHP扩展，安装fileinfo、opcache、exif

第二步：解除禁用函数：删除putenv、pcntl_signal、proc_open

（如何不解除禁用函数会导致下面步骤中的变更源地址时报错，或者者导致安装 Flarum 时报错）

第三步：更新服务器软件包，打开 SSH 连接上服务器终端，输入yum update -y回车，结束后左下角会提示 Complete!

第四步：打开 SSH，输入cd回车，这是进入到整个服务器的根目录

第五步：安装 Composer，输入php -r "copy('https://install.phpcomposer.com/installer', 'composer-setup.php');"

第六步：运行安装脚本并且切换数据源，依次输入php composer-setup.php回车、php -r "unlink('composer-setup.php');"回车、mv composer.phar /usr/local/bin/composer回车、composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/回车

第七步：或者只输入php composer-setup.php和mv composer.phar /usr/local/bin/composer（不切换阿里源）

开始安装

第一步：设置PHP配置

最大脚本运行时间（max_execution_time）：600 

脚本内存限制（memory_limit）：512M 或 1024M

第二步：删除网站根目录内的所有文件（包括 .user.ini）

第三步：ssh进入网站根目录后，然后输入安装命令composer create-project flarum/flarum . --stability=beta

第四步：修改网站配置文件（注：如果安装网站地图插件，还需要把插件备忘中提到的那行代码加在此处的第三行）

1. root：需要在路径后面加上 public，比如原本是 root /www/wwwroot/example.com;，需要修改为 root /www/wwwroot/example.com/public;。

2. 引入 Flarum 提供的伪静态配置，在 server name 下方加上 include /www/wwwroot/example.com/.nginx.conf;，网站目录不要忘记更换成自己的。

   root /www/wwwroot/你的域名/public;   
   include /www/wwwroot/你的域名/.nginx.conf;

第五步：给程序文件赋予755权限

第六步：创建数据库，必须使用utf8mb4格式

第七步：打开域名根据引导配置安装

安装插件

第一步：ssh进入网站根目录

第二步：输入插件安装指令

例如：composer require michaelbelgium/flarum-discussion-views（显示帖子浏览量）

第三步：进入网站后台，找到插件启用即可

指令解析：

安装：composer require fof/links
更新：composer update fof/links
卸载：composer remove fof/links

require = 安装，remove = 卸载，update = 更新

fof/links 每个插件不一样，即后台点击插件源码 github 后面的那些字母，比如上面的显示帖子浏览量插件就是michaelbelgium/flarum-discussion-views