Comment installer Pagekit CMS sur Debian 9

Pagekit est un CMS open source moderne, intuitif, modulaire et flexible (licence MIT) construit avec des composants Symfony et Vue.js. Il vous donne les outils pour créer de beaux sites web. Il dispose d’un riche écosystème de thèmes et de plugins.

Dans ce tutoriel, nous vous guiderons à travers le processus d’installation de Pagekit CMS sur un système d’exploitation Debian 9 (stretch) en utilisant NGINX comme serveur web, MariaDB comme serveur de base de données, et optionnellement, 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

Pour installer Pagekit, assurez-vous que votre serveur répond aux exigences suivantes :

Version d’Apache 2.2 ou supérieure ou serveur web NGINX.
Version de MySQL 5.1 ou supérieure ou SQLite 3.
Version de PHP 5.5.9 ou supérieure.
Extensions PHP requises : JSON, Session, ctype, Tokenizer, SimpleXML, DOM, mbstring, PCRE 8.0+, ZIP et PDO avec les pilotes MySQL ou SQLite.
Extensions PHP optionnelles : cURL, iconv et XML Parser, ainsi qu’APC ou XCache pour le caching.

Prérequis

Un système fonctionnant sous Debian 9 (stretch).
Un utilisateur non-root avec des privilèges sudo.

Étapes initiales

Vérifiez la version de votre système Debian :

lsb_release -ds  
# Debian GNU/Linux 9.7 (stretch)

Configurez le fuseau horaire :

dpkg-reconfigure tzdata

Mettez à jour les paquets de votre système d’exploitation (logiciel). C’est une étape importante car elle garantit que vous disposez des dernières mises à jour et correctifs de sécurité pour les paquets logiciels par défaut de votre système d’exploitation :

apt update && apt upgrade -y

Installez quelques paquets essentiels qui sont nécessaires pour l’administration de base du système d’exploitation Debian :

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

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

La plateforme Pagekit CMS nécessite PHP version 7.0 ou supérieure. Par défaut, Debian 9 a PHP version 7.0 dans ses dépôts logiciels par défaut, ce qui est suffisant pour October CMS.

Téléchargez et installez PHP 7.0 et les extensions PHP requises :

sudo apt install -y php7.0 php7.0-cli php7.0-fpm php7.0-common php7.0-mbstring php7.0-zip php7.0-mysql php7.0-sqlite3 php7.0-curl php7.0-xml

Pour afficher les modules PHP compilés, vous pouvez exécuter :

php -m  
  
ctype  
curl  
exif  
fileinfo  
. . .  
. . .

Vérifiez la version de PHP :

php --version  
# PHP 7.0.33-0+deb9u1 (cli) (built: Dec 7 2018 11:36:49) ( NTS )  
# Copyright (c) 1997-2017 The PHP Group  
# Zend Engine v3.0.0, Copyright (c) 1998-2017 Zend Technologies  
#     with Zend OPcache v7.0.33-0+deb9u1, Copyright (c) 1999-2017, by Zend Technologies

Le service PHP-FPM est automatiquement démarré et activé au démarrage sur le système Debian 9, donc il n’est pas nécessaire de le démarrer 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 - Installer MariaDB et créer une base de données pour Pagekit

Pagekit CMS prend en charge les bases de données MySQL, MariaDB et SQLite. L’équipe Debian a remplacé MySQL par MariaDB comme base de données par défaut à partir de Debian 9 (stretch), donc dans ce tutoriel, nous utiliserons MariaDB comme serveur de base de données. Si vous souhaitez installer l’original MySQL, vous pouvez ajouter et utiliser le dépôt MySQL officiel maintenu par Oracle.

Installez le serveur de base de données MariaDB version 10.2 à partir du dépôt officiel de MariaDB :

sudo apt install -y software-properties-common dirmngr apt-transport-https  
sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 0xF1656F24C74CD1D8  
sudo add-apt-repository 'deb [arch=amd64,i386,ppc64el] https://mirrors.nxthost.com/mariadb/repo/10.2/debian stretch main'  
sudo apt update  
sudo apt install -y mariadb-server

REMARQUE : Vous serez invité à entrer le mot de passe de l’utilisateur root. Entrez un mot de passe fort et continuez.

Vérifiez la version de MariaDB :

mysql --version  
# mysql  Ver 15.1 Distrib 10.2.22-MariaDB, for debian-linux-gnu (x86_64) using readline 5.2

Exécutez le script mysql_secure_installation pour améliorer la sécurité de MariaDB et définir le mot de passe pour l’utilisateur root de MariaDB :

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 à MariaDB en tant qu’utilisateur root :

sudo mysql -u root -p  
# Enter password

Créez une base de données MariaDB et un utilisateur que vous utiliserez pour votre installation de Pagekit, et notez les identifiants :

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

Quittez le shell MariaDB :

quit

Étape 3 - Installer le client Acme.sh et obtenir un certificat Let’s Encrypt (optionnel)

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 SSL de Let’s Encrypt, nous utiliserons le client Acme.sh. Acme.sh est un logiciel shell UNIX pur pour obtenir des certificats SSL de Let’s Encrypt sans dépendances.

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.1

Obtenez des certificats RSA et ECC/ECDSA 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 souhaitez des certificats factices pour les tests, vous pouvez ajouter le drapeau --staging aux commandes ci-dessus.

Pour lister vos certificats émis, vous pouvez exécuter :

acme.sh --list

Créez un répertoire pour stocker vos certificats. Nous utiliserons le répertoire /etc/letsencrypt.

mkdir -p /etc/letsencrypt/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"

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

Pour RSA : le répertoire /etc/letsencrypt /example.com.
Pour ECC/ECDSA : le répertoire /etc/letsencrypt /example.com_ecc.

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 - Installer NGINX et configurer NGINX pour Pagekit

Installez le serveur web NGINX :

sudo apt install -y nginx

Vérifiez la version de NGINX :

sudo nginx -v  
# nginx version: nginx/1.10.3

Configurez NGINX pour Pagekit en exécutant :

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

Et remplissez le fichier avec la configuration suivante :

server {  
    listen [::]:443 ssl http2;  
    listen 443 ssl http2;
    listen [::]:80;
    listen 80;
    
    server_name example.com;
    
    index index.php index.html;
    root /var/www/pagekit;  

    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;  

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }  
  
    location ~ \.php$ {  
        include snippets/fastcgi-php.conf;  
        fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;  
    }
    
}

Activez la nouvelle configuration pagekit.conf en liant le fichier au répertoire sites-enabled.

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

Vérifiez la configuration de NGINX pour les erreurs de syntaxe :

sudo nginx -t

Rechargez le service NGINX :

sudo systemctl reload nginx.service

Étape 5 - Télécharger et installer Pagekit CMS

Créez un répertoire racine de documents où Pagekit doit résider :

sudo mkdir -p /var/www/pagekit

Changez la propriété du répertoire /var/www/pagekit à [your_user]:

sudo chown -R [your_user]:[your_user] /var/www/pagekit

Naviguez vers le répertoire racine des documents :

cd /var/www/pagekit

Téléchargez la dernière version stable de Pagekit CMS via wget :

wget https://github.com/pagekit/pagekit/releases/download/1.0.16/pagekit-1.0.16.zip

Décompressez le contenu de Pagekit CMS et supprimez le fichier .zip téléchargé.

unzip pagekit-1.0.16.zip  
rm pagekit-1.0.16.zip

Changez la propriété du répertoire /var/www/pagekit à www-data.

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

Étape 6 - Compléter la configuration de Pagekit

Ouvrez votre site dans un navigateur web et vous devriez voir la page suivante :

Installateur web Pagekit

Cliquez sur l’icône de flèche droite pour continuer l’installation. Choisissez votre langue et cliquez sur le bouton “Suivant” :

Choisir la langue

Ensuite, choisissez votre base de données soit SQLite soit MySQL et remplissez les champs requis puis cliquez sur le bouton “Suivant” :

Se connecter à la base de données

Après cela, configurez votre site en entrant le titre du site et en créant un compte utilisateur administrateur :

Configurer le site web

Et c’est tout. Vous serez redirigé vers la page de connexion de Pagekit. Fournissez votre nom d’utilisateur et votre mot de passe pour vous connecter au tableau de bord de Pagekit.

Se connecter à la zone d'administration de pagekit

C’est tout. Si vous êtes bloqué, consultez la documentation officielle de Pagekit.