安装

Beta 版软件

请留意 Flarum 正处在 Beta 版软件阶段。这意味着:

  • 它还有很多没完成的功能Bug, 🐛🐞 而且
  • 某些时候 —— 可能早可能晚 —— 它甚至会崩溃! 💥

Beta 阶段关乎解决这些问题并改善 Flarum。我们正在努力使 Flarum 更好,所以我们希望你:

  • 不要在生产环境中使用它。如果出错了,我们可帮不了你。况且升级到未来的版本可能是个脏累活儿。
  • 有责任感地汇报 Bug。书写差劲的 Bug 报告需要花很多时间处理,会扰乱我们添加新功能或者使 Flarum 更稳定的进程。 在你安装前,请阅读我们的贡献规则,你将了解你注册的意义!

系统需求

注意:仅就 0.1.0-beta.3 版中,Flarum 使用 Composer 管理依存关系和扩展。这意味着 Flarum 没法在没有 SSH(命令行)连接的主机上安装。我们未来会保证 Flarum 能用其他的方法安装,使之可被所有人使用。与此同时,如果现在你希望运行 Flarum,你需要寻找允许 SSH 连接的主机。

下为运行 Flarum 所需的一些条件。

  • 网页服务器软件: Apache (需要支持 mod_rewrite),Nginx,或者Lighttpd
  • PHP 5.5+,需要开启的扩展:mbstring, pdo_mysql, openssl, json, gd, dom, fileinfo
  • MySQL 5.5+
  • SSH(命令行)连接

安装 Flarum

Flarum 使用 Composer 做为管理依存和扩展的工具。所以,在安装 Flarum 之前,你需要在你的电脑上安装 Composer。然后在 Flarum 应该安装的地方运行此命令:

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

在此命令运行时,你就可以为你的服务器配置 URL 重写了。最后,使用浏览器访问你的论坛,完成最后的安装步骤。

URL 重写

Apache

Flarum 附带了一个 Apache 的 .htaccess 文件 —— 记得正确地上传它。如果你在使用共享空间,确保你的空间提供商开启了 mod_rewrite。你也可能需要将下述加入到你的 Apache 配置中:

<Directory "/path/to/your/forum">
    AllowOverride All
</Directory>

Nginx

添加下述配置到你的服务器配置块:

    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;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param HTTP_PROXY ""; # Fix for https://httpoxy.org/ vulnerability
        fastcgi_index index.php;
    }

    location ~* \.html$ {
        expires -1;
    }

    location ~* \.(css|js|gif|jpe?g|png)$ {
        expires 1M;
        add_header Pragma public;
        add_header Cache-Control "public, must-revalidate, proxy-revalidate";
    }

    gzip on;
    gzip_http_version 1.1;
    gzip_vary on;
    gzip_comp_level 6;
    gzip_proxied any;
    gzip_types application/atom+xml
               application/javascript
               application/json
               application/vnd.ms-fontobject
               application/x-font-ttf
               application/x-web-app-manifest+json
               application/xhtml+xml
               application/xml
               font/opentype
               image/svg+xml
               image/x-icon
               text/css
               text/plain
               text/xml;
    gzip_buffers 16 8k;
    gzip_disable "MSIE [1-6]\.(?!.*SV1)";

Lighttpd

添加下述配置到你的服务器配置块:

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

故障排除

如果你在安装 Flarum 中遇到问题,记得检查支持论坛的 Installation 标签 —— 也许有人和你遇到了相同的问题!如果没有,发起讨论,我们会尽可能帮你解决。

SMTP

目前还没有配置 SMTP 的图形化界面 (#258),但您可以手动修改数据库的 config 表:

mail_driver: smtp
mail_host: ...
mail_port: ...
mail_username: ...
mail_password: ...
mail_encryption: ...

导入数据

最终我们希望可以将其他论坛的数据导入到 Flarum 中,这样你就可以放心地迁移到 Flarum 软件。 然而,在这个阶段还为时过早,我们需要先发布稳定版!

译者:@justjavac Updated by ttnl 17/1/21