Startseite
NexoPOS

Warteschlangenjobs sind deaktiviert

Um schwere oder wiederkehrende Aufgaben effizient zu bewältigen, unterstützt NexoPOS Warteschlangen (Queues). Diese ermöglichen eine Verarbeitung im Hintergrund, ohne die Anwendungsleistung zu beeinträchtigen. Standardmäßig läuft NexoPOS im synchronen Modus, d. h. Aufgaben werden während der Laufzeit sofort ausgeführt. Obwohl das funktioniert, wird empfohlen, Warteschlangen für eine bessere Performance zu aktivieren.

Darüber hinaus sind Cron-Jobs unerlässlich und sollten immer konfiguriert werden. Sie werden verwendet für:

  • Trigger scheduled transactions
  • Clear expired orders
  • Detect low-stock products
  • Perform system checks
  • And more

Warteschlangen und Cron-Jobs sind zwei unterschiedliche, aber sich ergänzende Funktionen. Nachfolgend wird beschrieben, wie jede einzelne konfiguriert wird.

Wichtiger Hinweis

Die Queue-Konfiguration ist optional. NexoPOS funktioniert auch ohne sie, und jede Dashboard-Benachrichtigung ist lediglich eine Empfehlung. Durch das Aktivieren von Queues wird die Leistung jedoch verbessert, da Aufgaben auf Hintergrundprozesse ausgelagert werden.

Konfigurieren der .env-Datei

Um die Warteschlangenverarbeitung zu aktivieren, aktualisieren Sie Ihre .env-Datei, indem Sie Folgendes festlegen:

QUEUE_CONNECTION=database

Der Standardwert ist „sync“, wodurch Aufgaben sofort ausgeführt werden, statt im Hintergrund.

Cron-Jobs konfigurieren

Die Komplexität der Einrichtung von Cron-Jobs hängt von Ihrer Umgebung ab. Unter Windows (ohne WSL) erfordert dies Geplante Aufgaben, was weniger bequem sein kann. Linux-basierte Umgebungen (einschließlich WSL) werden empfohlen.

Cron-Jobs auf cPanel

  1. In cPanel, search for Cron Jobs. If unavailable, contact your hosting provider.
  2. Configure the job to run every minute.
  3. Use the following command:
cd /home/user/public_html/nexopos-directory && /usr/local/bin/php artisan schedule:run >> /dev/null 2>&1
capture-decran-2024-12-27-112231

Ersetzen Sie „nexopos-directory“ durch Ihren tatsächlichen Installationsordner.

Hinweis: Der Pfad zur PHP-Binärdatei (/usr/local/bin/php) kann variieren. Sie können ihn wie folgt überprüfen:

which php

Cron-Jobs auf Laravel Forge

Laravel Forge bietet eine benutzerfreundliche Oberfläche für Cron-Jobs.

laravel-forge-1024x604

Verwenden Sie den folgenden Befehl (passen Sie die PHP-Version und den Pfad nach Bedarf an):

php8.3 /home/username/nexopos/artisan schedule:run

Um den richtigen Pfad abzurufen, führen Sie Folgendes aus:

pwd

aus Ihrem NexoPOS-Verzeichnis heraus.

Cron-Jobs unter Linux (Ubuntu)

Bearbeite die Crontab für deinen Benutzer:

crontab -e -u username

Dann füge hinzu:

* * * * * cd /path/to/nexopos && php artisan schedule:run >> /dev/null 2>&1

Ersetzen Sie „/path/to/nexopos“ durch Ihren tatsächlichen Installationspfad.

Supervisor konfigurieren (optional)

Supervisor wird verwendet, um lang laufende Hintergrundprozesse wie Warteschlangen zu verwalten. Obwohl optional, wird es für ein reibungsloseres Erlebnis empfohlen, wenn Warteschlangen verwendet werden.

Da NexoPOS auf Laravel basiert, können Sie der offiziellen Laravel-Dokumentation für erweiterte Queue- und Supervisor-Konfiguration folgen.