Zum Hauptinhalt springen

FAQ und Fehlerbehebung

Installationsprobleme​

Die Seite ist nach der Installation leer​

Eine leere weiße Seite bedeutet fast immer einen PHP-Fehler, der stillschweigend unterdrückt wird.

  1. Öffnen Sie die Datei storage/logs/laravel.log in einem Dateimanager (dem Dateimanager Ihres Hosting-Kontrollpanels oder FTP). Schauen Sie sich die letzten Zeilen an — dort wird eine Fehlermeldung erklärt, was falsch gelaufen ist.
  2. Häufige Ursachen:
    • Fehlende PHP-Erweiterungen (prüfen Sie die Anforderungsseite)
    • Falsche Dateiberechtigungen (siehe Abschnitt Berechtigungen unten)
    • Falsche Datenbankzugangsdaten in der Konfigurationsdatei

500 Internal Server Error​

Das bedeutet, dass der Server auf einen Fehler gestoßen ist, von dem er sich nicht erholen konnte.

  1. Prüfen Sie storage/logs/laravel.log für die eigentliche Fehlermeldung.
  2. Prüfen Sie das Fehlerprotokoll Ihres Webservers — in cPanel befindet es sich unter Protokolle → Fehlerprotokoll.
  3. Häufigste Ursachen:
    • Falsche Datenbankzugangsdaten
    • Der APP_KEY-Wert fehlt oder ist zu kurz in der Konfigurationsdatei
    • Eine erforderliche PHP-Erweiterung ist nicht aktiviert

Der Installer leitet mich immer wieder zum Anfang zurück​

Das bedeutet normalerweise, dass der Installer nicht auf die Festplatte schreiben kann. Der Installationsprozess erstellt eine Datei namens storage/installed.lock, wenn er abgeschlossen ist. Wenn diese Datei nicht erstellt werden kann, denkt er, dass die Installation nie abgeschlossen wurde.

Lösung: Stellen Sie sicher, dass der Ordner storage/ und alles darin beschreibbar ist. Klicken Sie in Ihrem Hosting-Dateimanager mit der rechten Maustaste auf den Ordner storage und setzen Sie die Berechtigungen auf 755 oder 775.

Datenbankverbindung fehlgeschlagen​

Die Fehlermeldung im Installer lautet "Connection refused" oder "Access denied".

  • Überprüfen Sie den Datenbank-Hostnamen, den Datenbanknamen, den Benutzernamen und das Passwort. Diese werden alle beim Erstellen einer Datenbank in cPanel festgelegt.
  • Der Datenbank-Hostname für cPanel-Hosting ist fast immer localhost.
  • Stellen Sie sicher, dass der Datenbankbenutzer vollständige Berechtigungen für die Datenbank hat.

Berechtigungsfehler (kann nicht in storage oder cache schreiben)​

LeadHub muss in bestimmte Ordner schreiben. Wenn Sie Fehler darüber sehen, dass Dateien nicht geschrieben werden können:

Stellen Sie in Ihrem Hosting-Dateimanager sicher, dass diese Ordner die Berechtigung 755 haben (einige Hosts benötigen 775):

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

E-Mail-Probleme​

E-Mails werden nicht gesendet​

  1. Gehen Sie zu Einstellungen → E-Mail und prüfen Sie, ob alle Felder korrekt ausgefüllt sind.
  2. Klicken Sie auf Test-E-Mail senden und geben Sie Ihre eigene E-Mail-Adresse ein.
  3. Wenn die Test-E-Mail nicht ankommt, prüfen Sie die Datei storage/logs/laravel.log auf SMTP-Fehler.
  4. Stellen Sie sicher, dass der Cron-Job läuft — E-Mails werden über die Job-Warteschlange verarbeitet, die den Cron-Job benötigt. Siehe den Abschnitt Cron-Job unten.

E-Mails landen im Spam​

  • Die häufigste Ursache ist, dass die "From Email"-Adresse nicht mit einer von Ihrem SMTP-Anbieter autorisierten Domain übereinstimmt.
  • Fügen Sie SPF- und DKIM-Einträge zu den DNS-Einstellungen Ihrer Domain hinzu. Ihr E-Mail-Anbieter (SendGrid, Mailgun usw.) wird Ihnen genau sagen, was hinzuzufügen ist.
  • Vermeiden Sie die Verwendung von persönlichen Gmail- oder kostenlosen E-Mail-Adressen als Absenderadresse für transaktionale E-Mails. Verwenden Sie einen professionellen Versanddienst.

Test-E-Mail schlägt fehl​

  • Prüfen Sie Ihre SMTP-Zugangsdaten — schon ein falsches Zeichen verursacht einen Fehler.
  • Bei Gmail müssen Sie ein App-Passwort verwenden, nicht Ihr reguläres Passwort.
  • Port 587 kann bei Shared Hosting blockiert sein. Versuchen Sie stattdessen Port 465 mit SSL.
  • Fragen Sie Ihren Hosting-Anbieter, ob ausgehender SMTP auf dem von Ihnen verwendeten Port erlaubt ist.

Cron-Job-Probleme​

Automatisierungen laufen nicht / Berichte werden nicht geliefert​

LeadHub verwendet einen Cron-Job, um alle Hintergrundarbeiten zu verarbeiten: Automatisierungen, E-Mail-Versand, Berichtslieferung und geplante Aufgaben.

Der Cron-Job-Befehl lautet:

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

Ersetzen Sie /path/to/your/leadhub/ durch den tatsächlichen Pfad auf Ihrem Server.

So richten Sie es in cPanel ein:

  1. Melden Sie sich bei cPanel an.
  2. Gehen Sie zu Cron Jobs.
  3. Setzen Sie die Häufigkeit auf Jede Minute (füllen Sie * für alle fünf Felder aus).
  4. Der Befehl: php /home/yourusername/public_html/cron.php
  5. Klicken Sie auf Neuen Cron-Job hinzufügen.

Wenn Sie sich beim Pfad nicht sicher sind, wenden Sie sich an Ihren Hosting-Anbieter oder schauen Sie sich den vollständigen Pfad im cPanel-Dateimanager an, wenn Sie zum Stammordner Ihrer Website navigieren.

Es gibt keine anderen auszuführenden Befehle. Versuchen Sie nicht, artisan-Befehle von cron aus auszuführen — verwenden Sie nur cron.php.

So prüfen Sie, ob der Cron-Job läuft​

Gehen Sie in cPanel zu Cron Jobs und schauen Sie sich den von Ihnen erstellten Cron-Job an. Wenn er dort aufgelistet ist, ist er geplant. Um zu überprüfen, ob er tatsächlich ausgeführt wird, können Sie vorübergehend >> /tmp/crontest.log 2>&1 am Ende des Befehls hinzufügen, eine Minute warten und dann die Datei auf Ausgabe prüfen.

Probleme mit Lead-Quellen​

Webhook empfängt keine Leads​

  1. Prüfen Sie, ob die Webhook-URL, die Sie im externen Dienst (Facebook, Typeform usw.) konfiguriert haben, genau korrekt ist, einschließlich des Tokens am Ende.
  2. Gehen Sie in LeadHub zu den Integrations- oder Lead-Quellen-Einstellungen und suchen Sie nach einer "Test"- oder "Ping"-Schaltfläche — verwenden Sie sie, um die Verbindung zu überprüfen.
  3. Prüfen Sie storage/logs/laravel.log auf eingehende Webhook-Fehler.
  4. Stellen Sie sicher, dass Ihr Server vom Internet aus erreichbar ist (nicht hinter einer Firewall, die eingehende Verbindungen blockiert).

IMAP-Posteingang wird nicht abgefragt​

Das IMAP-Polling (Prüfen eines E-Mail-Posteingangs auf Leads) erfordert, dass der Cron-Job läuft. Siehe den Abschnitt Cron-Job oben. Wenn der Cron-Job läuft, aber IMAP immer noch nicht abgefragt wird:

  1. Prüfen Sie die IMAP-Verbindungseinstellungen in der Integrationskonfiguration.
  2. Stellen Sie sicher, dass die PHP-Erweiterung php-imap auf Ihrem Server installiert ist.
  3. Prüfen Sie storage/logs/laravel.log auf IMAP-Verbindungsfehler.

Leistungsprobleme bei Shared Hosting​

Die App ist langsam oder läuft in Timeout​

Shared Hosting hat begrenzte Ressourcen. Einige Dinge, die Sie tun können:

PHP-Speicherlimit erhöhen: Fügen Sie diese Zeile zur .htaccess-Datei im Stammordner Ihrer Website hinzu:

php_value memory_limit 256M

Oder bitten Sie Ihren Hosting-Anbieter, es in Ihren PHP-Einstellungen zu erhöhen.

Caching aktivieren: Stellen Sie sicher, dass Ihre Konfigurationsdatei CACHE_DRIVER=file oder CACHE_DRIVER=database enthält. Diese funktionieren auf Shared Hosting ohne zusätzliche Einrichtung.

Warteschlangen-Batch-Größen reduzieren: Wenn Ihr Server Schwierigkeiten mit großen Importen oder Massenoperationen hat, verarbeiten Sie kleinere Stapel.

So Überprüfen Sie die Protokolle​

Die Hauptprotokolldatei befindet sich unter:

storage/logs/laravel.log

Sie können diese in Ihrem Hosting-Dateimanager anzeigen, indem Sie dorthin navigieren und zum Öffnen klicken. Schauen Sie sich das Ende der Datei an — dort erscheinen die neuesten Fehler.

Die Protokolldatei kann mit der Zeit groß werden. Sie können sie sicher löschen (die App erstellt automatisch eine neue).

So Leeren Sie den Cache​

Wenn Sie veraltete Daten oder Seiten sehen, die keine aktuellen Änderungen widerspiegeln, kann das Leeren des Caches helfen.

Tun Sie dies über Ihren Hosting-Dateimanager:

  1. Navigieren Sie zu bootstrap/cache/
  2. Löschen Sie alle Dateien in diesem Ordner (aber nicht den Ordner selbst)
  3. Navigieren Sie zu storage/framework/cache/data/
  4. Löschen Sie alle Dateien und Unterordner in diesem Ordner

Der Cache wird beim nächsten Seitenaufruf automatisch neu aufgebaut.

Löschen Sie nicht die Ordner selbst — nur den Inhalt.

So Führen Sie den Installer Erneut Aus​

Wenn Sie den Installationsassistenten erneut durchlaufen müssen (zum Beispiel nach dem Wechsel zu einer neuen Datenbank):

  1. Navigieren Sie in Ihrem Hosting-Dateimanager zum Ordner storage/.
  2. Löschen Sie die Datei namens installed.lock.
  3. Besuchen Sie Ihre Website in einem Browser — der Installer startet automatisch.

Dadurch werden Ihre Daten nicht gelöscht. Es ermöglicht lediglich dem Installer, erneut zu laufen. Ihre Datenbank und Dateien bleiben intakt.

Häufige Fehler in der Konfigurationsdatei​

Die Konfigurationsdatei (.env) im Stammordner Ihrer Website steuert viele Einstellungen. Häufige Fehler:

  • Fehlender APP_KEY — dies muss eine zufällige 32-Zeichen-Zeichenkette sein. Wenn er fehlt oder falsch ist, startet die App nicht.
  • Falscher DB_HOST — für Shared Hosting ist dies fast immer localhost. Verwenden Sie nicht Ihren Domainnamen.
  • Leerzeichen um = — das Format ist KEY=value ohne Leerzeichen. KEY = value funktioniert nicht.
  • Werte mit Sonderzeichen ohne Anführungszeichen — wenn Ihr Datenbankpasswort # oder & enthält, setzen Sie den gesamten Wert in doppelte Anführungszeichen: DB_PASSWORD="my#p@ss&word"

Hilfe Erhalten​

Wenn Sie ein Problem mit dieser Dokumentation nicht lösen können:

  1. Prüfen Sie zuerst die Protokolldatei unter storage/logs/laravel.log. Die dortige Fehlermeldung sagt Ihnen oft genau, was falsch ist.
  2. Durchsuchen Sie die CodeCanyon-Kommentare auf der LeadHub-Produktseite — viele häufige Probleme wurden dort beantwortet.
  3. Eröffnen Sie ein Support-Ticket auf CodeCanyon, indem Sie zur LeadHub-Produktseite gehen und auf Support klicken. Hängen Sie den relevanten Abschnitt Ihrer Protokolldatei dabei an.

Wenn Sie den Support kontaktieren, geben Sie immer an:

  • Ihre Hosting-Umgebung (Shared Hosting / VPS, welcher Anbieter)
  • Die PHP-Version, die Ihr Server ausführt
  • Die letzten Zeilen von storage/logs/laravel.log