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 via Github. Il dispose d'un système complémentaire riche dont vous pouvez profiter 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 en revue l'installation et la configuration du Vanilla Forum sur le système CentOS 7 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.
Vanilla Forumminimum 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 vivement :
- 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 la fin de sa durée 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 CentOS 7.
- Un utilisateur non root avec des privilèges sudo.
Étapes initiales
Vérifiez votre version de CentOS :
cat /etc/centos-release
# CentOS Linux release 7.6.1810 (Core)
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 yum update -y
Installez certains packages essentiels nécessaires à l'administration de base du système d'exploitation CentOS :
sudo yum install -y curl wget vim git unzip socat bash-completion epel-release
Étape 1 - Installer PHP et les extensions PHP nécessaires
Configurez le dépôt Webtatic YUM :
sudo rpm -Uvh https://mirror.webtatic.com/yum/el7/webtatic-release.rpm
Installez PHP, ainsi que les extensions PHP nécessaires :
sudo yum install -y php72w php72w-cli php72w-fpm php72w-common php72w-mbstring php72w-curl php72w-gd php72w-mysql
Pour afficher PHP compilé en modules, vous pouvez exécuter :
php -m
ctype
curl
exif
fileinfo
. . .
. . .
Vérifier la version PHP :
php --version
# PHP 7.2.14 (cli) (built: Jan 12 2019 12:47:33) ( 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. Étant donné que les référentiels CentOS 7 par défaut contiennent une très ancienne version de MariaDB qui n'est pas compatible avec Vanilla Forum, nous devrons utiliser le référentiel MariaDB officiel pour installer une version plus récente.
Créez le référentiel MariaDB 10.2 YUM pour CentOS :
sudo vim /etc/yum.repos.d/MariaDB.repo
Copiez et collez-y le texte suivant :
# MariaDB 10.2 CentOS repository list - created 2017-12-11 23:19 UTC
# http://downloads.mariadb.org/mariadb/repositories/
[mariadb]
name=MariaDB
baseurl=https://yum.mariadb.org/10.2/centos7-amd64
gpgkey=https://yum.mariadb.org/RPM-GPG-KEY-MariaDB
gpgcheck=1
Une fois le fichier en place, installez MariaDB en exécutant :
sudo yum install -y MariaDB-server MariaDB-client
Vérifiez la version de MariaDB :
mysql --version
# mysql Ver 15.1 Distrib 10.2.21-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é de 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
flage 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 des répertoires 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 CentOS :
sudo yum install -y nginx
Vérifiez la version de Nginx :
nginx -v
# nginx version: nginx/1.12.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 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/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(/|$) {
fastcgi_split_path_info ^(.+\.php)(/.+)$;
try_files $fastcgi_script_name =404;
set $path_info $fastcgi_path_info;
fastcgi_param PATH_INFO $path_info;
fastcgi_index index.php;
include fastcgi.conf;
fastcgi_param SCRIPT_NAME /index.php;
fastcgi_param SCRIPT_FILENAME $realpath_root/index.php;
fastcgi_param X_REWRITE 1;
fastcgi_pass 127.0.0.1:9000;
}
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 du /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.6.4.zip
Extrayez et supprimez l'archive zip Vanilla :
unzip vanilla-core-2.6.4.zip
rm vanilla-core-2.6.4.zip
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