Comment installer le CMS Pagekit 1.0 sur un VPS FBS FreeBSD 11

• Conditions préalables
• Étape 1: ajouter un utilisateur Sudo
• Étape 2: Mettre à jour le système FreeBSD 11
• Étape 3: installer Apache Web Server
• Étape 4: installez PHP 7.1
• Étape 5: installer le serveur MariaDB (MySQL)
• Étape 6: créer une base de données pour Pagekit CMS
• Étape 7: installer les fichiers CMS Pagekit
• Étape 8: installation complète du CMS Pagekit

Pagekit 1.0 CMS est un beau système de gestion de contenu (CMS), modulaire, extensible et léger, gratuit et open source avec une interface utilisateur propre et intuitive alimentée par Vue.js. Le CMS Pagekit 1.0 présente une architecture modulaire basée sur des composants Symfony avec un ORM simple, un éditeur HTML et Markdown avec aperçu en temps réel, un puissant utilisateur et système d'autorisation, et un gestionnaire de fichiers flexible qui permet aux développeurs Web d'éditer des pages et de gérer des widgets avec fonctionnalité simple de glisser-déposer.

Dans ce tutoriel, nous allons installer Pagekit 1.0 CMS sur un VPS FBS FreeBSD 11 en utilisant le serveur Web Apache, PHP 7.1 et une base de données MariaDB.

Conditions préalables

• Une instance de serveur Vultr FreeBSD 11 propre avec accès SSH

Étape 1: ajouter un utilisateur Sudo

Nous allons commencer par ajouter un nouvel sudoutilisateur.

Tout d'abord, connectez-vous à votre serveur en tant que root:

ssh root@YOUR_VULTR_IP_ADDRESS

La sudocommande n'est pas installée par défaut dans l'instance de serveur Vultr FreeBSD 11, nous allons donc d'abord installer sudo:

pkg install sudo

Ajoutez maintenant un nouvel utilisateur appelé user1(ou votre nom d'utilisateur préféré):

adduser user1

La addusercommande vous demandera de nombreux détails pour le compte d'utilisateur, il vous suffit donc de sélectionner les paramètres par défaut pour la plupart d'entre eux lorsque cela est logique de le faire. Lorsque vous êtes invité à le faire Invite user1 into any other groups?, vous devez entrer wheelpour ajouter user1au wheelgroupe.

Maintenant, vérifiez le /etc/sudoersfichier pour vous assurer que le sudoersgroupe est activé:

visudo

Recherchez une section comme celle-ci:

# %wheel        ALL=(ALL)       ALL

Cette ligne nous indique que les utilisateurs membres du wheelgroupe peuvent utiliser la sudocommande pour obtenir des rootprivilèges. Il sera commenté par défaut, vous devrez donc le décommenter, puis enregistrer et quitter le fichier.

Nous pouvons vérifier l' user1appartenance au groupe avec la groupscommande:

groups user1

Si user1n'est pas membre du wheelgroupe, vous pouvez utiliser cette commande pour mettre à jour l' user1appartenance au groupe:

pw group mod wheel -m user1 

Utilisez maintenant la sucommande pour basculer vers le nouveau user1compte utilisateur sudo :

su - user1

L'invite de commande sera mise à jour pour indiquer que vous êtes maintenant connecté au user1compte. Vous pouvez le vérifier avec la whoamicommande:

whoami

Redémarrez maintenant le sshdservice pour vous connecter via sshle nouveau compte utilisateur sudo non root que vous venez de créer:

sudo /etc/rc.d/sshd restart

Quittez le user1compte:

exit

Quittez le rootcompte (qui déconnectera votre sshsession):

exit

Vous pouvez maintenant sshaccéder à l'instance de serveur à partir de votre hôte local en utilisant le nouveau user1compte utilisateur sudo non root :

ssh user1@YOUR_VULTR_IP_ADDRESS

Si vous souhaitez exécuter sudo sans avoir à taper un mot de passe à chaque fois, ouvrez à /etc/sudoersnouveau le fichier en utilisant visudo:

sudo visudo

Modifiez la section du wheelgroupe pour qu'elle ressemble à ceci:

%wheel        ALL=(ALL)       NOPASSWD: ALL

Remarque: la désactivation de l'exigence de mot de passe pour l'utilisateur sudo n'est pas une pratique recommandée, mais elle est incluse ici car elle peut rendre la configuration du serveur beaucoup plus pratique et moins frustrante, en particulier pendant les sessions d'administration de systèmes plus longues. Si vous êtes préoccupé par les implications de sécurité, vous pouvez toujours rétablir la modification de configuration à l'original après avoir terminé vos tâches d'administration.

Chaque fois que vous souhaitez vous connecter au rootcompte d'utilisateur à partir du sudocompte d'utilisateur, vous pouvez utiliser l'une des commandes suivantes:

sudo -i
sudo su -

Vous pouvez quitter le rootcompte et revenir à votre sudocompte utilisateur à tout moment en tapant simplement:

exit

Étape 2: Mettre à jour le système FreeBSD 11

Avant d'installer des packages sur l'instance du serveur FreeBSD, nous mettrons d'abord à jour le système.

Assurez-vous que vous êtes connecté au serveur à l'aide d'un utilisateur sudo non root et exécutez les commandes suivantes:

sudo freebsd-update fetch
sudo freebsd-update install
sudo pkg update
sudo pkg upgrade

Étape 3: installer Apache Web Server

Installez le serveur Web Apache:

sudo pkg install apache24

Entrez ylorsque vous y êtes invité.

Utilisez maintenant la sysrccommande pour permettre au service Apache de s'exécuter automatiquement au démarrage:

sudo sysrc apache24_enable=yes

La sysrccommande met à jour le /etc/rc.conffichier de configuration, donc si vous voulez vérifier manuellement la mise à jour de la configuration, vous pouvez simplement ouvrir le /etc/rc.conffichier avec votre éditeur de terminal préféré:

vi /etc/rc.conf

Démarrez maintenant le service Apache:

sudo service apache24 start

Vous pouvez rapidement vérifier que Apache fonctionne en visitant l'adresse IP ou le domaine de l'instance de serveur dans votre navigateur:

http://YOUR_VULTR_IP_ADDRESS/

Vous devriez voir la page par défaut de FreeBSD Apache affichant le texte:

It works!

Vérifiez votre fichier de configuration par défaut Apache pour vous assurer que la DocumentRootdirective pointe vers le bon répertoire:

sudo vi /usr/local/etc/apache24/httpd.conf

L' DocumentRootoption de configuration devrait ressembler à ceci:

DocumentRoot "/usr/local/www/apache24/data"

Nous devons maintenant activer le mod_rewritemodule Apache. Pour ce faire, recherchez le terme dans le fichier de configuration Apache par défaut mod_rewrite.

Par défaut, le mod_rewritemodule Apache sera commenté (ce qui signifie qu'il est désactivé). La ligne de configuration sur une instance propre de Vultr FreeBSD 11 ressemblera à ceci:

#LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Retirez simplement le symbole de hachage pour décommenter la ligne et charger le module. Bien entendu, cela s'applique également à tous les autres modules Apache requis:

LoadModule rewrite_module libexec/apache24/mod_rewrite.so

Nous devons maintenant modifier la Directorydirective Apache dans le même fichier de configuration afin que mod_rewritecela fonctionne correctement avec Pagekit CMS.

Recherchez la section du fichier de configuration qui commence par <Directory "/usr/local/www/apache24/data">et passez AllowOverride noneà AllowOverride All. Le résultat final (avec tous les commentaires supprimés) ressemblera à ceci:

<Directory "/var/www/html">
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

Maintenant, enregistrez et quittez le fichier de configuration Apache.

Nous redémarrerons Apache à la fin de ce tutoriel, mais redémarrer régulièrement Apache pendant l'installation et la configuration est certainement une bonne habitude, alors faisons-le maintenant:

sudo service apache24 restart

Étape 4: installez PHP 7.1

Nous pouvons maintenant installer PHP 7.1 avec tous les modules PHP nécessaires requis par Pagekit CMS:

sudo pkg install php71 mod_php71 php71-gd php71-mbstring php71-mysqli php71-xml php71-curl php71-ctype php71-tokenizer php71-simplexml php71-dom php71-session php71-iconv php71-hash php71-json php71-fileinfo php71-pdo php71-pdo_mysql php71-zlib php71-openssl php71-zip php71-phar

FreeBSD 11 nous donne la possibilité d'utiliser un développement php.iniou une production php.ini. Puisque nous allons installer Pagekit sur un serveur Web public, nous utiliserons la version de production. Tout d'abord, sauvegardez php.ini-production:

sudo cp /usr/local/etc/php.ini-production /usr/local/etc/php.ini-production.backup

Créez ensuite un lien logiciel php.ini-productionvers php.ini:

sudo ln -s /usr/local/etc/php.ini-production /usr/local/etc/php.ini

Nous devons configurer Apache pour utiliser réellement PHP, alors créons un nouveau fichier appelé php.confdans le Includesrépertoire Apache :

sudo vi /usr/local/etc/apache24/Includes/php.conf

Saisissez le texte suivant dans le fichier nouvellement créé:

<IfModule dir_module>
    DirectoryIndex index.php index.html
    <FilesMatch "\.php$">
        SetHandler application/x-httpd-php
    </FilesMatch>
    <FilesMatch "\.phps$">
        SetHandler application/x-httpd-php-source
    </FilesMatch>
</IfModule>

Enregistrez et quittez le fichier.

Redémarrons maintenant Apache pour qu'il puisse recharger les modifications de configuration:

sudo service apache24 restart

Étape 5: installer le serveur MariaDB (MySQL)

Par défaut, FreeBSD 11 utilise le serveur de base de données MariaDB, qui est un remplacement amélioré, entièrement open source, développé par la communauté, pour le serveur MySQL.

Installez la dernière version du serveur de base de données MariaDB:

sudo pkg install mariadb102-server mariadb102-client

Démarrez et activez le serveur MariaDB pour qu'il s'exécute automatiquement au démarrage:

sudo sysrc mysql_enable="yes"
sudo service mysql-server start

Sécurisez l'installation de votre serveur MariaDB:

sudo mysql_secure_installation

Lorsque vous êtes invité à créer un utilisateur MariaDB / MySQL root, sélectionnez "Y" (pour oui), puis entrez un rootmot de passe sécurisé . Répondez simplement "Y" à toutes les autres questions oui / non car les suggestions par défaut sont les options les plus sûres.

Étape 6: créer une base de données pour Pagekit CMS

Connectez-vous au shell MariaDB en tant rootqu'utilisateur MariaDB en exécutant la commande suivante:

sudo mysql -u root -p

Pour accéder à l'invite de commande MariaDB, entrez simplement le rootmot de passe MariaDB lorsque vous y êtes invité.

Exécutez les requêtes suivantes pour créer une base de données MariaDB et un utilisateur de base de données pour Pagekit CMS:

CREATE DATABASE pagekit_db CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE USER 'pagekit_user'@'localhost' IDENTIFIED BY 'UltraSecurePassword';
GRANT ALL PRIVILEGES ON pagekit_db.* TO 'pagekit_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Vous pouvez remplacer le nom pagekit_dbet le nom pagekit_userd' utilisateur de la base de données par quelque chose de plus à votre goût, si vous préférez. Assurez-vous également de remplacer "UltraSecurePassword" par un mot de passe réellement sécurisé.

Étape 7: installer les fichiers CMS Pagekit

Remplacez votre répertoire de travail actuel par le répertoire Web par défaut:

cd /usr/local/www/apache24/data

Votre répertoire de travail sera désormais: /usr/local/www/apache24/data. Vous pouvez vérifier cela avec la commande pwd(imprimer le répertoire de travail):

pwd

Utilisez maintenant wgetpour télécharger le package d'installation du CMS Pagekit:

sudo wget http://pagekit.com/api/download/latest

Répertoriez le répertoire actuel pour vérifier que vous avez correctement téléchargé le fichier:

ls -la

Supprimer index.html:

sudo rm index.html

Décompressez maintenant l'archive zip:

sudo unzip latest

Modifiez la propriété des fichiers Web pour éviter tout problème d'autorisation:

sudo chown -R www:www * ./

Redémarrez Apache à nouveau:

sudo service apache24 restart

Nous sommes maintenant prêts à passer à la dernière étape.

Étape 8: installation complète du CMS Pagekit

Il est temps de visiter l'adresse IP de votre instance de serveur dans votre navigateur, ou si vous avez déjà configuré vos paramètres DNS Vultr (et lui avez donné suffisamment de temps pour se propager), vous pouvez simplement visiter votre domaine à la place.

Pour accéder à la page d'installation du CMS Pagekit, entrez votre adresse IP d'instance Vultr dans la barre d'adresse de votre navigateur, puis /index.php:

http://YOUR_VULTR_IP_ADDRESS/index.php

La plupart des options d'installation de Pagekit CMS sont explicites, mais voici quelques conseils pour vous aider:

1. Cliquez sur la flèche pour démarrer le processus d'installation.

2. Sélectionnez votre langue et cliquez sur le NEXTbouton.

3. Sélectionnez en MySQLtant que votre Database Driver, puis entrez les détails de la base de données suivants:

   Hostname:           localhost
   User:               pagekit_user
   Password:           UltraSecurePassword
   Database Name:      pagekit_db
   Table Prefix:       pk_
   

   Cliquez NEXTpour continuer.

4. Entrez votre Site Titleet Administrator Detailscomme suit:

   Site Title:         <your site title>
   Username:           <your admin username>
   Password:           <your admin password>
   Email:              <your admin email address>
   

5. Cliquez INSTALLpour exécuter le programme d'installation du CMS Pagekit.

Vous serez redirigé vers la page de connexion administrateur. Si vous n'êtes pas redirigé vers la page de connexion administrateur, vous pouvez saisir l'adresse administrateur manuellement:

http://YOUR_VULTR_IP_ADDRESS/admin/login

Entrez simplement votre nom d'utilisateur et votre mot de passe administrateur sur la page de connexion.

Vous êtes maintenant prêt à commencer à ajouter votre contenu et à configurer l'apparence de votre site. Assurez-vous de consulter l'excellente documentation du CMS Pagekit pour plus d'informations sur la création et la configuration de votre site.