flarum轻论坛的搭建与使用

Flarum介绍

Flarum 是一款现代的，优雅的，简洁的，强大的论坛软件。Flarum 让在线交流变得更加轻松愉快。
作者是 Toby Zerner，一位来自澳大利亚的医学工作者，受到他哥哥的启蒙开始学习编程，他和他的哥哥 Simon带着对当时论坛软件的不满一起开发了 esoTalk.
不幸的是 simon 在 2009 年因病去世了，世界失去了一位杰出的人。
带着对哥哥的思念，Toby 在毕业前夕，制作出了 Flarum beat 版本，献给天堂的 Simon。

安装过程

系统需求

服务器： Apache (需要支持 mod_rewrite)、Nginx、Lighttpd
PHP 5.5+，需要开启的扩展：mbstring, pdo_mysql, openssl, json, gd, dom, fileinfo、MySQL 5.5+
需要注意的是，所要求的 PHP 扩展必须都装上，否则没法运行。

在线安装

下载安装包，解压，上传文件到服务器
访问域名根目录
填写网址信息：如网站名称、管理员信息、数据库信息，点击 Install Flarum 按钮

URL 重写

在安装和运行 Flarum 之前，您需要设置 URL 重写规则。Flarum 附带了一个 Apache 的 .htaccess 文件，此文件包含了需要用到的规则。如果您使用的是其他 web 服务器，您需要在配置文件中添加以下规则：

Nginx

Nginx 的配置文件目录一般在 /usr/local/nginx/conf/ 目录下，具体以实际情况为准。
在原配置的内容

    server
    {
    ........
    }

中间插入下面的规则即可。

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    
    location /api {
    try_files $uri $uri/ /api.php?$query_string;
    }
    
    location /admin {
    try_files $uri $uri/ /admin.php?$query_string;
    }
    
    location /flarum {
    deny all;
    return 404;
    }
    
    location ~ .php$ {
    fastcgi_split_path_info ^(.+.php)(/.+)$;
    fastcgi_pass unix:/var/run/php5-fpm.sock;
    fastcgi_index index.php;
    include fastcgi_params;
    }

    Lighttpd
    url.rewrite-if-not-file = (
        "/admin.*" => "/admin.php",
        "/api.*"   => "/api.php",
        "/.*"      => "/index.php"
    )

详情请查阅：官方文档

Debug 模式

在 Flarum 论坛安装完毕后，可能会出现许多奇怪的 Bug，在网站根目录下的 config.php 中将 debug=false 改成 true，即可开启 debug，找到错误原因。
config.php 文件是 Flarum 的详细配置文件。

其他

目前国内有三个 Flarum 的本地化论坛的安装包做的还不错。

分别是：

关于 Flarum 配置的详细中文文档，请点击这里

英文好的同学，请直接查阅官方文档即可。