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
- In cPanel, search for Cron Jobs. If unavailable, contact your hosting provider.
- Configure the job to run every minute.
- Use the following command:
cd /home/user/public_html/nexopos-directory && /usr/local/bin/php artisan schedule:run >> /dev/null 2>&1
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.
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.