HowtoForge

Tutoriels Linux

Comment installer Vanilla Forum sur Ubuntu 18.04 LTS

Vanilla est un forum de discussion gratuit et open source écrit en PHP. Le logiciel Vanilla Forum est distribué sous la licence GNU GPL2. Son code source est disponible sur Github. Il possède un riche système de modules complémentaires dont tu peux profiter pour ajouter des fonctionnalités personnalisées à ton forum Vanilla. Lecontenu de Vanilla Forum peut être écrit à l’aide du langage Markdown.Dans ce tutoriel, nous allons passer en revue l’installation et la configuration de Vanilla Forum sur Ubuntu 18.04 LTS en utilisant Nginx comme serveur Web, MySQL comme serveur de base de données et, en option, tu peux sécuriser la couche de transport en utilisant le client acme.sh et l’autorité de certification Let’s Encrypt pour ajouter la prise en charge de SSL.

Exigences

Vanilla nécessite un serveur avec PHP, MySQL et un logiciel de serveur Web (comme Apache ou Nginx). Tu devras probablement posséder un domaine et l’avoir déjà configuré sur ton serveur avec les DNS si tu veux l’installer sur un serveur de production, mais sinon, tu n’as pas besoin de domaine.

Les exigences minimalesdeVanilla Forumsont les suivantes :

  • PHP version 7.0 ou plus récente.
  • Extensions PHP mbstring, cURL, GD, et PDO,MySQLi, OpenSSL.
  • MySQL version 5.0 ou plus récente (ou équivalent Percona/MariaDB).
  • Logiciel de serveur Web (Nginx, Apache …).
  • Mode strict de MySQL désactivé.

Vanilla Forum recommandefortement:

  • PHP version 7.2 ou plus récente.
  • Les extensions PHP mbstring, cURL, GD, et PDO,MySQLi, OpenSSL.
  • MySQL version 5.7 ou plus récente(ou équivalent Percona/MariaDB).
  • Logiciel de serveur Web (Nginx, Apache …).
  • Cryptage SSL.

REMARQUE:PHP 7.0 a atteint sa fin de vie et ne recevra plus de correctifs de sécurité, il est donc fortement recommandé d’utiliser des versions PHP plus récentes.Laprise en charge de PHP 7.0 par Vanilla prendra bientôt fin !Ubuntu 18.04 LTS est livré avec PHP 7.2 par défaut, et nous n’avons donc pas à nous soucier de la version de PHP.

Conditions préalables

  • Un système d’exploitation exécutant Ubuntu 18.04 LTS.
  • Un utilisateur non-root avec des privilèges sudo.

Premières étapes

Vérifie ta version d’Ubuntu :

lsb_release -ds
# Ubuntu 18.04.1 LTS

Configure le fuseau horaire :

sudo dpkg-reconfigure tzdata

Mets à jour les paquets (logiciels) de ton système d’exploitation. C’est une première étape importante car elle permet de s’assurer que tu disposes des dernières mises à jour et des derniers correctifs de sécurité pour les paquets logiciels par défaut de ton système d’exploitation :

sudo apt update && sudo apt upgrade -y

Installe certains paquets essentiels qui sont nécessaires à l’administration de base du système d’exploitation Ubuntu :

sudo apt install -y curl wget vim git unzip socat bash-completion

Étape 1 – Installer PHP et les extensions PHP nécessaires

Installe PHP, ainsi que les extensions PHP nécessaires :

sudo apt install -y php7.2 php7.2-cli php7.2-fpm php7.2-common php7.2-mbstring php7.2-curl php7.2-gd php7.2-mysql

Pour afficher PHP compilé en modules, tu peux exécuter :

php -m

ctype
curl
exif
fileinfo
. . .
. . .

Vérifier la version de PHP :

php --version

# PHP 7.2.10-0ubuntu0.18.04.1 (cli) (built: Sep 13 2018 13:45:02) ( NTS )
# Copyright (c) 1997-2018 The PHP Group
# Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
#     with Zend OPcache v7.2.10-0ubuntu0.18.04.1, Copyright (c) 1999-2018, by Zend Technologies

Le service PHP-FPM est automatiquement lancé et activé au redémarrage sur le système Ubuntu 18.04, il n’est donc pas nécessaire de le lancer et de l’activer manuellement. Nous pouvons passer à l’étape suivante, qui est l’installation et la configuration de la base de données.

Étape 2 – Installe MySQL et crée une base de données pour Vanilla Forum

Vanilla Forum prend en charge les bases de données MySQL, MariaDB et Percona. Dans ce tutoriel, nous utiliserons MySQL comme serveur de base de données.

Installe le serveur de base de données MySQL :

sudo apt install -y mysql-server

Vérifie la version de MySQL :

mysql --version
# mysql  Ver 14.14 Distrib 5.7.24, for Linux (x86_64) using  EditLine wrapper

Exécutemysql_secure installationscript pour améliorer la sécurité de MySQL et définir le mot de passe pour MySQLroot utilisateur :

sudo mysql_secure_installation

Réponds à chacune des questions :

Would you like to setup VALIDATE PASSWORD plugin? N
New password: your_secure_password
Re-enter new password: your_secure_password
Remove anonymous users? [Y/n] Y
Disallow root login remotely? [Y/n] Y
Remove test database and access to it? [Y/n] Y
Reload privilege tables now? [Y/n] Y

Connecte-toi au shell MySQL en tant qu'utilisateur root :

sudo mysql -u root -p
# Enter password

Crée une base de données MySQL vide et un utilisateur pour Vanilla Forum et mémorise les informations d'identification :

mysql> CREATE DATABASE dbname;
mysql> GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
mysql> FLUSH PRIVILEGES;

Quitte MySQL :

mysql> exit

Remplacedbname,usernameetpasswordpar tes propres noms.

Étape 3 - Installe le clientacme.shet obtiens le certificat Let's Encrypt (facultatif)

Il n'est pas nécessaire de sécuriser ton site Web avec HTTPS, mais c'est une bonne pratique pour sécuriser le trafic de ton site. Pour obtenir le certificat TLS de Let's Encrypt, nous allons utiliser le client acme.sh. Acme.sh est un logiciel shell unix pur pour obtenir des certificats TLS de Let's Encrypt sans aucune dépendance.

Télécharge et installe acme.sh :

sudo su - root
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh 
./acme.sh --install --accountemail [email protected]
source ~/.bashrc
cd ~

Vérifie la version d'acme.sh :

acme.sh --version
# v2.8.0

Obtiens des certificatsRSAetECC/ECDSApour ton domaine/nom d'hôte :

# RSA 2048
acme.sh --issue --standalone -d example.com --keylength 2048
# ECDSA
acme.sh --issue --standalone -d example.com --keylength ec-256

Si tu veux des faux certificats pour les tester, tu peux ajouter --stagingflage aux commandes ci-dessus.

Après avoir exécuté les commandes ci-dessus, tescertificats et tesclés seront dans :

  • PourRSA:/home/username/example.comrépertoire.
  • PourECC/ECDSA:/home/username/example.com_eccrépertoire.

Pour répertorier tes certs émis, tu peux exécuter :

acme.sh --list

Crée un répertoire pour stocker tes certs. Nous utiliserons lerépertoire/etc/letsencrypt.

mkdir -p /etc/letsecnrypt/example.com
sudo mkdir -p /etc/letsencrypt/example.com_ecc

Installe/copie les certificats dans/etc/letsencryptrépertoire.

# RSA
acme.sh --install-cert -d example.com \ 
        --cert-file /etc/letsencrypt/example.com/cert.pem \
        --key-file /etc/letsencrypt/example.com/private.key \
        --fullchain-file /etc/letsencrypt/example.com/fullchain.pem \
        --reloadcmd "sudo systemctl reload nginx.service"

# ECC/ECDSA
acme.sh --install-cert -d example.com --ecc \
        --cert-file /etc/letsencrypt/example.com_ecc/cert.pem \
        --key-file /etc/letsencrypt/example.com_ecc/private.key \
        --fullchain-file /etc/letsencrypt/example.com_ecc/fullchain.pem \
        --reloadcmd "sudo systemctl reload nginx.service"

Tous les certificats seront automatiquement renouvelés tous les 60 jours.

Après avoir obtenu les certificats, quitte l'utilisateur root et retourne à l'utilisateur normal sudo :

exit

Étape 4 - Installer NGINX et configurer NGINX pour Vanilla Forum

Vanilla Forum peut fonctionner correctement avec de nombreux logiciels de serveur Web populaires. Dans ce tutoriel, nous avons choisi Nginx. Si tu préfères le serveur Web Apache à Nginx, visite le sitehttps://docs.vanillaforums.com/developer/backend/server-apache/ pour en savoir plus.

Télécharge et installe Nginx depuis le dépôt Ubuntu :

sudo apt install -y nginx

Vérifie la version de Nginx :

sudo nginx -v
# nginx version: nginx/1.14.0 (Ubuntu)

Configure Nginx pour Vanilla en exécutant :

sudo vim /etc/nginx/sites-available/vanilla.conf

Et remplis le fichier avec la configuration suivante :

server {

  listen 80;
  listen 443 ssl http2;
  server_name forum.example.com;
  root /var/www/vanilla;
  index index.php;

  # RSA
  ssl_certificate /etc/letsencrypt/example.com/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/example.com/private.key;
  # ECC
  ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/example.com_ecc/private.key;

  location ~* /\.git { deny all; return 403; }
  location /build/ { deny all; return 403; }
  location /cache/ { deny all; return 403; }
  location /cgi-bin/ { deny all; return 403; }
  location /uploads/import/ { deny all; return 403; }
  location /conf/ { deny all; return 403; }
  location /tests/ { deny all; return 403; }
  location /vendor/ { deny all; return 403; }

  location ~* ^/index\.php(/|$) {
    include snippets/fastcgi-php.conf;
    fastcgi_param SCRIPT_NAME /index.php;
    fastcgi_param SCRIPT_FILENAME $realpath_root/index.php;
    fastcgi_param X_REWRITE 1;
    fastcgi_pass unix:/var/run/php/php7.2-fpm.sock;
  }

  location ~* \.php(/|$) {
    rewrite ^ /index.php$uri last;
  }

  location / {
    try_files $uri $uri/ @vanilla;
  }

  location @vanilla {
    rewrite ^ /index.php$uri last;
  }

}

NOTE:Pour une configuration Nginx complète et prête pour la production pour Vanilla, visitehttps://docs.vanillaforums.com/developer/backend/server-nginx/.

Active la nouvelle configurationvanilla.confen liant le fichier au répertoiresites-enabled.

sudo ln -s /etc/nginx/sites-available/vanilla.conf /etc/nginx/sites-enabled

Vérifie que la configuration Nginx ne contient pas d'erreurs de syntaxe :

sudo nginx -t

Recharge le service Nginx :

sudo systemctl reload nginx.service

Étape 5 - Installer Vanilla Forum

Crée un répertoire racine de documents dans lequel Vanilla Forum doit résider :

sudo mkdir -p /var/www/vanilla

Change la propriété du répertoire/var/www/vanillaen{jour_user}:

sudo chown -R {your_user}:{your_user} /var/www/vanilla

REMARQUE: Remplace {jour_user} par ton nom d'utilisateur non-root créé initialement.

Navigue dans le répertoire racine du document :

cd /var/www/vanilla

Télécharge l'archive zip de Vanilla Forum :

wget https://open.vanillaforums.com/get/vanilla-core-2.6.4.zip

Extrais et supprime l'archive zip de Vanilla :

unzip vanilla-core-2.6.4.zip
rm vanilla-core-2.6.4.zip

Fournis la propriété appropriée :

sudo chown -R www-data:www-data /var/www/vanilla

Navigue dans le dossier où tu as téléchargé Vanilla dans ton navigateur Web etsuis les instructions à l'écran.

Étape 6 - Termine l'installation et la configuration de Vanilla Forum

Après avoir ouvert ton site dans un navigateur Web, tu devrais être redirigé vers la page suivante :

Vanilla Forum Installer

Remplis les informations requises et clique sur le bouton "Continuer → " pour terminer l'installation et la configuration. Ensuite, l'interface d'administration de Vanilla Forum devrait apparaître.

Vanilla Forum sur Ubuntu 18.04 LTS

Vous aimerez aussi...