Home
NexoPOS

Le code delle code sono disabilitate

Per gestire in modo efficiente attività pesanti o ripetitive, NexoPOS supporta le code. Queste consentono l’elaborazione in background senza influire sulle prestazioni dell’applicazione. Per impostazione predefinita, NexoPOS funziona in modalità sincrona, il che significa che le attività vengono eseguite immediatamente durante l’esecuzione. Sebbene funzioni, si consiglia di abilitare le code per ottenere prestazioni migliori.

Inoltre, i job cron sono essenziali e devono essere sempre configurati. Vengono utilizzati per:

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

Le code di coda (queues) e i job cron sono due funzionalità distinte ma complementari. Di seguito è riportato come configurare ciascuna di esse.

Nota importante

La configurazione della coda è facoltativa. NexoPOS funzionerà anche senza di essa e qualsiasi notifica nella dashboard è semplicemente un suggerimento. Tuttavia, abilitare le code migliora le prestazioni, scaricando le attività su processi in background.

Configurazione del file .env

Per abilitare l’elaborazione della coda, aggiorna il file .env impostando:

QUEUE_CONNECTION=database

Il valore predefinito è sync, che esegue le attività immediatamente invece che in background.

Configurazione dei processi Cron

La complessità della configurazione dei job cron dipende dal tuo ambiente. Su Windows (non WSL), ciò richiede Attività pianificate, che possono risultare meno comode. Si consigliano ambienti basati su Linux (incluso WSL).

Cron Jobs su 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

Sostituisci nexopos-directory con la tua cartella di installazione effettiva.

Nota: Il percorso del binario PHP (/usr/local/bin/php) potrebbe variare. Puoi verificarlo usando:

which php

Cron Jobs su Laravel Forge

Laravel Forge offre un’interfaccia user-friendly per i cron job.

laravel-forge-1024x604

Utilizza il seguente comando (regolando la versione di PHP e il percorso secondo necessità):

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

Per recuperare il percorso corretto, esegui:

pwd

all’interno della directory NexoPOS.

Processi pianificati su Linux (Ubuntu)

Modifica il crontab per il tuo utente:

crontab -e -u username

Allora aggiungi:

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

Sostituisci /path/to/nexopos con il percorso di installazione effettivo.

Configurazione di Supervisor (opzionale)

Supervisor viene utilizzato per gestire processi in background a esecuzione prolungata come le code. Sebbene sia facoltativo, è consigliato per un’esperienza più fluida quando si utilizzano le code.

Poiché NexoPOS è costruito su Laravel, puoi seguire la documentazione ufficiale di Laravel per configurare in modo avanzato le code e Supervisor.