Vanilla est un forum de discussion open source gratuit écrit en PHP. Le logiciel Vanilla Forum est distribué sous la licence GNU GPL2. Son code source est disponible via Github. Il dispose d'un système complémentaire riche dont vous pouvez tirer parti pour ajouter des fonctionnalités personnalisées à votre forum Vanilla. Le contenu de Vanilla Forum peut être rédigé à l'aide du langage Markdown. Dans ce didacticiel, nous allons passer par l'installation et la configuration du Vanilla Forum sur le système Fedora 29 en utilisant Nginx comme serveur Web, MySQL comme serveur de base de données, et éventuellement, vous pouvez sécuriser la couche de transport en utilisant le client acme.sh et l'autorité de certification Let's Encrypt. pour ajouter le support SSL.
Exigences
Vanilla nécessite un serveur avec PHP, MySQL et un logiciel de serveur Web (comme Apache ou NGINX). Vous aurez probablement besoin de posséder un domaine et de l'avoir déjà configuré sur votre serveur avec DNS si vous souhaitez l'installer sur un serveur de production, mais si ce n'est pas le cas, vous n'avez pas besoin d'un domaine.
Forum vanille minimum les exigences sont :
- PHP version 7.0 ou ultérieure.
- Extensions PHP mbstring, cURL, GD et PDO, MySQLi, OpenSSL.
- MySQL version 5.0 ou ultérieure (ou équivalent Percona/MariaDB).
- Logiciel de serveur Web (Nginx, Apache ...).
- Mode strict de MySQL désactivé.
Vanilla Forum recommande fortement :
- PHP 7.2 ou version ultérieure
- Extensions PHP mbstring, cURL, GD et PDO, MySQLi, OpenSSL.
- MySQL 5.7 ou version ultérieure (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. La prise en charge de PHP 7.0 par Vanilla se terminera bientôt !
Prérequis
- Un système d'exploitation exécutant Fedora 29.
- Un utilisateur non root avec des privilèges sudo.
Étapes initiales
Vérifiez la version de votre système Fedora :
cat /etc/fedora-release
# Fedora release 29 (Twenty Nine)
Configurez le fuseau horaire :
timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'
Mettez à jour les packages de votre système d'exploitation (logiciels). Il s'agit d'une première étape importante car elle garantit que vous disposez des dernières mises à jour et correctifs de sécurité pour les packages logiciels par défaut de votre système d'exploitation :
sudo dnf upgrade -y
Installez certains packages essentiels nécessaires à l'administration de base du système d'exploitation Fedora :
sudo dnf install -y curl wget vim git sudo zip unzip socat bash-completion
Étape 1 - Installer PHP et les extensions PHP nécessaires
Installez PHP, ainsi que les extensions PHP nécessaires :
sudo dnf install -y php-cli php-fpm php-common php-mbstring php-curl php-gd php-mysqlnd php-json
Pour afficher PHP compilé en modules, vous pouvez exécuter :
php -m
ctype
curl
exif
fileinfo
. . .
. . .
Vérifiez la version de PHP :
php --version
# PHP 7.2.16 (cli) (built: Mar 5 2019 11:05:59) ( NTS )
# Copyright (c) 1997-2018 The PHP Group
# Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
Démarrez et activez le service PHP-FPM :
sudo systemctl start php-fpm.service
sudo systemctl enable php-fpm.service
Nous pouvons passer à l'étape suivante, qui est l'installation et la configuration de la base de données.
Étape 2 :Installez MariaDB et créez 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 MariaDB comme serveur de base de données.
Installez MariaDB en exécutant :
sudo dnf install -y mariadb-server
Vérifiez la version de MariaDB :
mysql --version
# mysql Ver 15.1 Distrib 10.3.12-MariaDB, for Linux (x86_64) using readline 5.1
Démarrez et activez le service MariaDB :
sudo systemctl start mariadb.service
sudo systemctl enable mariadb.service
Exécutez l'mysql_secure installation
script pour améliorer la sécurité MariaDB et définir le mot de passe pour MariaDB root
utilisateur :
sudo mysql_secure_installation
Répondez à chacune des questions :
Enter current password for root (enter for none): Press Enter
Set root password? [Y/n] Y
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
Connectez-vous au shell MariaDB en tant qu'utilisateur racine :
sudo mysql -u root -p
# Enter password
Créez une base de données MariaDB vide et un utilisateur pour Vanilla Forum et mémorisez les informations d'identification :
MariaDB [(none)]> CREATE DATABASE dbname;
MariaDB [(none)]> GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
MariaDB [(none)]> FLUSH PRIVILEGES;
Quitter MariaDB :
MariaDB [(none)]> exit
Remplacez dbname
, username
et password
avec vos propres noms.
Étape 3 – Installer acme.sh
client et obtenir le certificat Let's Encrypt (facultatif )
Sécuriser votre site Web avec HTTPS n'est pas nécessaire, mais c'est une bonne pratique pour sécuriser le trafic de votre site. Afin d'obtenir un certificat TLS de Let's Encrypt, nous utiliserons le client acme.sh. Acme.sh est un logiciel shell UNIX pur permettant d'obtenir des certificats TLS de Let's Encrypt sans aucune dépendance.
Téléchargez et installez 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érifiez la version d'acme.sh :
acme.sh --version
# v2.8.0
Obtenir RSA et ECC/ECDSA certificats pour votre 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 vous voulez de faux certificats pour les tests, vous pouvez ajouter --staging
drapeau aux commandes ci-dessus.
Après avoir exécuté les commandes ci-dessus, vos certificats et les clés sera dans :
- Pour RSA :
/home/username/example.com
répertoire. - Pour ECC/ECDSA :
/home/username/example.com_ecc
répertoire.
Pour répertorier vos certificats émis, vous pouvez exécuter :
acme.sh --list
Créez un répertoire pour stocker vos certificats. Nous utiliserons /etc/letsencrypt
répertoire.
mkdir -p /etc/letsecnrypt/example.com
sudo mkdir -p /etc/letsencrypt/example.com_ecc
Installez/copiez les certificats dans le répertoire /etc/letsencrypt.
# 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, quittez l'utilisateur root et revenez à l'utilisateur sudo normal :
exit
Étape 4 :Installez NGINX et configurez NGINX pour Vanilla Forum
Vanilla Forum peut fonctionner correctement avec de nombreux logiciels de serveur Web populaires. Dans ce tutoriel, nous avons sélectionné NGINX. Si vous préférez le serveur Web Apache à NGINX, veuillez consulter https://docs.vanillaforums.com/developer/backend/server-apache/ pour en savoir plus.
Téléchargez et installez NGINX à partir du dépôt Fedora :
sudo dnf install -y nginx
Vérifiez la version de NGINX :
nginx -v
# nginx version: nginx/1.14.2
Démarrez et activez le service NGINX :
sudo systemctl start nginx.service
sudo systemctl enable nginx.service
Configurez NGINX pour Vanilla en exécutant :
sudo vim /etc/nginx/conf.d/vanilla.conf
Et remplissez le fichier avec la configuration suivante :
server {
listen 80;
listen 443 ssl http2;
server_name 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/ECDSA
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 default.d/php.conf;
fastcgi_param SCRIPT_NAME /index.php;
fastcgi_param SCRIPT_FILENAME $realpath_root/index.php;
fastcgi_param X_REWRITE 1;
fastcgi_pass unix:/run/php-fpm/www.sock;
}
location ~* \.php(/|$) {
rewrite ^ /index.php$uri last;
}
location / {
try_files $uri $uri/ @vanilla;
}
location @vanilla {
rewrite ^ /index.php$uri last;
}
}
REMARQUE : Pour une configuration Nginx complète et prête pour la production pour Vanilla, visitez https://docs.vanillaforums.com/developer/backend/server-nginx/.
Vérifiez la configuration de NGINX pour les erreurs de syntaxe :
sudo nginx -t
Recharger le service NGINX :
sudo systemctl reload nginx.service
Étape 5 : Installer Vanilla Forum
Créez un répertoire racine de documents dans lequel Vanilla Forum doit résider :
sudo mkdir -p /var/www/vanilla
Changer le propriétaire de /var/www/vanilla
répertoire vers {jour_user}
:
sudo chown -R {your_user}:{your_user} /var/www/vanilla
REMARQUE : Remplace {jour_user}
avec votre nom d'utilisateur non root créé initialement.
Accédez au répertoire racine du document :
cd /var/www/vanilla
Téléchargez l'archive zip Vanilla Forum :
wget https://open.vanillaforums.com/get/vanilla-core-2.8.1.zip
Extrayez et supprimez l'archive zip Vanilla :
unzip vanilla-core-2.8.1.zip
rm vanilla-core-2.8.1.zip
mv vanilla-2.8.1/* . && mv vanilla-2.8.1/.* .
Indiquez le propriétaire approprié :
sudo chown -R nginx:nginx /var/www/vanilla
Exécutez sudo vim /etc/php-fpm.d/www.conf
et définissez l'utilisateur et le groupe sur nginx
. Initialement, ils seront définis sur apache:
sudo vim /etc/php-fpm.d/www.conf
# user = nginx
# group = nginx
Accédez au dossier dans lequel vous avez téléchargé Vanilla dans votre navigateur Web et suivez les instructions à l'écran.
Étape 6 – Terminez l'installation et la configuration du forum Vanilla
Après avoir ouvert votre site dans un navigateur Web, vous devriez être redirigé vers la page suivante :
Remplissez les informations requises et cliquez sur "Continuer →" bouton pour terminer l'installation et la configuration. Après cela, l'interface d'administration du forum Vanilla devrait apparaître.
Liens
- https://open.vanillaforums.com/
- https://github.com/vanilla/vanilla