Aller au contenu principal

FAQ et Dépannage

Problèmes d'Installation​

La page est blanche après l'installation​

Une page blanche signifie presque toujours une erreur PHP qui est silencieusement supprimée.

  1. Ouvrez le fichier storage/logs/laravel.log dans un gestionnaire de fichiers (le Gestionnaire de Fichiers de votre panneau d'hébergement, ou FTP). Regardez les dernières lignes — il y aura un message d'erreur expliquant ce qui s'est passé.
  2. Causes courantes :
    • Extensions PHP manquantes (vérifiez la page des prérequis)
    • Mauvaises permissions de fichiers (voir la section permissions ci-dessous)
    • Mauvaises informations d'identification de base de données dans le fichier de configuration

Erreur 500 Internal Server Error​

Cela signifie que le serveur a rencontré une erreur dont il n'a pas pu se remettre.

  1. Vérifiez storage/logs/laravel.log pour le message d'erreur réel.
  2. Vérifiez le journal d'erreurs de votre serveur web — dans cPanel, il se trouve sous Journaux → Journal d'Erreurs.
  3. Causes les plus courantes :
    • Mauvaises informations d'identification de base de données
    • La valeur APP_KEY est manquante ou trop courte dans le fichier de configuration
    • Une extension PHP requise n'est pas activée

L'installateur continue de me rediriger vers le début​

Cela signifie généralement que l'installateur ne peut pas écrire sur le disque. Le processus d'installation crée un fichier appelé storage/installed.lock quand il se termine. S'il ne peut pas créer ce fichier, il pense que l'installation n'a jamais été terminée.

Correction : Assurez-vous que le dossier storage/ et tout ce qu'il contient est accessible en écriture. Dans le gestionnaire de fichiers de votre hébergement, faites un clic droit sur le dossier storage et définissez les permissions à 755 ou 775.

Échec de connexion à la base de données​

Le message d'erreur dans l'installateur dira "Connection refused" ou "Access denied".

  • Vérifiez le nom d'hôte de la base de données, le nom de la base de données, le nom d'utilisateur et le mot de passe. Tout cela est défini lors de la création d'une base de données dans cPanel.
  • Le nom d'hôte de la base de données pour l'hébergement cPanel est presque toujours localhost.
  • Assurez-vous que l'utilisateur de la base de données a des permissions complètes sur la base de données.

Erreurs de permissions (impossible d'écrire dans storage ou cache)​

LeadHub doit écrire dans certains dossiers. Si vous voyez des erreurs indiquant qu'il est impossible d'écrire des fichiers :

Dans le gestionnaire de fichiers de votre hébergement, assurez-vous que ces dossiers sont définis avec la permission 755 (certains hôtes ont besoin de 775) :

  • storage/
  • storage/logs/
  • storage/framework/
  • storage/app/
  • bootstrap/cache/

Problèmes d'Email​

Les emails ne sont pas envoyés​

  1. Allez dans Paramètres → Email et vérifiez que tous les champs sont correctement remplis.
  2. Cliquez sur Envoyer un Email de Test et entrez votre propre adresse email.
  3. Si l'email de test n'arrive pas, vérifiez le fichier storage/logs/laravel.log pour toute erreur SMTP.
  4. Assurez-vous que le cron job s'exécute — les emails passent par la file d'attente des tâches, qui a besoin du cron job pour les traiter. Voir la section Cron Job ci-dessous.

Les emails arrivent dans le spam​

  • La cause la plus courante est que l'adresse "From Email" ne correspond pas à un domaine autorisé par votre fournisseur SMTP.
  • Ajoutez des enregistrements SPF et DKIM aux paramètres DNS de votre domaine. Votre fournisseur d'email (SendGrid, Mailgun, etc.) vous dira exactement quoi ajouter.
  • Évitez d'utiliser Gmail personnel ou des adresses email gratuites comme adresse expéditeur pour les emails transactionnels. Utilisez un service d'envoi professionnel.

L'email de test échoue​

  • Vérifiez vos identifiants SMTP — même un mauvais caractère provoque un échec.
  • Pour Gmail, vous devez utiliser un Mot de Passe d'Application, pas votre mot de passe habituel.
  • Le port 587 peut être bloqué sur l'hébergement partagé. Essayez le port 465 avec SSL à la place.
  • Demandez à votre hébergeur si le SMTP sortant est autorisé sur le port que vous utilisez.

Problèmes de Cron Job​

Les automatisations ne s'exécutent pas / Les rapports ne sont pas livrés​

LeadHub utilise un cron job pour traiter tout le travail en arrière-plan : automatisations, envoi d'emails, livraison de rapports et tâches planifiées.

La commande du cron job est :

php /path/to/your/leadhub/cron.php

Remplacez /path/to/your/leadhub/ par le chemin réel sur votre serveur.

Pour le configurer dans cPanel :

  1. Connectez-vous à cPanel.
  2. Allez dans Cron Jobs.
  3. Définissez la fréquence sur Chaque Minute (remplissez * pour les cinq champs).
  4. La commande : php /home/yourusername/public_html/cron.php
  5. Cliquez sur Ajouter un Nouveau Cron Job.

Si vous n'êtes pas sûr du chemin, vérifiez avec votre hébergeur, ou regardez le chemin complet affiché dans le Gestionnaire de Fichiers cPanel lorsque vous naviguez vers le dossier racine de votre site.

Il n'y a pas d'autres commandes à exécuter. N'essayez pas d'exécuter des commandes artisan depuis cron — utilisez uniquement cron.php.

Comment vérifier si le cron job s'exécute​

Dans cPanel, allez dans Cron Jobs et regardez le cron job que vous avez créé. S'il est listé là, il est planifié. Pour vérifier qu'il s'exécute réellement, vous pouvez ajouter temporairement >> /tmp/crontest.log 2>&1 à la fin de la commande, attendre une minute, puis vérifier le fichier pour voir la sortie.

Problèmes de Sources de Leads​

Le webhook ne reçoit pas de leads​

  1. Vérifiez que l'URL du webhook que vous avez configurée dans le service externe (Facebook, Typeform, etc.) est exactement correcte, y compris le token à la fin.
  2. Dans LeadHub, allez dans les paramètres d'intégration ou de source de leads et cherchez un bouton "Test" ou "Ping" — utilisez-le pour vérifier la connexion.
  3. Vérifiez storage/logs/laravel.log pour toute erreur de webhook entrant.
  4. Assurez-vous que votre serveur est accessible depuis internet (pas derrière un pare-feu bloquant les connexions entrantes).

La boîte de réception IMAP n'est pas interrogée​

L'interrogation IMAP (vérification d'une boîte de réception email pour les leads) nécessite que le cron job s'exécute. Voir la section Cron Job ci-dessus. Si le cron job s'exécute mais IMAP n'est toujours pas interrogé :

  1. Vérifiez les paramètres de connexion IMAP dans la configuration de l'intégration.
  2. Assurez-vous que l'extension PHP php-imap est installée sur votre serveur.
  3. Vérifiez storage/logs/laravel.log pour les erreurs de connexion IMAP.

Problèmes de Performances sur Hébergement Partagé​

L'application est lente ou expire​

L'hébergement partagé a des ressources limitées. Quelques choses que vous pouvez faire :

Augmenter la limite de mémoire PHP : Ajoutez cette ligne au fichier .htaccess dans le dossier racine de votre site :

php_value memory_limit 256M

Ou demandez à votre hébergeur de l'augmenter dans vos paramètres PHP.

Activer la mise en cache : Assurez-vous que votre fichier de configuration a CACHE_DRIVER=file ou CACHE_DRIVER=database. Ceux-ci fonctionnent sur l'hébergement partagé sans configuration supplémentaire.

Réduire la taille des lots de file d'attente : Si votre serveur a du mal avec les importations volumineuses ou les opérations en masse, traitez des lots plus petits.

Comment Consulter les Journaux​

Le fichier journal principal se trouve à :

storage/logs/laravel.log

Vous pouvez le voir dans le gestionnaire de fichiers de votre hébergement en y naviguant et en cliquant pour l'ouvrir. Regardez le bas du fichier — c'est là qu'apparaissent les erreurs les plus récentes.

Le fichier journal peut devenir volumineux avec le temps. Vous pouvez le supprimer sans risque (l'application en crée automatiquement un nouveau).

Comment Vider le Cache​

Si vous voyez des données obsolètes ou des pages qui ne reflètent pas les changements récents, vider le cache peut aider.

Faites ceci via le gestionnaire de fichiers de votre hébergement :

  1. Naviguez vers bootstrap/cache/
  2. Supprimez tous les fichiers dans ce dossier (mais pas le dossier lui-même)
  3. Naviguez vers storage/framework/cache/data/
  4. Supprimez tous les fichiers et sous-dossiers dans ce dossier

Le cache se reconstruit automatiquement au prochain chargement de page.

Ne supprimez pas les dossiers eux-mêmes — seulement leur contenu.

Comment Relancer l'Installateur​

Si vous devez repasser par l'assistant d'installation (par exemple, après avoir migré vers une nouvelle base de données) :

  1. Dans le gestionnaire de fichiers de votre hébergement, naviguez vers le dossier storage/.
  2. Supprimez le fichier nommé installed.lock.
  3. Visitez votre site dans un navigateur — l'installateur démarrera automatiquement.

Cela ne supprime pas vos données. Cela permet simplement à l'installateur de s'exécuter à nouveau. Votre base de données et vos fichiers restent intacts.

Erreurs Courantes dans le Fichier de Configuration​

Le fichier de configuration (.env) dans le dossier racine de votre site contrôle de nombreux paramètres. Erreurs courantes :

  • APP_KEY manquant — cela doit être une chaîne aléatoire de 32 caractères. S'il est manquant ou incorrect, l'application ne démarrera pas.
  • DB_HOST incorrect — pour l'hébergement partagé, c'est presque toujours localhost. N'utilisez pas votre nom de domaine.
  • Espaces autour de = — le format est KEY=value sans espaces. KEY = value ne fonctionne pas.
  • Valeurs avec des caractères spéciaux non entre guillemets — si votre mot de passe de base de données contient # ou &, entourez toute la valeur de guillemets doubles : DB_PASSWORD="my#p@ss&word"

Obtenir de l'Aide​

Si vous ne pouvez pas résoudre un problème en utilisant cette documentation :

  1. Vérifiez le fichier journal à storage/logs/laravel.log d'abord. Le message d'erreur là-dedans vous dit souvent exactement ce qui ne va pas.
  2. Recherchez dans les commentaires CodeCanyon sur la page du produit LeadHub — beaucoup de problèmes courants ont été répondus là-bas.
  3. Ouvrez un ticket de support sur CodeCanyon en allant sur la page du produit LeadHub et en cliquant sur Support. Joignez la section pertinente de votre fichier journal lorsque vous le faites.

Lors de la prise de contact avec le support, incluez toujours :

  • Votre environnement d'hébergement (hébergement partagé / VPS, quel fournisseur)
  • La version PHP que votre serveur utilise
  • Les dernières lignes de storage/logs/laravel.log