Autohébergement

Cette page vous guidera dans l'installation de ClientXCMS Next Gen pour les versions autohébergées. Les offres Cloud sont installées automatiquement sur les serveurs de CLIENTXCMS. L'installation est disponible ici.

Demander le téléchargement

info

L'accès aux licences autohébergées est restreint. Pour demander une licence à héberger sur vos propres serveurs, rendez-vous sur l'espace client de ClientXCMS via l'URL : https://clientxcms.com/client/services.

1. Cliquez sur le bouton "Gérer le service" de la licence en question.
2. Cliquez sur le bouton "Télécharger" en bas à droite pour ouvrir le formulaire de demande.
3. Remplissez les informations de votre hébergeur. Vous serez recontacté par e-mail dans les 72 heures.

Si la page de téléchargement apparaît, la demande a été acceptée et vous pouvez cliquer sur le bouton "Télécharger" pour obtenir l'archive du CMS.

info

L'exemple ci-dessous est basé sur Debian 12, mais les commandes peuvent varier en fonction de votre distribution.

Dossier d'installation

Créez un dossier d'installation pour votre CMS. Vous pouvez le faire en utilisant la commande suivante :

mkdir /var/www/clientxcms

Téléchargement de l'archive

Téléchargez l'archive du CMS en utilisant la commande suivante envoyé par e-mail :

wget https://clientxcms.com/licensing/downloads/{uuid}

Puis extrayez l'archive dans le dossier d'installation :

unzip clientxcms.zip -d /var/www/clientxcms
mv /var/www/clientxcms/DarkIncognito85-clientxcms-v2-*/* /var/www/clientxcms
rm -r /var/www/clientxcms/DarkIncognito85-clientxcms-v2-*/
cp /var/www/clientxcms/.env.example /var/www/clientxcms/.env

info

Si vous n'avez pas installé ZIP, vous pouvez l'installer avec la commande suivante :

sudo apt-get install zip unzip 

Mise en place de PHP & Composer

Pour installer PHP, vous pouvez utiliser la commande suivante :

sudo apt-get update
sudo apt-get install ca-certificates apt-transport-https software-properties-common wget curl lsb-release
curl -sSL https://packages.sury.org/php/README.txt | sudo bash -x
sudo apt-get update
sudo apt-get install php8.1-common php8.1-curl php8.1-bcmath php8.1-intl php8.1-mbstring php8.1-xmlrpc php8.1-mcrypt php8.1-mysql php8.1-gd php8.1-xml php8.1-cli php8.1-zip

Pour installer Composer, vous pouvez utiliser la commande suivante :

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
php -r "unlink('composer-setup.php');"

Vous pouvez maintenant installer les dépendances du projet en utilisant la commande suivante :

./composer.phar install --optimize-autoloader --no-dev

Mise en place de MySQL

info

Ici nous présentons Mysql, mais MariaDB est aussi compatible à Clientxcms.

Pour installer MySQL, vous pouvez utiliser la commande suivante :

sudo apt-get install mysql-server

Lorsque vous y êtes invité, confirmez l’installation en tapant Y, puis ENTRÉE.

Une fois l’installation terminée, il est recommandé d’exécuter un script de sécurité, préinstallé avec MySQL. Ce script supprimera certains paramètres par défaut peu sûrs et verrouillera l’accès à votre système de base de données. Lancez le script interactif en exécutant :

sudo mysql_secure_installation

Répondez aux questions suivantes en fonction de vos besoins :

• Appuyez sur la touche entrée si vous n’en avez pas défini précédemment
• Définissez un mot de passe root pour MySQL
• Supprimez l’utilisateur anonyme > Y
• Interdisez la connexion à distance à la base de données > Y
• Supprimez la base de données de test > Y
• Rechargez les privilèges > Y

Vous pouvez maintenant vous connecter à MySQL en utilisant la commande suivante :

mysql -u root -p

Mise en place du serveur web

Apache

info

Ici, nous ne présentons pas comment installer un certificat SSL.

Pour installer Apache, vous pouvez utiliser la commande suivante :

sudo apt-get install apache2 libapache2-mod-php

Pour activer le module rewrite, vous pouvez utiliser la commande suivante :

sudo a2enmod rewrite

Pour ajouter un hôte virtuel, vous pouvez utiliser la commande suivante :

sudo nano /etc/apache2/sites-available/clientxcms.conf

Exemple de fichier de configuration

<VirtualHost *:80>
    ServerAdmin webmaster@localhost
    DocumentRoot /var/www/clientxcms/public
    ServerName domain.fr
    ServerAlias www.domain.fr

        <Directory />
                Options FollowSymLinks
                AllowOverride All
        </Directory>
        <Directory /var/www/clientxcms/public >
                Options FollowSymLinks MultiViews
                Options -Indexes
                AllowOverride All
                Order allow,deny
                allow from all
        </Directory>

    LogLevel debug
    ErrorLog ${APACHE_LOG_DIR}/error.log
    CustomLog ${APACHE_LOG_DIR}/access.log combined

</VirtualHost>

Pour activer le vhost, vous pouvez utiliser la commande suivante :

sudo a2ensite clientxcms.conf

Pour vous assurer que le fichier de configuration est correct, vous pouvez utiliser la commande suivante :

sudo apache2ctl configtest

Pour redémarrer Apache, vous pouvez utiliser la commande suivante :

sudo systemctl restart apache2

Nginx

info

Ici, nous ne présentons pas comment installer un certificat SSL.

Pour installer Nginx, vous pouvez utiliser la commande suivante :

sudo apt-get install nginx php8.1-fpm

Pour ajouter un hôte virtuel, vous pouvez utiliser la commande suivante :

sudo nano /etc/nginx/sites-available/clientxcms.conf

Exemple de fichier de configuration

server {
    listen 80;
    server_name domain.fr www.domain.fr;
    root /var/www/clientxcms/public;

    index index.php index.html index.htm;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.ht {
        deny all;
    }
}

Pour activer le vhost, vous pouvez utiliser la commande suivante :

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

Pour vous assurer que le fichier de configuration est correct, vous pouvez utiliser la commande suivante :

sudo nginx -t

Pour redémarrer Nginx, vous pouvez utiliser la commande suivante :

sudo systemctl restart nginx

Configuration de la base de données

Pour configurer la base de données, vous pouvez utiliser la commande suivante :

mysql -u root -p

Créez une base de données et un utilisateur en utilisant les commandes suivantes. Nous vous recommandons de remplacer le mot de passe par un mot de passe plus sécurisé :

CREATE DATABASE clientxcms;
CREATE USER clientxcms@localhost IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON clientxcms.* TO clientxcms@localhost;
FLUSH PRIVILEGES;

Vous pouvez maintenant quitter MySQL en utilisant la commande suivante :

exit

Vous pouvez maintenant modifier les informations de connexion à la base de données dans le fichier .env en utilisant la commande suivante :

nano .env

Puis modifiez les informations de connexion à la base de données :

DB_CONNECTION=mysql
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=clientxcms
DB_USERNAME=clientxcms
DB_PASSWORD=password

Autres configurations

Pour générer une clé d'application, vous pouvez utiliser la commande suivante :

php artisan key:generate

Pour migrer la base de données, vous pouvez utiliser la commande suivante :

php artisan migrate --force --seed

Pour lier le dossier de stockage, vous pouvez utiliser la commande suivante :

php artisan storage:link

Pour ajouter les bonnes permissions, vous pouvez utiliser la commande suivante :

sudo chmod -R 775 storage bootstrap/cache

Assets

info

La première partie va concerner l'installation de nodejs, mais si vous l'avez déjà installé, vous pouvez passer à la compilation des assets.

Pour commencer, nous devons installer NVM, qui est un gestionnaire de versions de Node.js. Pour ce faire, exécutez la commande suivante :

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

Ensuite, vous pouvez télécharger et installer Node.js (il peut être nécessaire de redémarrer le terminal) :

nvm install 18

Vérifiez maintenant que la bonne version de Node.js est installée via cette commande :

node -v

Celle-ci devrait afficher v18.20.4, qui est la version LTS actuelle de Node.js version 18.

Pour compiler les assets, vous pouvez utiliser les commandes suivantes :

npm install
npm run build

Taches planifiées

Pour configurer les tâches planifiées, vous pouvez utiliser la commande suivante :

crontab -e

Puis ajoutez la ligne suivante :

* * * * * php /var/www/clientxcms/artisan schedule:run >> /dev/null 2>&1

Configuration de ClientXCMS

1. Rendez-vous sur l'adresse de votre espace client. Vous devriez voir une page d'installation similaire à celle-ci :

2. Remplacez "CLIENTXCMS" par votre nom commercial d'hébergeur.

3. Pour trouver l'ID client et le Secret client, allez sur l'espace client ClientXCMS : https://clientxcms.com/client/services/, dans la gestion de la licence NextGen concernée. Les identifiants "OAuth Client ID" et "OAuth Secret" sont nécessaires pour connecter la licence ClientXCMS à votre site. Cliquez ensuite sur le bouton "Se connecter" sur votre instance.

Achat d'extension

Si vous achetez des extensions entre-temps et que vous avez le message d'erreur suivant lorsque vous souhaitez les activer :

"Le fichier composer.json n'a pas été trouvé."

Vous pouvez demander à télécharger l'archive de l'extension via la page de téléchargement de l'espace client. Vous pouvez ensuite l'extraire dans le dossier addons ou modules de votre installation.

Problèmes courants

Interface introuvable Jsonable

Si vous avez l'erreur suivante : "Interface "DragonCode/Contracts/Support/Jsonable" not found" Vous pouvez la régler en executant la commande :

composer require dragon-code/contracts