本指南演示了如何在Ubuntu 22.04操作系统上安装和配置Flarum。

Flarum配置的基本要求

1、Apache（启用mod_rewrite）或Nginx。

2、PHP 7.3+，具有以下扩展：curl、dom、fileinfo、gd、json、mbstring、openssl、pdo_mysql、tokenizer、zip。

3、MySQL 5.6+/8.0.23+或MariaDB 10.0.5+。

4、SSH（命令行）访问以运行Composer。

在Ubuntu 22.04操作系统上安装和配置Flarum的详细步骤

第一步、在Ubuntu 22.04上安装PHP并进行配置

Flarum的需求之一是PHP 7.3及以上版本以及其他几个扩展，请在命令行中执行以下命令以安装这些软件：

sudo apt update

sudo apt install lsb-release ca-certificates apt-transport-https software-properties-common -y

sudo add-apt-repository ppa:ondrej/php

sudo apt install php8.2

sudo apt install php8.1-{bcmath,xml,fpm,mysql,zip,intl,ldap,gd,cli,bz2,curl,mbstring,pgsql,opcache,soap,cgi}

检查已安装的PHP版本：

$ php -v

PHP 8.2.6 (cli) (built: May 12 2023 06:24:00) (NTS)

Copyright (c) The PHP Group

Zend Engine v4.2.6, Copyright (c) Zend Technologies

    with Zend OPcache v8.2.6, Copyright (c), by Zend Technologies

查看已安装的扩展：

$ php -m

[PHP Modules]

calendar

Core

ctype

curl

date

dom

exif

FFI

fileinfo

filter

ftp

gd

导出您的PHP版本。例如：

export PHP=8.2

安装后，进行PHP配置，如下所示：

sudo apt install apache2 libapache2-mod-php8.2

sudo vim /etc/php/$PHP/apache2/php.ini

对文件进行以下调整：

memory_limit = 256M

max_execution_time = 300

upload_max_filesize = 150M

allow_url_fopen = On

file_uploads = On

保存文件并退出。

第二步、在Ubuntu 22.04上安装PHP Composer

PHP composer用于安装Flarum。我们需要确保它安装在Ubuntu 22.04上：

wget -O composer-setup.php https://getcomposer.org/installer

运行全局安装：

sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer

样本输出：

All settings correct for using Composer

Downloading...

Composer (version 2.5.5) successfully installed to: /usr/local/bin/composer

Use it: php /usr/local/bin/composer

验证安装：

$ composer -V

Composer version 2.5.5 2023-03-21 11:50:05

第三步、在Ubuntu 22.04上安装MariaDB

对于本指南，我们将使用MariaDB作为数据库服务器：

sudo apt install mariadb-server

安装后，为Flarum创建一个数据库。访问MariaDB shell：

sudo mariadb -u root

现在创建数据库和用户：

CREATE DATABASE flarum_db;

CREATE USER 'flarum_user'@'localhost' IDENTIFIED BY 'StrongDBPassw0rd';

GRANT ALL PRIVILEGES ON flarum_db.* TO 'flarum_user'@'localhost';

FLUSH PRIVILEGES;

EXIT

第四步、在Ubuntu 22.04上安装Flarum

在Apache web根目录中为Flarum On Ubuntu 22.04创建一个工作目录：

sudo mkdir /var/www/html/flarum

导航到创建的目录：

cd /var/www/html/flarum

使用Composer下载最新的Flarum版本：

sudo composer create-project flarum/flarum .

按如下所示进行操作，以下是输出信息：

Continue as root/super user [yes]? yes

Creating a "flarum/flarum" project at "./"

Info from https://repo.packagist.org: #StandWithUkraine

Installing flarum/flarum (v1.7.0)

  - Installing flarum/tags (v1.7.1): Extracting archive

64 package suggestions were added by new dependencies, use `composer suggest` to see details.

Package swiftmailer/swiftmailer is abandoned, you should avoid using it. Use symfony/mailer instead.

Generating autoload files

73 packages you are using are looking for funding.

Use the `composer fund` command to find out more!

No security vulnerability advisories found

将目录的所有权设置为www-data，并分配所需的权限：

sudo chown -R www-data:www-data /var/www/html/flarum/

sudo chmod -R 755 /var/www/html/flarum/

第五步、为Flarum配置Apache

我们想配置Apache来提供Flarum。要执行此操作，请创建一个虚拟主机文件，如图所示：

sudo vim /etc/apache2/sites-available/flarum.conf

在文件中，添加以下行：

<VirtualHost *:80>

 DocumentRoot /var/www/html/flarum/public

 ServerName flarum.computingforgeeks.com

 DirectoryIndex index.php

 <Directory /var/www/html/flarum/public/>

Options +FollowSymLinks

AllowOverride All

Order allow,deny

allow from all

 </Directory>

 ErrorLog ${APACHE_LOG_DIR}/flarum-error.log

 CustomLog ${APACHE_LOG_DIR}/flarum-access.log combined

</VirtualHost>

保存文件并启用网站：

sudo a2ensite flarum

现在为Apache启用重写模块：

sudo a2enmod rewrite

重新启动服务：

sudo systemctl restart apache2

如果您启用了防火墙，请允许HTTP和HTTPS通过它：

sudo ufw allow 80/tcp

sudo ufw allow 443/tcp

第六步、访问Web UI并完成安装

我们现在可以访问Flarum web UI并完成安装。要访问页面，请使用URL，地址格式为http://domain_name：

在上面的页面上，提供数据库名称、用户名和密码。您还需要创建管理员用户。填写完毕后，单击安装按钮，您将被重定向到下面的页面：

另外，要提一下，用户也可以按自己的实际需要，配置SSL证书，以能够使用https地址访问Flarum：

至此，在Ubuntu 22.04操作系统上安装和配置Flarum全部完成。