Flarum è un software di forum di prossima generazione gratuito e open source che rende divertente la discussione online. Il codice sorgente di Flarum è ospitato su Github . È progettato per essere veloce, semplice, reattivo ed estensibile.
Questa guida ti guiderà attraverso il processo di installazione di Flarum su una nuova istanza di FreeBSD 12.0 Vultr usando PHP, MariaDB come database e Nginx come web server.
Requisiti
Prima di installare Flarum, è importante verificare che il server soddisfi i requisiti. Per eseguire Flarum, avrai bisogno di:
- Apache (con
mod_rewrite
abilitato) o Nginx. Questa guida utilizzerà Nginx.
- PHP versione 7.1 o superiore con le seguenti estensioni PHP:
dom
, gd
, JSON
, mbstring
, OpenSSL
, pdo_mysql
, tokenizer
.
- MySQL versione 5.6 o successiva o MariaDB versione 10.0.5 o successiva. Questa guida utilizzerà MariaDB.
Prima di iniziare
Controlla la versione di FreeBSD.
uname -ro
# FreeBSD 12.0-RELEASE-p6
Assicurati che il tuo sistema FreeBSD sia aggiornato.
freebsd-update fetch install
pkg update && pkg upgrade -y
Installa i pacchetti necessari.
pkg install -y sudo vim unzip curl wget bash socat git
Crea un nuovo account utente con il tuo nome utente preferito. Useremo johndoe
.
adduser
# Username: johndoe
# Full name: John Doe
# Uid (Leave empty for default): <Enter>
# Login group [johndoe]: <Enter>
# Login group is johndoe. Invite johndoe into other groups? []: wheel
# Login class [default]: <Enter>
# Shell (sh csh tcsh nologin) [sh]: bash
# Home directory [/home/johndoe]: <Enter>
# Home directory permissions (Leave empty for default): <Enter>
# Use password-based authentication? [yes]: <Enter>
# Use an empty password? (yes/no) [no]: <Enter>
# Use a random password? (yes/no) [no]: <Enter>
# Enter password: your_secure_password
# Enter password again: your_secure_password
# Lock out the account after creation? [no]: <Enter>
# OK? (yes/no): yes
# Add another user? (yes/no): no
# Goodbye!
Esegui il visudo
comando e decommenta la %wheel ALL=(ALL) ALL
riga per consentire ai membri del wheel
gruppo di eseguire qualsiasi comando.
visudo
# Uncomment by removing hash (#) sign
# %wheel ALL=(ALL) ALL
Ora passa al nuovo utente creato con su
.
su - johndoe
NOTA: sostituisci johndoe
con il tuo nome utente.
Imposta il fuso orario.
sudo tzsetup
Installa PHP
Installa PHP e le estensioni PHP necessarie.
sudo pkg install -y php72 php72-mbstring php72-tokenizer php72-pdo php72-pdo_mysql php72-openssl php72-hash php72-json php72-phar php72-filter php72-zlib php72-dom php72-xml php72-xmlwriter php72-xmlreader php72-curl php72-session php72-ctype php72-iconv php72-gd php72-simplexml php72-zip php72-filter php72-tokenizer php72-calendar php72-fileinfo php72-intl php72-phar php72-soap php72-xmlrpc
Controlla la versione
php --version
# PHP 7.2.21 (cli) (built: Aug 4 2019 01:12:37) ( NTS )
# Copyright (c) 1997-2018 The PHP Group
# Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
Soft-link php.ini-production
a php.ini
.
sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini
Abilita e avvia PHP-FPM.
sudo sysrc php_fpm_enable=yes
sudo service php-fpm start
Installa MariaDB
Installa MariaDB.
sudo pkg install -y mariadb102-client mariadb102-server
Controlla la versione
mysql --version
# mysql Ver 15.1 Distrib 10.2.25-MariaDB, for FreeBSD12.0 (amd64) using readline 5.1
Avviare e abilitare MariaDB.
sudo sysrc mysql_enable="yes"
sudo service mysql-server start
Esegui lo mysql_secure_installation
script per migliorare la sicurezza dell'installazione di MariaDB.
sudo mysql_secure_installation
Accedi a MariaDB come utente root.
mysql -u root -p
# Enter password:
Creare un nuovo database e utente MariaDB. Ricorda le credenziali per questo nuovo utente.
CREATE DATABASE dbname;
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
exit;
NOTA: sostituire dbname
e username
con nomi appropriati per la configurazione. Sostituisci password
con una password complessa.
Installa Nginx
Installa Nginx.
sudo pkg install -y nginx
Controlla la versione
nginx -v
# nginx version: nginx/1.16.0
Abilita e avvia Nginx.
sudo sysrc nginx_enable=yes
sudo service nginx start
Configura Nginx per Flarum. Esegui sudo vim /usr/local/etc/nginx/flarum.conf
e popola il file con la seguente configurazione.
server {
listen [::]:80;
listen 80;
server_name example.com;
root /usr/local/www/flarum/public;
index index.php;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~* \.php$ {
fastcgi_pass 127.0.0.1:9000;
include fastcgi_params;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
}
Salvare il file e uscire con :+ W+ Q.
Ora dobbiamo includere flarum.conf
nel nginx.conf
file principale .
Esegui sudo vim /usr/local/etc/nginx/nginx.conf
e aggiungi la seguente riga al http {}
blocco.
include flarum.conf;
Prova la configurazione.
sudo nginx -t
Ricarica Nginx.
sudo service nginx reload
Installa Composer
Scarica e installa Composer, il gestore delle dipendenze per PHP.
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === 'a5c698ffe4b8e849a443b120cd5ba38043260d5c4023dbf93e1558871f1f07f58274fc6f4c93bcfd858c6bd0775cd8d1') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer
Controlla la versione
composer --version
# Composer version 1.9.0 2019-08-02 20:55:32
Installa Flarum
NOTA: Flarum è attualmente in fase beta. Non è consigliabile eseguirlo ancora in produzione a meno che non si sappia cosa si sta facendo. È necessario attendere il rilascio stabile per l'utilizzo in produzione.
Creare una directory radice del documento.
sudo mkdir -p /usr/local/www/flarum
Cambia la proprietà della /usr/local/www/flarum
directory in johndoe
.
sudo chown -R johndoe:johndoe /usr/local/www/flarum
Passare alla cartella principale del documento.
cd /usr/local/www/flarum
Scarica l'ultima versione di Flarum tramite composer
.
composer create-project flarum/flarum . --stability=beta
NOTA: è possibile che la memoria si esaurisca durante l'installazione di Flarum tramite Composer. In tal caso, dovrai impostare Scambia .
Cambia la proprietà della /usr/local/www/flarum
directory in www
.
sudo chown -R www:www /usr/local/www/flarum
Apri il tuo sito in un browser Web e segui le istruzioni sullo schermo per completare l'installazione.