Aller au contenu principal

Problèmes d'installation

Échec du téléversement du module​

Problème : Le fichier zip du module ne se téléverse pas via le panneau d'administration de Perfex.

Causes et solutions :

CauseSolution
La taille du fichier dépasse la limite de téléversement PHPAugmentez upload_max_filesize et post_max_size dans php.ini à au moins 64M
Délai d'attente du serveur dépassé pendant le téléversementAugmentez max_execution_time dans php.ini à 300
Problème de permissionsVérifiez que le répertoire modules/ est accessible en écriture (chmod 755)

Alternative : Téléversez via FTP/SFTP à la place :

  1. Extrayez le zip sur votre ordinateur
  2. Téléversez le dossier extrait vers your-perfex/modules/
  3. Activez via Setup → Modules dans le panneau d'administration

Module non visible après le téléversement​

Problème : Vous avez téléversé le module mais il n'apparaît pas dans Setup → Modules.

Solutions :

  1. Assurez-vous que la structure des dossiers est correcte : modules/saas/ (pas modules/saas-module/ ni modules/saas/saas/)
  2. Vérifiez que tous les fichiers ont été téléversés complètement (comparez le nombre de fichiers)
  3. Videz le cache de votre navigateur et rafraîchissez la page
  4. Vérifiez les permissions des fichiers : tout le répertoire modules/saas/ doit être lisible par le serveur web

Échec de la vérification MySQL​

Problème : Cliquer sur « Click here to verify server settings » affiche une erreur.

Erreur : « Access denied for user »​

Cause : Nom d'utilisateur ou mot de passe MySQL incorrect.

Correction :

  1. Revérifiez vos identifiants MySQL
  2. Si vous utilisez cPanel, essayez d'utiliser votre nom d'utilisateur et mot de passe cPanel
  3. Testez les identifiants manuellement :
mysql -u your_username -p -h localhost
# Entrez votre mot de passe lorsque demandé
# Si vous pouvez vous connecter, les identifiants sont corrects

Erreur : « Can't connect to MySQL server »​

Cause : MySQL n'est pas en cours d'exécution ou l'hôte/port est incorrect.

Correction :

  1. Vérifiez si MySQL est en cours d'exécution : sudo systemctl status mysql
  2. Vérifiez que l'hôte est correct (généralement localhost)
  3. Vérifiez que le port est correct (généralement 3306)
  4. Si MySQL est sur un serveur différent, utilisez l'adresse IP de ce serveur

Erreur : « CREATE command denied »​

Cause : L'utilisateur MySQL n'a pas la permission de créer des bases de données.

Correction :

-- Connectez-vous à MySQL en tant que root :
GRANT ALL PRIVILEGES ON *.* TO 'your_username'@'localhost' WITH GRANT OPTION;
FLUSH PRIVILEGES;

Ou dans cPanel : Allez dans MySQL Databases → User Privileges → Cochez « ALL PRIVILEGES »

Page blanche après l'activation​

Problème : Après l'activation du module, vous voyez une page blanche.

Solutions :

  1. Vérifiez les journaux d'erreurs PHP : Consultez /var/log/apache2/error.log (Apache) ou /var/log/nginx/error.log (Nginx)
  2. Activez temporairement l'affichage des erreurs : Ajoutez dans votre .htaccess ou index.php : 
    ini_set('display_errors', 1);
    error_reporting(E_ALL);
  3. Vérifiez la version PHP : Assurez-vous d'exécuter PHP 7.4 ou supérieur
  4. Vérifiez la limite mémoire : Définissez memory_limit = 256M dans php.ini

Le formulaire d'inscription ne s'affiche pas​

Problème : La page d'accueil n'affiche pas de formulaire d'inscription.

Solutions :

  1. Assurez-vous d'avoir créé au moins un plan dans SaaS Management → Plans
  2. Vérifiez que les inscriptions sont activées dans SaaS Management → SuperAdmin Settings → Tenants Settings
  3. Vérifiez que l'URL de la page d'accueil est correcte dans Landing Page Settings
  4. Essayez de sélectionner un modèle de page d'accueil différent
  5. Videz le cache de votre navigateur

E-mails non envoyés​

Problème : Les e-mails de bienvenue, de vérification ou de facture ne sont pas envoyés.

Solutions :

  1. Configurez SMTP dans Perfex CRM : Allez dans Setup → Email → Email Settings
  2. Services SMTP recommandés :
    • Gmail SMTP (gratuit jusqu'à 500 e-mails/jour)
    • SendGrid (niveau gratuit : 100 e-mails/jour)
    • Mailgun (niveau gratuit : 5 000 e-mails/mois)
  3. Testez l'envoi d'e-mails depuis Setup → Email → Send Test Email
  4. Vérifiez votre dossier spam — les e-mails pourraient y arriver
info

SMTP est crucial ! Sans SMTP configuré, aucun e-mail ne sera envoyé depuis votre plateforme — y compris les e-mails de vérification, les e-mails de bienvenue et les factures. Configurez-le en premier !

Base de données du locataire non créée​

Problème : Le locataire s'inscrit mais sa base de données n'est pas créée.

Solutions :

  1. Vérifiez les identifiants MySQL dans les paramètres SaaS (cliquez sur le bouton de vérification)
  2. Vérifiez si votre utilisateur MySQL a le privilège CREATE DATABASE
  3. Si vous êtes sur un hébergement mutualisé, vérifiez si vous avez atteint votre limite de bases de données
  4. Consultez le journal d'activité SaaS pour les détails de l'erreur
  5. Vérifiez les journaux d'erreurs PHP pour les erreurs spécifiques à MySQL

Erreur « Maximum database connections »​

Problème : Erreur concernant trop de connexions à la base de données.

Solutions :

  1. Augmentez max_connections de MySQL dans my.cnf : 
    [mysqld]
    max_connections = 200
  2. Redémarrez MySQL : sudo systemctl restart mysql
  3. Envisagez d'optimiser votre serveur (plus de RAM) si vous avez de nombreux locataires
astuce

Problème résolu ? Si vous rencontrez toujours des difficultés, consultez Problèmes de domaine et DNS ou contactez le Support.