Flarum 中文安装指南

释放双眼，带上耳机，听听看~！

前言

flarum
flarum 基于 PHP 构建，因此很容易安装部署。界面使用 Mithril 构建，Mithril 是一个高性能的 JavaScript 框架。更少的等待，更多的交流。
如果你不喜欢臃肿的discuz,不妨试试这个flarum
关键词：Flarum 安装, Flarum 安装教程, Flarum 中文教程, flarum 中文指南
主要内容：服务器环境要求，在线安装命令，Composer 国内源设置，URL 重写规则（Apache/Nginx/Caddy），
文件夹权限设置，自定义路径，注册邮件设置，插件问题（中文语言包）

全文编排和翻译解释: YANNIS
flarum是Beta版软件，这意味着它仍具有一些不完整的功能和BUG，并且可能会在特定时刻崩坏

动手安装前，请阅读全文，并了解智慧的提问，若有问题，请在求助中留言。| 官方英文安装文档

服务器环境要求

在您安装 Flarum 之前，请检查您的服务器是否符合以下的要求，以便顺利的安装和运行：

服务器： Apache (需支持重写 Rewire 功能) 或者 Nginx , 内存≥1G (推荐)
数据库：MySQL 5.6+ 或者 MariaDB 10.0.5+
可支持 SSH (命令行) 并运行 Composer
Flarum 8+（推荐使用 PHP 7.1+ ，目前仍有许多拓展插件不支持 PHP 7.1-）
- PHP 7.1+ ，需开启PHP扩展：fileinfo, curl, dom, gd, json, mbstring, openssl, pdo_mysql, tokenizer, exif, zip
Flarum 8- （包含 FlarumCN / FlarumChina-beta7 / FlarumOne / Flarum-CV）
- PHP 5.5+ ，需开启：exif,opcache,mbstring, pdo_mysql, openssl, json, gd, dom, fileinfo

目前，英文官方版本在此阶段 ( 不含 FlarumChina 版本和衍生版 ) ，无法通过下载压缩包 ZIP 文件并将文件上传到 Web 服务器来安装 Flarum 。因为 Flarum 使用了 Composer 管理系统进行远程下载安装，故服务器环境需要支持 Composer ，并在该系统命令行上运行 Composer 安装 Flarum。

若您的主机环境已搭配安装好 Composer，既可以主动运行，不需要另外再单独安装 Composer 。

composer (命令查看composer安装)

Flarum 基本目录结构

. （站点根目录）
├── public（公共目录）
│   └── assets （资源目录，存放头像、上传的文件等）
├── storage
│   └── logs （日志）
├── vendor （核心、插件目录）
├── .nginx.conf （自带 Nginx 配置）
├── .htaccess （自带 Apache 配置）
├── composer.json（插件列表）
├── extend.php（自定义扩展文件）
├── flarum
├── LICENSE
├── README.md
└── site.php

在线安装

Flarum 使用 Composer 来管理它的目录和扩展. 在安装 flarum 之前，您需要安装 Install Composer 在您的主机上。然后，在您需要安装 Flarum 的位置目录下运行此命令：

安装 Flarum 的位置目录需完全空白，隐藏项需删除

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

运行此命令时，可以同步后台配置 Web 服务器。需确保将您的网站运行目录设置为 /path/to/your/forum/public，然后按照相关步骤设置 URL 重写。

一切准备就绪后，请在网络浏览器中转至您的网站地址，然后按照说明填写网址信息：如网站名称、管理员信息、数据库信息来完成 Flarum 的安装。

Composer 国内源设置

如果使用 composer create-project flarum/flarum . --stability=beta 安装等待时间过长，
可切换至国内阿里源，能解决无法下载或等待时间过长问题，主机存在于国外请具体视情况而定。

全局配置（推荐）

切换阿里源：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

取消配置：composer config -g --unset repos.packagist

URL 重写规则

一般情况下，请确保运行目录是 /public 即可正常运行 Flarum，
Flarum 自带.htaccess或.nginx.conf文件，请将其添加到服务器的配置块中即可。
除非您的重定向不正确，才需要使用以下的 “URL 重写规则” 进行补全或完善，而非全部/全局覆盖替换。
403/404 通常是您重写规则设置不正确 / 权限未给予正确 / 运行目录设置不正确，
请自行阅读下面的说明和重写正确后刷新页面，清除缓存后再次查看页面
若不得不提问，请在求助标签中留言。

Apache

Flarum在 public 文件中包含一个 .htaccess 文件，此文件包含了需要用到的规则。如果您使用共享主机，请与您的提供商确认启用了 mod_rewrite 重写功能并允许使用 .htaccess 文件。如果您使用的是其他 web 服务器，您需要在配置文件中添加以下规则：

<Directory "/您/的/flarum论坛/public">
    AllowOverride All
</Directory>

Nginx

Flarum 包含一个 .nginx.conf 文件。然后，假设您在 Nginx 中创建了一个 PHP 站点，请将以下内容添加到服务器的配置块中：

 include /您/的/flarum论坛/.nginx.conf;

某些服务器商或安装设置可能不全，可按照以下内容补全

Caddy

Caddy 的配置很简单。您需要替换 URL 为您自己的地址和自己pubilc的文件目录路径来替换规则中的path。
如果您使用的是其他版本的PHP，您还需要使fastcgi路径指向正确的 PHP 安装 Socket 或 URL 。

www.example.com {
    root /var/www/flarum/public
    rewrite {
        to {path} {path}/ /index.php
    }
    fastcgi / /var/run/php/php7.2-fpm.sock php
    header /assets {
        +Cache-Control "public, must-revalidate, proxy-revalidate"
        +Cache-Control "max-age=25000"
        Pragma "public" 
    }
    gzip
}

文件夹权限设置

请不要将所有的文件夹包含更目录设置为 777，这是非常危险的一件事情。
无论任何用户或组都将允许访问文件内容，无法保证文件安全！

在安装期间，您须将某些文件夹和目录权限升至为 755 或部分 775，
Beta 8+ 分别是 public 和 storage 文件夹
Beta 8– 分别是 assets 和 storage 文件夹

若完成这些步骤，Flarum 需继续索要权限，则您可能需要检查您的文件是否正确的设置了组和用户所拥有的权限。
因为，您的环境可能与所提供的文档有所不同，需要向您的Web服务器配置或 Web 提供商咨询有关 PHP 和 Web 服务器所使用的正确用户和组的信息。

在大多数 Linux 和衍生系统中，默认情况下，www-data 是 PHP 和 Web 服务器下运行的组和用户。您可以通过运行chown -R www-data:www-data 文件夹名/.来更改大多数 Linux 操作系统中的文件夹所有权。

自定义路径

默认情况下 Flarum 的目录结构，包含公开访问的文件 public 目录。这是最好最安全的，确保所有敏感的源代码文件无法从网站根目录完全访问。

但, 如果您希望将 Flarum 安装在一个子目录中（例如 您的网站.com/forum），或者如果您的主机不让您安装在自己的网站根目录下 (受制于 public_html 或 htdocs 之类的东西），则可以进行设置没有 public 目录的 Flarum。

只需将 public 目录（包括.htaccess）中的所有文件移动到您要安装 Flarum 的目录中。然后编辑 .htaccess 并取消注释第 9 ~ 14 行用来保护敏感资源的 Code 。最后，编辑 index.php 和 Flarum 可执行文件，并更新以下行中的路径以反映您的新目录结构：

require 'vendor/autoload.php';
'base' => __自定义__,
'public' => __自定义__,
'storage' => __自定义__.'/storage',

注册邮件设置

若您的邮件设置全部正确，但是无法发送邮件或出现无法注册错误，
请重新检查邮箱的用户名和密码是否正确，或切换邮箱服务商重试，目前推荐163邮箱或域名邮箱
若不得不提问，请在求助标签中留言。

使用相关插件进行注册邮件屏蔽(需前往Flarum官网社区进行获取)，
既注册已激活状态，但不利于防范垃圾注册。
使用正常邮件注册发送，SMTP 方式，推荐使用 163 FAQ/126 邮箱等或国外邮件商。
既注册未激活状态，需邮件激活，利于防范垃圾注册。

插件

请在 Extensions 查看，或在英文官网 Extensions 查看

目前推荐可用的插件均发文在 Extensions 分类中，更多插件介绍将会在不久的将来编写进该文档中。
常用插件概览：

中文语言包

推荐：flarum 简体中文语言包 2020

安裝命令

composer require littlegolden/flarum-lang-simplified-chinese

移除

composer remove littlegolden/flarum-lang-simplified-chinese

FoF 文件上传器

Upload by FriendsOfFlarum

一个为您的论坛智能处理文件上传的扩展程序。您需要安装 PHP 扩展 exif 后方可上传图片。
前往查看扩展 | 此插件需要 PHP exif 支持，请确保已安装或开启！

前言