Queue Workers

XetaSuite utilise les queues Laravel pour les tâches asynchrones : envoi d’emails, génération de rapports, etc.

Configuration

Driver recommandé : Redis

QUEUE_CONNECTION=redis
REDIS_HOST=127.0.0.1
REDIS_PORT=6379

Alternative : Database

QUEUE_CONNECTION=database

Créer la table de jobs :

php artisan queue:table
php artisan migrate

Lancer un worker

Développement

php artisan queue:work

Production

Utilisez un process manager pour maintenir les workers actifs.

Supervisor

Créez /etc/supervisor/conf.d/xetasuite-worker.conf :

[program:xetasuite-worker]
process_name=%(program_name)s_%(process_num)02d
command=php /var/www/xetasuite-core/artisan queue:work redis --sleep=3 --tries=3 --max-time=3600
autostart=true
autorestart=true
stopasgroup=true
killasgroup=true
user=www-data
numprocs=2
redirect_stderr=true
stdout_logfile=/var/www/xetasuite-core/storage/logs/worker.log
stopwaitsecs=3600

Activer :

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start xetasuite-worker:*

Systemd

Créez /etc/systemd/system/xetasuite-worker.service :

[Unit]
Description=XetaSuite Queue Worker
After=network.target

[Service]
User=www-data
Group=www-data
Restart=always
ExecStart=/usr/bin/php /var/www/xetasuite-core/artisan queue:work redis --sleep=3 --tries=3 --max-time=3600
StandardOutput=append:/var/www/xetasuite-core/storage/logs/worker.log
StandardError=append:/var/www/xetasuite-core/storage/logs/worker-error.log

[Install]
WantedBy=multi-user.target

Activer :

sudo systemctl enable xetasuite-worker
sudo systemctl start xetasuite-worker

Laravel Forge

1. Aller dans Servers → votre serveur
2. Cliquez sur Queue dans le menu
3. Configurer :
   • Connection : redis
   • Queue : default
   • Processes : 2
4. Cliquez sur Create Worker

Commandes utiles

Surveiller les workers

php artisan queue:monitor redis:default

Voir les jobs en échec

php artisan queue:failed

Retenter les jobs en échec

# Retenter tous
php artisan queue:retry all

# Retenter un spécifique
php artisan queue:retry 5

Purger les jobs en échec

php artisan queue:flush

Redémarrer après déploiement

Caution

Les workers doivent être redémarrés après le déploiement pour charger les nouvelles modifications.

php artisan queue:restart

Cette commande signale aux workers de redémarrer gracieusement après avoir terminé leur job en cours.

Horizon (Optionnel)

Pour une gestion plus avancée des queues, envisagez d’utiliser Laravel Horizon :

composer require laravel/horizon
php artisan horizon:install
php artisan migrate

Lancer Horizon :

php artisan horizon

Accédez au dashboard à /horizon.