AMH 5.X下安装 Flarum

若是移动端访问不佳，请尝试–>Github版

背景

最近无心间发现几个开源软件的Bug反馈系统使用的是Flarum，Flarum是一款优雅简洁论坛软件，看起来仍是至关不错的，一时抑制不住想要尝试一下。

因为服务器使用的是AMH集成环境，它相对于一般的直接安装环境有不少的区别，这致使安装过程当中产生里很多问题。这里作个总结。

Flarum

Flarum 是一款优雅简洁论坛软件，让在线交流变得更加轻松愉快。

• 官网
• 中文站

AMH

AMH 是国内首个开源的主机面板，AMH 支持用户自由弹性组建运行环境与切换环境，您能够下载安装不一样版本的WEB服务器、数据库、脚本软件自由组合建立您须要的运行环境。

我使用的是AMH5.X的付费版本，4.X的免费版本也能够参考本教程。

目前服务器环境是LNMP：

CentOS-6.6 64位

lnmp-2.5

mysql-generic-5.5.40

nginx-generic-1.6.0

php-7.0

Composer

Composer是 PHP 用来管理依赖（dependency）关系的工具。你能够在本身的项目中声明所依赖的外部工具库（libraries），Composer 会帮你安装这些依赖的库文件。

• 官网
• 中文站

Composer是安装Flarum的必要工具。

安装PHP扩展

这里须要安装Flarum所须要的必要的PHP扩展，先看下系统需求：

Flarum 系统需求

服务器： Apache (须要支持 mod_rewrite)、Nginx、Lighttpd
PHP 5.5+，须要开启的扩展：mbstring, pdo_mysql, openssl, json, gd, dom, fileinfo
MySQL 5.5+

**特别注意：**PHP是5.5+、MySQL 5.5+，若是版本太低可使用AMH安装更高版本，AMH支持多版本PHP和MySQL。

流程：

1. 登陆到AMH的管理面板
2. 软件下载 > fileinfo-1.0 > 下载并安装到对应的环境
3. 软件下载 > mcrypt-1.0 > 下载并安装到对应的环境
4. 软件下载 > pdo_mysql-1.0 > 下载并安装到对应的环境

安装Composer

Flarum官网的文档要求使用Composer命令行的方式进行安装，因此须要先安装Composer：

使用SSH方式登陆服务器以后：执行

curl -sS https://getcomposer.org/installer | php

注意： 若是上述方法因为某些缘由失败了，你还能够经过 php >下载安装器：

php -r "readfile('https://getcomposer.org/installer');" | php

这里你可能会遇到 -bash php command not found的错误提示，请参考下文的问题集锦 。

PS：安装Composer文档

安装Flarum

环境搭建好了，这里讲解安装Flarum的过程

官方安装文档

1. 在AMH控制面板下建立好一个站点（这里指定为A站点），并作好域名解析，确承认以正常访问
2. 删除A站点下的全部文件
3. 建立好一个Flarum使用的MySQL数据库和对应的用户
4. SSH下进入A站点根目录（cd /home/wwwroot/环境/domain/主域名/web/）
5. 执行安装命令：composer create-project flarum/flarum . --stability=beta
6. 配置A站点的Nginx配置文件（/home/wwwroot/环境/vhost/主域名.conf）：参见官方安装文档。特别注意：location ~* \.php$下的参数以自动生成的为准，还须要删除自动生成的ErrorPage的配置信息。
7. 重载Nginx并访问A站点，填写相关安装信息。（遇到文件读写权限问题，查看下文问题集锦）

安装Flarum中文语言包

为了便于操做，咱们安装中文语言包来进行默认语言的切换。

尝试了几种安装方式，这里推荐使用命令行安装：

1. SSH下进入A站点根目录
2. 执行composer require jsthon/flarum-ext-simplified-chinese便可
3. 访问A站点，进入后台修改勾选中文扩展，并修改默认语言。

其余语言和扩展：https://discuss.flarum.org/d/1534-extension-list

问题集锦

可能遇到的问题：

-bash php command not found

Composer的安装和使用是使用的php-cli的方式，AMH支持多版本的PHP，环境变量里并未指定php-cli的版本，这里须要咱们把指定版本的PHP加入到环境变量里。

在~/.bash_profile里加入：

PATH=$PATH:/usr/local/php-版本/bin
export PATH

保存修改后执行source ~/.bash_profile使得修改生效。

PS：若是你使用的是其余发行版的Linux，请自行搜索如何设置PHP加入到环境变量 。

requires ext-fileinfo * 或者 request for intervention/image

参见：

• http://stackoverflow.com/questions/24850136/i-have-ext-fileinfo-but-composer-says-it-is-missing
• http://amh.sh/bbs/post-6149-1-1.htm

简单来讲，就是我们在AMH里安装的PHP扩展并无影响到php-cli方式运行PHP的配置，须要咱们手动同步一下配置：

cp /home/wwwroot/环境/etc/amh-php.ini /usr/local/php-版本/etc/php.ini

重载Nginx便可生效。

Please chmod this directory to 0775

当你访问经过composer安装好的A站点时，遇到里相似的权限读写问题，对于AMH环境，咱们须要执行：

sudo chown www:www -R /home/wwwroot/环境/domain/主域名/web

这里有一些讨论：

• https://discuss.flarum.org/d/823-directorys-are-not-writable/46
• https://discuss.flarum.org/d/2209-directory-not-writable/3

上面的讨论使用的用户组和AMH的不同，AMH网站的用户组是www，结合实际状况才能真正解决问题。

其余

查看咱们的成果：Cafeting的论坛

官方文档 适应最新版的Flarum，推荐
中文文档 较旧，有必定参考意义

AMH集成环境相对于一般的直接安装环境有不少的区别，使用的时候务必要考虑到。

若是有什么问题，能够在博客下留言或者经过下面的方式联系我:

你能够关注的我Github、CSDN和微博