Flarum est un logiciel de forum de nouvelle génération gratuit et open source qui rend la discussion en ligne amusante. Le code source de Flarum est hébergé sur Github . Il est conçu pour être rapide, simple, réactif et extensible.
Ce guide vous guidera à travers le processus d'installation de Flarum sur une nouvelle instance de FreeBSD 12.0 Vultr utilisant PHP, MariaDB comme base de données et Nginx comme serveur Web.
Exigences
Avant d'installer Flarum, il est important de vérifier que votre serveur répond aux exigences. Pour exécuter Flarum, vous aurez besoin de:
- Apache (avec
mod_rewrite
activé) ou Nginx. Ce guide utilisera Nginx.
- PHP version 7.1 ou plus avec les extensions PHP suivantes:
dom
, gd
, JSON
, mbstring
, OpenSSL
, pdo_mysql
, tokenizer
.
- MySQL version 5.6 ou supérieure ou MariaDB version 10.0.5 ou supérieure. Ce guide utilisera MariaDB.
Avant que tu commences
Vérifiez la version de FreeBSD.
uname -ro
# FreeBSD 12.0-RELEASE-p6
Assurez-vous que votre système FreeBSD est à jour.
freebsd-update fetch install
pkg update && pkg upgrade -y
Installez les packages nécessaires.
pkg install -y sudo vim unzip curl wget bash socat git
Créez un nouveau compte utilisateur avec votre nom d'utilisateur préféré. Nous utiliserons 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!
Exécutez la visudo
commande et décommentez la %wheel ALL=(ALL) ALL
ligne pour permettre aux membres du wheel
groupe d'exécuter n'importe quelle commande.
visudo
# Uncomment by removing hash (#) sign
# %wheel ALL=(ALL) ALL
Maintenant, passez à votre nouvel utilisateur avec su
.
su - johndoe
REMARQUE: remplacez johndoe
par votre nom d'utilisateur.
Configurez le fuseau horaire.
sudo tzsetup
Installer PHP
Installez PHP, ainsi que les extensions PHP nécessaires.
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
Vérifiez la version.
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
Lien logiciel php.ini-production
vers php.ini
.
sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini
Activez et démarrez PHP-FPM.
sudo sysrc php_fpm_enable=yes
sudo service php-fpm start
Installer MariaDB
Installez MariaDB.
sudo pkg install -y mariadb102-client mariadb102-server
Vérifiez la version.
mysql --version
# mysql Ver 15.1 Distrib 10.2.25-MariaDB, for FreeBSD12.0 (amd64) using readline 5.1
Démarrez et activez MariaDB.
sudo sysrc mysql_enable="yes"
sudo service mysql-server start
Exécutez le mysql_secure_installation
script pour améliorer la sécurité de votre installation MariaDB.
sudo mysql_secure_installation
Connectez-vous à MariaDB en tant qu'utilisateur root.
mysql -u root -p
# Enter password:
Créez une nouvelle base de données et un nouvel utilisateur MariaDB. N'oubliez pas les informations d'identification de ce nouvel utilisateur.
CREATE DATABASE dbname;
GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
FLUSH PRIVILEGES;
exit;
REMARQUE: remplacez dbname
et username
par des noms appropriés pour votre configuration. Remplacez-le password
par un mot de passe fort.
Installer Nginx
Installez Nginx.
sudo pkg install -y nginx
Vérifiez la version.
nginx -v
# nginx version: nginx/1.16.0
Activez et démarrez Nginx.
sudo sysrc nginx_enable=yes
sudo service nginx start
Configurez Nginx pour Flarum. Exécutez sudo vim /usr/local/etc/nginx/flarum.conf
et remplissez le fichier avec la configuration suivante.
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;
}
}
Enregistrez le fichier et quittez avec :+ W+ Q.
Maintenant, nous devons inclure flarum.conf
dans le nginx.conf
fichier principal .
Exécutez sudo vim /usr/local/etc/nginx/nginx.conf
et ajoutez la ligne suivante au http {}
bloc.
include flarum.conf;
Testez la configuration.
sudo nginx -t
Recharger Nginx.
sudo service nginx reload
Installer Composer
Téléchargez et installez Composer, le gestionnaire de dépendances pour 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
Vérifiez la version.
composer --version
# Composer version 1.9.0 2019-08-02 20:55:32
Installer Flarum
REMARQUE: Flarum est actuellement en phase bêta. Il n'est pas recommandé de l'exécuter en production pour l'instant, sauf si vous savez ce que vous faites. Vous devez attendre une version stable pour une utilisation en production.
Créez un répertoire racine de document.
sudo mkdir -p /usr/local/www/flarum
Changez la propriété du /usr/local/www/flarum
répertoire en johndoe
.
sudo chown -R johndoe:johndoe /usr/local/www/flarum
Accédez au dossier racine du document.
cd /usr/local/www/flarum
Téléchargez la dernière version de Flarum via composer
.
composer create-project flarum/flarum . --stability=beta
REMARQUE: vous risquez de manquer de mémoire lors de l'installation de Flarum via Composer. Si cela se produit, vous devrez configurer Swap .
Changez la propriété du /usr/local/www/flarum
répertoire en www
.
sudo chown -R www:www /usr/local/www/flarum
Ouvrez votre site dans un navigateur Web et suivez les instructions à l'écran pour terminer l'installation.