Installation et gestion simplifiées des modules WHMCS

Easy Module Installer est un addon WHMCS destiné à simplifier considérablement l’installation, la mise à jour et la gestion des modules WHMCS. Son fonctionnement repose sur une interface d’administration permettant de téléverser un package .zip, puis d’analyser automatiquement son contenu afin de déterminer le type de module, son identifiant, sa version, son auteur et surtout le dossier dans lequel les fichiers doivent être installés.

L’objectif du module est de reproduire une expérience proche d’un installateur de modules de marketplace, sans obliger l’administrateur à extraire manuellement les fichiers ZIP, rechercher le bon dossier WHMCS ou déterminer lui-même la catégorie du module.

Détection automatique des modules

L’une des fonctionnalités principales d’Easy Module Installer est son moteur de détection automatique. Le système analyse la structure du package ainsi que le contenu des fichiers PHP afin d’identifier la catégorie du module.

Il peut notamment reconnaître les :

• Modules Addon WHMCS
• Passerelles de paiement
• Modules Registrar
• Modules de provisioning / serveurs
• Modules de notifications
• Widgets du tableau de bord
• Rapports personnalisés
• Modules antifraude
• Questions de sécurité

Le système utilise différents indices présents dans le code afin d'identifier la catégorie appropriée. Lorsqu’un package contient déjà une structure correspondant à la racine WHMCS, il peut également reconnaître automatiquement un package complet contenant plusieurs composants.

Le module est également capable de gérer certains packages ZIP provenant de dépôts ou d’archives qui contiennent un dossier intermédiaire avant les fichiers réels du module.

Installation par glisser-déposer

L’installation est conçue pour être particulièrement simple. L’administrateur peut déposer un fichier ZIP directement dans l’interface WHMCS, puis Easy Module Installer extrait temporairement son contenu et effectue différentes analyses avant de proposer l’installation.

Le module détermine ensuite le chemin de destination correspondant à la catégorie détectée. Cela évite à l’administrateur de devoir copier manuellement les fichiers dans modules/addons, modules/gateways, modules/servers, modules/registrars ou les autres répertoires concernés.

Le système vérifie également les chemins utilisés afin de limiter les risques de traversée de répertoires et d’empêcher qu’un package ZIP puisse écrire arbitrairement en dehors des emplacements autorisés.

Analyse de sécurité avant installation

Une fonctionnalité particulièrement intéressante est la présence d’un scanner de sécurité statique intégré.

Avant qu’un package soit installé, le module examine le code PHP sans l’exécuter. Il recherche plusieurs comportements considérés comme potentiellement suspects, notamment certaines utilisations de eval(), des chaînes d’obfuscation, certaines fonctions d’exécution de commandes système et des combinaisons pouvant être associées à des webshells ou portes dérobées.

Le scanner peut également détecter certains noms de fichiers utilisant des extensions multiples susceptibles d’être utilisées pour masquer un fichier exécutable.

Cette analyse ne constitue cependant pas un antivirus ou un audit de sécurité complet. Elle fonctionne sur la base de règles et de signatures heuristiques. Un résultat sans alerte ne signifie donc pas qu’un module tiers est nécessairement sûr à 100 %.

Lorsque des éléments présentant un niveau de risque élevé sont détectés, l’installation nécessite une confirmation explicite de l’administrateur, avec une vérification effectuée côté serveur.

Vérification des prérequis

Easy Module Installer intègre également un système de pré-vérification des dépendances et de la compatibilité PHP.

Le module recherche notamment les fichiers composer.json présents dans le package. Il peut identifier les dépendances Composer déclarées et vérifier si le package contient le dossier vendor avec son fichier autoload.php.

Cette fonction permet notamment d’identifier un problème fréquent : installer directement une archive source provenant d’un dépôt GitHub alors que celle-ci ne contient pas les dépendances Composer nécessaires.

Le module vérifie également la version PHP actuellement utilisée par WHMCS et compare celle-ci aux contraintes PHP déclarées dans les fichiers Composer lorsque celles-ci peuvent être interprétées.

Les informations concernant la version de WHMCS détectée sont également affichées. Les versions WHMCS éventuellement mentionnées dans le README ou la documentation du module sont présentées comme indications et non comme une règle de blocage automatique.

Gestion des mises à jour et écrasements

Lorsque le module détecte qu’un package existe déjà sur le serveur, Easy Module Installer peut identifier cette situation avant l’installation.

Selon la configuration définie par l’administrateur, l’écrasement d’un module existant peut être autorisé ou bloqué. Lorsqu’il est autorisé, une confirmation supplémentaire est demandée avant de remplacer les fichiers existants.

Cette fonctionnalité permet donc d’utiliser l’outil aussi bien pour une première installation que pour la mise à jour d’un module existant.

Désinstallation des modules

Easy Module Installer ne se limite pas à l’installation. Il possède également une section dédiée à la désinstallation des modules présents sur le serveur.

Le système analyse les répertoires de modules WHMCS reconnus et affiche les modules trouvés par catégorie. L’administrateur peut rechercher un module par nom, identifiant ou chemin, puis sélectionner celui qu’il souhaite supprimer.

Une confirmation explicite est nécessaire avant la suppression des fichiers.

Le module possède également une protection empêchant sa propre désinstallation depuis son interface, afin d’éviter qu’il ne supprime accidentellement les fichiers nécessaires à son fonctionnement pendant l’opération.

Historique des opérations

Chaque installation, mise à jour ou désinstallation peut être enregistrée dans une table dédiée de la base de données WHMCS.

L’historique conserve notamment l’administrateur ayant effectué l’opération, le type de module, son identifiant, son nom, sa version, le chemin cible, l’action réalisée, le nombre de fichiers copiés et l’adresse IP.

Un système de nettoyage automatique permet également de supprimer les anciennes entrées après un nombre de jours défini dans la configuration. Il est possible de désactiver cette purge automatique afin de conserver l’historique indéfiniment.

Gestion des permissions

Le module intègre deux permissions distinctes pour les administrateurs WHMCS :

• Install Modules : autorise l’installation et la mise à jour.
• Uninstall Modules : autorise la suppression.

Sécurité technique

Le module utilise une protection CSRF pour ses opérations sensibles. Les fichiers ZIP sont placés dans une zone temporaire et plusieurs contrôles sont appliqués aux chemins.

Le moteur ZIP impose des limites sur le nombre de fichiers, la taille totale décompressée et la taille maximale d’un fichier individuel afin de réduire les risques liés aux archives volumineuses ou malveillantes.

Les noms de fichiers ZIP sont également contrôlés pour empêcher les chemins absolus, les séquences de traversée de répertoires et certains formats dangereux.

Interface et gestion des modules

Easy Module Installer propose une section permettant d’accéder rapidement aux zones de gestion des modules WHMCS.

Le système s’adapte aux différentes versions de WHMCS en recherchant les pages disponibles et, pour les versions récentes, en utilisant les sections Apps & Integrations.

Le module inclut des fichiers de langue en français et anglais.

Conclusion

Easy Module Installer est bien plus qu’un simple extracteur ZIP. Il automatise l’identification, l’analyse, la vérification des prérequis, l’installation, la mise à jour, la désinstallation et la journalisation des modules WHMCS.

Son avantage principal est de réduire les manipulations techniques tout en ajoutant des contrôles de sécurité et de compatibilité.

Son scanner reste une analyse heuristique et ne remplace pas un audit complet ou un antivirus.

Dans l’ensemble, Easy Module Installer est un gestionnaire d’installation WHMCS orienté simplicité, automatisation, sécurité et traçabilité.