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和微博