安装

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 应该安装的地方运行此命令：

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

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

URL 重写

Apache

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

  1. <Directory "/path/to/your/forum">
  2.     AllowOverride All
  3. </Directory>

Nginx

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

  1.     location / { try_files $uri $uri/ /index.php?$query_string; }
  2.     location /api { try_files $uri $uri/ /api.php?$query_string; }
  3.     location /admin { try_files $uri $uri/ /admin.php?$query_string; }
  5.     location /flarum {
  6.         deny all;
  7.         return 404;
  8.     }
  10.     location ~* \.php$ {
  11.         fastcgi_split_path_info ^(.+.php)(/.+)$;
  12.         fastcgi_pass unix:/var/run/php5-fpm.sock;
  13.         include fastcgi_params;
  14.         fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
  15.         fastcgi_param HTTP_PROXY ""; # Fix for https://httpoxy.org/ vulnerability
  16.         fastcgi_index index.php;
  17.     }
  19.     location ~* \.html$ {
  20.         expires -1;
  21.     }
  23.     location ~* \.(css|js|gif|jpe?g|png)$ {
  24.         expires 1M;
  25.         add_header Pragma public;
  26.         add_header Cache-Control "public, must-revalidate, proxy-revalidate";
  27.     }
  29.     gzip on;
  30.     gzip_http_version 1.1;
  31.     gzip_vary on;
  32.     gzip_comp_level 6;
  33.     gzip_proxied any;
  34.     gzip_types application/atom+xml
  35.                application/javascript
  36.                application/json
  37.                application/vnd.ms-fontobject
  38.                application/x-font-ttf
  39.                application/x-web-app-manifest+json
  40.                application/xhtml+xml
  41.                application/xml
  42.                font/opentype
  43.                image/svg+xml
  44.                image/x-icon
  45.                text/css
  46.                text/plain
  47.                text/xml;
  48.     gzip_buffers 16 8k;
  49.     gzip_disable "MSIE [1-6]\.(?!.*SV1)";

Lighttpd

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

  1. url.rewrite-if-not-file = (
  2.     "/admin.*" => "/admin.php",
  3.     "/api.*"   => "/api.php",
  4.     "/.*"      => "/index.php"
  5. )

故障排除

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

SMTP

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

  1. mail_driver: smtp
  2. mail_host: ...
  3. mail_port: ...
  4. mail_username: ...
  5. mail_password: ...
  6. mail_encryption: ...

导入数据

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

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