Tipps
Praktische Tipps und häufige Stolperfallen beim Betrieb von Laravel-Anwendungen auf Herne.
Checkliste für das erste Deployment
Migration von public nach web_root — Wenn Sie ein altes Layout migrieren, verschieben Sie das vorhandene public/-Verzeichnis zuerst nach web_root.
- Erstellen Sie die Website und führen Sie den Setup-Assistenten aus, um Git-Repo,
.envund Datenbank zu konfigurieren. - Wenn Sie eine ältere Website aktualisieren, verschieben Sie das alte
/var/www/domain/public-Verzeichnis auf/var/www/domain/web_root, bevor Sie die Dokumentwurzel wechseln. - Nach dem ersten Deploy: Falls APP_KEY leer ist, führen Sie php artisan key:generate im Artisan-Runner aus.
- Führen Sie
storage:linkaus dem Artisan-Löser aus, wenn Ihre ApppublicFestplattenspeicher verwendet. - Führen Sie
migrate --forceaus dem Artisan Runner aus oder aktivieren Sie den Migrationsschritt in Deploy Config.
Schnellinstallation erneut versuchen
Wenn WebBlocks CMS Quick Install fehlschlägt, öffnen Sie die App-Logs, beheben Sie die gemeldete Datenbank, Berechtigung, DNS oder Laufzeitproblem und verwenden Sie dann Installieren Sie erneut. Der Installer bereinigt sichere Teildateien vor dem erneuten Versuch und schützt abgeschlossene Installationen vor Überschreiben.
Empfehlungen für Umgebungseinstellungen
- Setzen Sie APP_ENV=production und APP_DEBUG=false in .env für alle Live-Websites.
- Nach dem Ändern von
.env, laufenoptimize:clearoder bauen Sie Caches aus dem Artisan Runner neu auf. - Setze
SESSION_DRIVER=fileoderdatabase— vermeidecookiebei der Produktion. - Wenn Sie Aufträge in Warteschlangen verwenden, setzen Sie
QUEUE_CONNECTION=database(oderredis). Setzen Sie im Produktivbetrieb niesyncein.
DNS und SSL
- Die DNS-Verbreitung kann einige Zeit in Anspruch nehmen. Halten Sie einen Datensatz-Mismatches streng; ignorieren Sie nicht einen Hostnamen, der auf den falschen Server zeigt.
- Admins können mehrere Hetzner DNS-Konten unter Admin → DNS-Verbindungen hinzufügen. Fügen Sie jede Domäne an die Verbindung an, die ihre Zone besitzt.
- Wenn eine Zone zu einem anderen Hetzner-Konto wechselt, aktualisieren Sie das Token oder fügen Sie die Domain an die neue Verbindung an und verwenden Sie DNS-Zone neu verbinden.
- Für migrierte externe DNS-Zonen können apex NS-Warnungen informationell sein, wenn der A-Record korrekt ist.
- Nach dem Hinzufügen von Aliase, verwenden Einstellungen → SSL / HTTPS → SSL erneut synchronisieren so Herne prüft Live-Zertifikat Abdeckung.
Den Anwendungstyp korrigieren
Wenn eine Site als Leer / Deployment-Ziel oder Statische Website erstellt wurde, aber ein Operator später Laravel mit dem /public Dokumentstamm in sein kanonisches web_root einführte, kann ein Administrator Website → Einstellungen → Allgemein → Anwendungslaufzeit öffnen und Wechsel zu Laravel auswählen.
Damit werden nur die Herne-Verwaltungsmetadaten korrigiert. Der Vorgang installiert Laravel nicht, prüft oder repariert die Anwendung nicht, verschiebt keine Dateien, ändert Nginx nicht, führt keine Migrationen aus und startet keinen Queue Worker. Überprüfen Sie die bereitgestellte Anwendung vor der Bestätigung separat und führen Sie danach die Vorprüfung jeder Laravel-spezifischen Funktion aus.
Queue Worker
Herne verwaltet keine Schlangenarbeiter. Um Warteschlangenarbeiter zu führen:
- Gehe zu Server → Cron-Jobs
- Hinzufügen:
* * * * * cd /var/www/domain && php artisan queue:work --stop-when-empty >> /dev/null 2>&1
Dies führt den Arbeiter jede Minute und verlässt, wenn die Warteschlange leer ist (sicherer als ein lang andauernder Prozess unter cron).
Speicherberechtigungen
Wenn Sie Berechtigung verweigert Fehler auf storage/ oder bootstrap/cache/ erhalten, führen Sie aus dem Terminal:
chmod -R 775 storage bootstrap/cache
Langsames erstes Laden
Nach dem Aktivieren des Config/Route-Cachings über Deploy Config kann die erste Anforderung nach einer neuen Bereitstellung langsam sein, während sich der OPcache aufwärmt. Das ist normal.
WebBlocks-UI-Ressourcen
Herne lädt WebBlocks UI durch resources/views/partials/_webblocks-assets.blade.php und App\Support\WebBlocksUiAssets. Fügen Sie keine neuen Verweise zum entfernten /public/webblocks-ui Asset-Ordner hinzu.