Comment installer WonderCMS avec Nginx et Let’s Encrypt sur FreeBSD 12

WonderCMS est un CMS à plat gratuit et open-source, destiné à être extrêmement petit, léger et simple. Il est construit avec PHP, jQuery, HTML/CSS et développé depuis 2008. Aucune configuration initiale n’est nécessaire. Le processus d’installation est assez simple – dézippe et télécharge 5 fichiers. Tous les fichiers peuvent être facilement déplacés, sauvegardés et restaurés en copiant/collant tous les fichiers à un autre emplacement. Les déplacer vers un autre hôte ne nécessite aucune reconfiguration. WonderCMS n’a pas non plus besoin d’une base de données traditionnelle/relationnelle comme MySQL. La technologie de fichier plat permet à WonderCMS d’enregistrer toutes les données dans un fichier texte (fichier plat) appelé database.js qui est structuré au format JSON. Dans ce tutoriel, nous allons procéder à l’installation et à la configuration de WonderCMS sur le système FreeBSD 12 en utilisant Nginx comme serveur Web. 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

Les conditions requises pour installer et exécuter WonderCMS sont les suivantes :

  • PHP version 7.1 ou supérieure avec les extensions curl, mbstring et zip.
  • Serveur Web (Apache avec le module mod_rewrite activé, Nginx, IIS).

Conditions préalables

  • Système d’exploitation FreeBSD 12.
  • Un utilisateur non-root avec les privilèges de sudo.

Étapes initiales

Vérifie ta version de FreeBSD :

uname -ro
# FreeBSD 12.0-RELEASE

Configure le fuseau horaire :

tzsetup

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 :

freebsd-update fetch install
pkg update && pkg upgrade -y

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

pkg install -y sudo vim unzip wget bash socat

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

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

sudo pkg install -y php72 php72-mbstring php72-curl php72-gd php72-pdo php72-mysqli php72-pdo_mysql php72-json php72-openssl php72-ctype php72-dom php72-hash php72-iconv php72-tokenizer php72-calendar php72-fileinfo php72-session php72-simplexml php72-xml php72-filter

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

php -m

ctype
curl
exif
fileinfo
. . .
. . .

Vérifie la version de PHP :

php --version

# PHP 7.3.6 (cli) (built: May 28 2019 09:32:59) ( NTS )
# Copyright (c) 1997-2018 The PHP Group
# Zend Engine v3.3.6, Copyright (c) 1998-2018 Zend Technologies

Démarre et active le service PHP-FPM :

sudo sysrc php_fpm_enable=yes
sudo service php-fpm start

Étape 2 – Installe le client acme.sh et obtiens le certificat Let’s Encrypt ( facultatif )

Il n’est pas nécessaire de sécuriser ton forum avec HTTPS, mais c’est une bonne pratique pour sécuriser le trafic de ton site. Afin d’obtenir un 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 pkg install -y acme.sh

Vérifie la version d’acme.sh :

acme.sh --version
# v2.8.2

Obtiens des certificats RSA et ECC/ECDSA pour 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 de faux certificats pour tes tests, tu peux ajouter le drapeau --staging aux commandes ci-dessus.

Après avoir exécuté les commandes ci-dessus, tes certificats et tes clés seront dans :

  • Pour RSA: /home/username/example.com répertoire.
  • Pour ECC/ECDSA: répertoire /home/username/example.com_ecc.

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

acme.sh --list

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

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

Installer/copier les certificats sur /etc/letsencrypt ré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 certs, quitte l'utilisateur root et retourne à l'utilisateur normal sudo :

exit

Étape 3 - Installe et configure NGINX

WonderCMS peut fonctionner correctement avec de nombreux logiciels de serveur Web populaires. Dans ce tutoriel, nous avons choisi NGINX.

Installe NGINX :

sudo pkg install -y nginx

Vérifie la version de NGINX :

nginx -v
# nginx version: nginx/1.16.1

Démarre et active le service NGINX :

sudo sysrc nginx_enable=yes
sudo service nginx start

Ensuite, configure NGINX pour WonderCMS. Exécute sudo vim /usr/local/etc/nginx/wondercms.conf et ajoute la configuration suivante :

server {
  
  listen 80;
listen 443 ssl;

ssl_certificate /etc/letsencrypt/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/example.com/private.key;
ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/example.com_ecc/private.key; server_name example.com; root /usr/local/www/wondercms; index index.php; location / { if (!-e $request_filename) { rewrite ^/(.+)$ /index.php?page=$1 last; } } location ~ database.js { return 403; } location ~ \.php(/|$) { fastcgi_index index.php;
fastcgi_pass 127.0.0.1:9000;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; } }

Exécute sudo vim /usr/local/etc/nginx/nginx.conf et ajoute la ligne ci-dessous au bloc http {} pour inclure la configuration WonderCMS.

include wondercms.conf;

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

sudo nginx -t

Recharge le service Nginx :

sudo service nginx reload

Étape 4 - Installer WonderCMS

Crée un répertoire racine de document pour WonderCMS.

sudo mkdir -p /usr/local/www/wondercms

Navigue vers le répertoire racine du document :

cd /usr/local/www/wondercms

Télécharge et décompresse la source de WonderCMS :

sudo wget https://github.com/robiso/wondercms/releases/download/2.7.0/WonderCMS-2.7.0.zip
sudo unzip WonderCMS-2.7.0.zip
sudo rm WonderCMS-2.7.0.zip

Déplace les fichiers WonderCMS dans le répertoire racine du document.

sudo mv wondercms/* .
sudo mv wondercms/.* .
sudo rmdir wondercms

Change la propriété du répertoire /usr/local/www/wondercms pour nginx:

sudo chown -R nginx:nginx /usr/local/www/wondercms

Redémarre le service PHP-FPM :

sudo service php-fpm restart

Ouvre ton site dans un navigateur Web et connecte-toi avec le mot de passe par défaut admin et change le mot de passe par défaut par la suite.

WonderCMS sur FreeBSD

Liens

Vous aimerez aussi...