Les files d’attente de travaux sont désactivées

Pour gérer efficacement les tâches lourdes ou répétitives, NexoPOS prend en charge les files d’attente. Elles permettent d’effectuer le traitement en arrière-plan sans affecter les performances de l’application. Par défaut, NexoPOS fonctionne en mode synchrone, ce qui signifie que les tâches sont exécutées immédiatement pendant l’exécution. Bien que cela fonctionne, l’activation des files d’attente est recommandée pour de meilleures performances.

De plus, les tâches planifiées (cron) sont essentielles et doivent toujours être configurées. Elles servent à :

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

Les files d’attente et les tâches cron sont deux fonctionnalités distinctes mais complémentaires. Voici comment configurer chacune d’elles.

Note importante

La configuration de la file d’attente est facultative. NexoPOS fonctionnera sans celle-ci, et toute notification du tableau de bord n’est qu’une recommandation. Toutefois, activer les files d’attente améliore les performances en déchargeant les tâches vers des processus en arrière-plan.

Configuration du fichier .env

Pour activer le traitement de la file d’attente, mettez à jour votre fichier .env en définissant :

QUEUE_CONNECTION=database

La valeur par défaut est « sync », qui exécute les tâches immédiatement au lieu de les exécuter en arrière-plan.

Configuration des tâches planifiées (cron)

La complexité de la configuration des tâches cron dépend de votre environnement. Sur Windows (hors WSL), cela nécessite des tâches planifiées, ce qui peut être moins pratique. Les environnements basés sur Linux (y compris WSL) sont recommandés.

Tâches planifiées sur 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

Remplacez nexopos-directory par votre dossier d’installation réel.

Remarque : le chemin du binaire PHP (/usr/local/bin/php) peut varier. Vous pouvez le vérifier en utilisant :

which php

Tâches planifiées sur Laravel Forge

Laravel Forge offre une interface conviviale pour les tâches cron.

Utilisez la commande suivante (en ajustant la version de PHP et le chemin si nécessaire) :

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

Pour récupérer le chemin correct, exécutez :

pwd

depuis votre répertoire NexoPOS.

Tâches planifiées sur Linux (Ubuntu)

Modifiez la configuration cron pour votre utilisateur :

crontab -e -u username

Ensuite, ajoutez :

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

Remplacez /path/to/nexopos par votre chemin d’installation réel.

Configuration de Supervisor (facultatif)

Le superviseur est utilisé pour gérer des processus d’arrière-plan de longue durée tels que les files d’attente. Bien que ce soit optionnel, il est recommandé pour une expérience plus fluide lors de l’utilisation des files d’attente.

Comme NexoPOS est construit sur Laravel, vous pouvez suivre la documentation officielle de Laravel pour la configuration avancée des files d’attente et de Supervisor.