2018-01-19

Flarum

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

官网

中文站


目前服务器环境是LNMP:

CentOS 64位

lnmp

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。

安装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的过程

官方安装文档

在AMH控制面板下创建好一个站点(这里指定为A站点),并做好域名解析,确认可以正常访问

删除A站点下的所有文件

创建好一个Flarum使用的MySQL数据库和对应的用户

SSH下进入A站点根目录(cd /home/wwwroot/环境/domain/主域名/web/)

执行安装命令:composer create-project flarum/flarum . --stability=beta

配置A站点的Nginx配置文件(/home/wwwroot/环境/vhost/主域名.conf):参见官方安装文档。特别注意:location ~* \.php$下的参数以自动生成的为准,还需要删除自动生成的ErrorPage的配置信息。

重载Nginx并访问A站点,填写相关安装信息。(遇到文件读写权限问题,查看下文问题集锦)

安装Flarum中文语言包

为了便于操作,我们安装中文语言包来进行默认语言的切换。

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

SSH下进入A站点根目录

执行composer require jsthon/flarum-ext-simplified-chinese即可

访问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-版本/binexportPATH

1

2

保存修改后执行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

重载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

官方文档 适应最新版的Flarum,推荐 

中文文档 较旧,有一定参考意义

composer require jsthon/flarum-ext-simplified-chinese

你可能感兴趣的:(2018-01-19)