Instructions d'installation du module WHMCS

WHMCS (Web Host Manager Complete Solution) est un système d'automatisation destiné aux sociétés d'hébergement et aux fournisseurs de services Internet. Il offre des fonctionnalités pour la gestion des clients, la facturation, l'assistance et l'automatisation des processus. Voici les instructions pour installer ce module.

ÉTAPE 1 : Chargement du module

Téléchargez le module sur le serveur via la ligne de commande en utilisant scp :

scp /path/to/local/module-whmcs-billmanager.zip
username@remote_server:/path/to/remote/directory

Exemple si vous êtes déjà dans le dossier contenant le fichier :

scp module-whmcs-billmanager.ziproot@77.92.122.212:/var/www/www-root/data/www/data-hub.online/

Vous serez alors invité à saisir le mot de passe de votre serveur.

Après avoir téléchargé le fichier sur le serveur, connectez-vous au serveur via SSH et décompressez le fichier

ssh user@remote_server

Vous devrez entrer le mot de passe du serveur.

Allez ensuite dans le dossier de votre projet où vous avez téléchargé le fichier.

cd /var/www/path/to/destination/ 

L'archive doit être décompressée à la racine du projet.

unzip module-whmcs-billmanager.zip

Dans cette archive il y a 3 versions du module correspondant à la version de php sur laquelle whmcs fonctionne, pour connaître votre version de php allez dans Utilities/System/PHP info.

Ensuite vous devez décompresser l'archive pour la version que votre whmcs supporte.

Pour php 7.1, php 7.2, php 7.4 entrez

unzip version7.1|7.2|7.4.zip

Pour php 8.1 entrez

unzip version8.1

Pour php 8.2 entrez

unzip version8.2

Ensuite, vous devez (obligatoirement) accorder les permissions aux fichiers. Vous pouvez le faire à partir du dossier du projet en entrant la commande
chmod -R 755 modules/servers/PQH

Le module est chargé.

Ou Uploader le module sur le serveur via FileZilla

Sur votre ordinateur, décompressez le fichier module-whmcs-billmanager.zip

Ensuite, vous devez décompresser à nouveau l'archive de la version que votre whmcs supporte :

Для версии php 7.1, php 7.2, php 7.4 архив version7.1|7.2|7.4.zip
Для версии php 8.1 архив version8.1
Для версии php 8.2 архив version8.2

Connectez-vous ensuite à votre serveur à l'aide de FileZilla.

Transférez les fichiers dans le dossier racine du site depuis l'archive correspondant à votre version de php (comme dans la capture d'écran ci-dessous).

Ensuite il faut (obligatoirement) donner les droits sur le dossier et les fichiers pour cela aller dans le dossier modules/servers et faire un clic droit sur le dossier PQH et sélectionner attributs de fichiers dans la fenêtre pop-up, écrire dans le champ valeur numérique 755 et cocher la case sur recurse into subdirectories (comme sur la capture d'écran ci-dessous).

Le module est chargé.

ETAPE 2 : Vérifier IonCube

Sur notre hébergement mutualisé, le support de IonCube et sa version dépendent de la version PHP sélectionnée pour l'utilisateur. Ceci est valable pour toutes les gammes de plans d'hébergement, ainsi que pour les serveurs virtuels/dédiés avec le panneau ISPManager installé.

Exigences préliminaires pour l'installation de IonCube

Si vous avez un serveur sans panneau de contrôle, vous pouvez être confronté à la nécessité d'une installation manuelle de IonCube.

Le processus d'installation peut varier en fonction de votre système d'exploitation. Quel que soit le système d'exploitation, la première étape consiste toujours à se connecter via SSH et à obtenir l'accès root.

Pour installer IonCube, vous avez besoin d'une machine avec un serveur web actif et fonctionnel, Apache ou Nginx, ainsi qu'une version installée de PHP à partir de la liste des versions supportées par IonCube Loader.

Installation pas à pas de IonCube

Important : la valeur des commandes utilisées pour installer IonCube Loader varie en fonction de certaines variables : la version de PHP sur le serveur, l'emplacement du répertoire PHP et la version de l'architecture du serveur. Ici et dans le futur, nous mettrons en évidence les valeurs de ces variables. A leur place, vous devrez substituer les valeurs appropriées à votre serveur lors de l'installation.

1. connectez-vous au serveur via SSH.

2. Vérifiez l'architecture du serveur actuel :

uname -m
Exit
x86_64

Comme nous pouvons le voir avec x86_64, notre serveur actuel fonctionne sur une architecture 64 bits. Les valeurs de la forme i686 indiqueraient le contraire - une architecture 32 bits.

Allez ensuite dans le répertoire tmp et téléchargez l'archive nécessaire :

Pour les systèmes 64 bits :

cd /tmp
wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.tar.gz

Pour les systèmes 32 bits :

cd /tmp
wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86.tar.gz

Après avoir téléchargé l'archive, vous devez la décompresser :

Comme nous avons une architecture 64 bits dans l'exemple, nous avons téléchargé et décompressé une archive de ce type.

tar -zxvf ioncube_loaders_lin_x86-64.tar.gz

5. Allez dans le répertoire ioncube et consultez la liste des fichiers.

cd ioncube/
ls -l

Conclusion

total 39260
-rw-rw-r-- 1 507 507  472192 Sep  9  2023 ioncube_loader_lin_4.1.so
-rw-rw-r-- 1 507 507  471968 Sep  9  2023 ioncube_loader_lin_4.2.so
-rw-rw-r-- 1 507 507  472768 Sep  9  2023 ioncube_loader_lin_4.3.so
-rw-rw-r-- 1 507 507  490752 Sep  9  2023 ioncube_loader_lin_4.3_ts.so
-rw-rw-r-- 1 507 507  475840 Sep  9  2023 ioncube_loader_lin_4.4.so
-rw-rw-r-- 1 507 507  494880 Sep  9  2023 ioncube_loader_lin_4.4_ts.so
-rw-rw-r-- 1 507 507  483360 Sep  9  2023 ioncube_loader_lin_5.0.so
-rw-rw-r-- 1 507 507  497632 Sep  9  2023 ioncube_loader_lin_5.0_ts.so
-rw-rw-r-- 1 507 507 1116768 Sep  9  2023 ioncube_loader_lin_5.1.so
-rw-rw-r-- 1 507 507 1155744 Sep  9  2023 ioncube_loader_lin_5.1_ts.so
-rw-rw-r-- 1 507 507 1139936 Sep  9  2023 ioncube_loader_lin_5.2.so
-rw-rw-r-- 1 507 507 1176704 Sep  9  2023 ioncube_loader_lin_5.2_ts.so
-rw-rw-r-- 1 507 507 1222328 Sep  9  2023 ioncube_loader_lin_5.3.so
-rw-rw-r-- 1 507 507 1275512 Sep  9  2023 ioncube_loader_lin_5.3_ts.so
-rw-rw-r-- 1 507 507 1512960 Sep  9  2023 ioncube_loader_lin_5.4.so
-rw-rw-r-- 1 507 507 1599584 Sep  9  2023 ioncube_loader_lin_5.4_ts.so
-rw-rw-r-- 1 507 507 1520056 Sep  9  2023 ioncube_loader_lin_5.5.so
-rw-rw-r-- 1 507 507 1602040 Sep  9  2023 ioncube_loader_lin_5.5_ts.so
-rw-rw-r-- 1 507 507 1485192 Sep  9  2023 ioncube_loader_lin_5.6.so
-rw-rw-r-- 1 507 507 1549640 Sep  9  2023 ioncube_loader_lin_5.6_ts.so
-rw-rw-r-- 1 507 507 1254608 Sep  9  2023 ioncube_loader_lin_7.0.so
-rw-rw-r-- 1 507 507 1316080 Sep  9  2023 ioncube_loader_lin_7.0_ts.so
-rw-rw-r-- 1 507 507 1355080 Sep  9  2023 ioncube_loader_lin_7.1.so
-rw-rw-r-- 1 507 507 1438760 Sep  9  2023 ioncube_loader_lin_7.1_ts.so
-rw-rw-r-- 1 507 507 1407568 Sep  9  2023 ioncube_loader_lin_7.2.so
-rw-rw-r-- 1 507 507 1489008 Sep  9  2023 ioncube_loader_lin_7.2_ts.so
-rw-rw-r-- 1 507 507 1316800 Sep  9  2023 ioncube_loader_lin_7.3.so
-rw-rw-r-- 1 507 507 1386880 Sep  9  2023 ioncube_loader_lin_7.3_ts.so
-rw-rw-r-- 1 507 507 1363392 Sep  9  2023 ioncube_loader_lin_7.4.so
-rw-rw-r-- 1 507 507 1430848 Sep  9  2023 ioncube_loader_lin_7.4_ts.so
-rw-rw-r-- 1 507 507 1401736 Sep  9  2023 ioncube_loader_lin_8.1.so
-rw-rw-r-- 1 507 507 1506216 Sep  9  2023 ioncube_loader_lin_8.1_ts.so
-rw-rw-r-- 1 507 507 1439016 Sep  9  2023 ioncube_loader_lin_8.2.so
-rw-rw-r-- 1 507 507 1546568 Sep  9  2023 ioncube_loader_lin_8.2_ts.so
-rw-r--r-- 1 507 507   10768 Aug  5  2022 LICENSE.txt
-rw-r--r-- 1 507 507  181104 Aug 15  2022 loader-wizard.php
-rw-r--r-- 1 507 507    4070 Sep  9  2023 README.txt
-rw-r--r-- 1 507 507   39548 Sep  9  2023 USER-GUIDE.pdf
-rw-r--r-- 1 507 507   11269 Sep  9  2023 USER-GUIDE.txt

Comme vous pouvez le voir, l'archive contient plusieurs versions différentes du module pour différentes versions de PHP. Nous devons trouver lesquels de ces fichiers sont nécessaires pour la suite de l'installation.

6. Connaissant votre version de PHP (de la première étape), l'étape suivante consiste à déterminer l'emplacement du répertoire dans lequel vous devez installer IonCube Loader.

php -i | grep extension_dir

Sortie

extension_dir => /usr/lib/php/20210902 => /usr/lib/php/20210902

L'emplacement /usr/lib/php/20210902 sera nécessaire dans la suite du processus d'installation. Dans le système d'exploitation Centos, ce dossier peut ressembler à /usr/lib64/php/modules.

7. Copiez les fichiers IonCube dans le répertoire nécessaire.

sudo cp /tmp/ioncube/ioncube_loader_lin_8.1.so /usr/lib/php/20210902

8. Il est maintenant nécessaire de modifier les fichiers de configuration php.ini. Ils peuvent avoir des emplacements différents selon la configuration du serveur :

sudo nano /etc/php/8.1/cli/php.ini          #для PHP CLI 
sudo nano /etc/php/8.1/fpm/php.ini          #для PHP-FPM & Nginx
sudo nano /etc/php/8.1/apache2/php.ini      #для Apache2

Insérer une ligne du type suivant au tout début du fichier php.ini :

zend_extension = /usr/lib/php/20210902/ioncube_loader_lin_8.1.so

9. Redémarrez le serveur web :

Apache Ubuntu/Debian
sudo systemctl restart apache2
Apache Centos/Rocky/Alma
sudo systemctl restart httpd
Nginx/PHP-FPM
sudo systemctl restart nginx
sudo systemctl restart php-fpm

10. Vérifiez que l'installation est correcte à l'aide de la commande :

php -v

Si l'installation est réussie, la ligne contenant les informations sur la version actuelle de IonCube sera affichée comme suit :

Sortie

PHP 8.1.2-1ubuntu2.17 (cli) (built: May  1 2024 10:10:07) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.1.2, Copyright (c) Zend Technologies
    with the ionCube PHP Loader v13.0.2, Copyright (c) 2002-2023, by ionCube Ltd.
    with Zend OPcache v8.1.2-1ubuntu2.17, Copyright (c), by Zend Technologies

ETAPE 3 : Ajouter un serveur

Allez dans le panneau d'administration.

System Settings/Servers

Cliquez sur Add New Server (Ajouter un nouveau serveur).

Remplissez le formulaire comme sur la capture d'écran ci-dessous.

Dans le champ Module, entrez : PQH

Dans le champ Hostname or IP Address entrez : client.the.hosting

Entrez ensuite les détails de votre compte (login, mot de passe) à partir de client.the.hosting.

Et cliquez sur continuer.

Sur la page suivante, vous devez saisir le nom du serveur (de votre choix) et cliquer sur Enregistrer les modifications.

ETAPE 4 : Administrateur du module

Nous devons créer un nouvel administrateur.

Cela peut être fait en allant dans Paramètres/Gestion des administrateurs.

Cliquez ensuite sur Ajouter un nouvel administrateur

Rôle : Administrateur complet

Nom d'utilisateur (obligatoire !): apisystem

Le reste des données est à votre charge

Exemple (capture d'écran ci-dessous)

ÉTAPE 5. Champs supplémentaires

Les champs tels que le choix du système d'exploitation à l'achat peuvent être configurés en allant dans Paramètres/Paramètres du système/Options configurables.

Cliquez sur le bouton Créer un nouveau groupe, puis définissez le nom du groupe comme vous le souhaitez.

Cliquez sur le bouton Créer un nouveau groupe, puis sur Enregistrer les modifications, puis sur le bouton qui apparaît Ajouter une nouvelle option configurable.

Dans la fenêtre contextuelle, entrez dans le champ Nom de l'option : "Modèle VM".

Ajoutez ensuite la valeur dans le champ Add Options.

Voici une liste de toutes les valeurs prises en charge :

VM6_ISPsystem_Alma-Linux-8
VM6_ISPsystem_Alma-Linux-9
VM6_ISPsystem_Astra-Linux-CE
VM6_ISPsystem_CentOS-8-Stream
VM6_ISPsystem_CentOS-9-Stream
VM6_ISPsystem_Debian-10
VM6_ISPsystem_Debian-11
VM6_ISPsystem_Debian-12
VM6_ISPsystem_FreeBSD-12
VM6_ISPsystem_FreeBSD-13
VM6_ISPsystem_Oracle-Linux-8
VM6_ISPsystem_Rocky-Linux-8
VM6_ISPsystem_Ubuntu-18.04
VM6_ISPsystem_Ubuntu-20.04
VM6_ISPsystem_Ubuntu-22.04
VM6_ISPsystem_VzLinux-8

Cliquez sur Save Changes dans cet onglet et dans l'onglet Configurable Option Groups.

ETAPE 6. Ajouter des produits

Allez dans Réglages/Paramètres du système/Produits, Services

Créez un nouveau groupe en cliquant sur Créer un nouveau groupe.

Remplissez ensuite les champs comme vous le souhaitez

Sauvegardez et allez à nouveau dans Réglages/Paramètres du système/Produits,Services.

1. Cliquez sur Créer un nouveau produit
2. Sélectionnez ensuite (en toute sécurité)
3. Type de produit : Serveur/VPS
4. Module : PQH

Remplissez le reste comme vous le souhaitez

Après avoir sauvegardé, vous pouvez personnaliser ce produit

Dans l'onglet Détails (capture d'écran ci-dessous), vous pouvez personnaliser le produit comme vous le souhaitez (Nom du produit, Titre du produit, Description courte du produit, Description du produit).

La case à cocher de la valeur Require Domain doit être décochée.

N'oubliez pas d'enregistrer les paramètres du produit

Dans l'onglet Prix (capture d'écran ci-dessous), vous pouvez configurer le paiement pour le produit. N'oubliez pas de sauvegarder les paramètres du produit

Dans l'onglet Paramètres du module (capture d'écran ci-dessous)

Sélectionnez (obligatoire) Nom du module : PQH

Sélectionnez ensuite le centre de données et le tarif correspondant à ce produit.

N'oubliez pas de sauvegarder les paramètres du produit

Dans l'onglet Champs personnalisés (capture d'écran ci-dessous), insérez OBLIGATOIREMENT la valeur "VMid" dans le champ Nom du champ.

Personnalisez les autres onglets comme vous le souhaitez.

De plus, pour simplifier le processus d'ajout de produits, nous pouvons les dupliquer (capture d'écran ci-dessous).

ETAPE 7. Test

Créez un utilisateur, rechargez son compte et essayez de commander un service à partir du compte de test. Lors de la commande par l'utilisateur, le module transmettra tous les paramètres à BILLmanager, commandera le serveur automatiquement et lorsque le serveur est activé du côté de BILLmanager, le service sera également activé du côté de WHMCS.