Las colas de trabajos están deshabilitadas

Para gestionar de manera eficiente tareas pesadas o repetitivas, NexoPOS admite colas. Estas permiten el procesamiento en segundo plano sin afectar el rendimiento de la aplicación. De forma predeterminada, NexoPOS se ejecuta en modo síncrono, lo que significa que las tareas se ejecutan inmediatamente durante el tiempo de ejecución. Aunque esto funciona, se recomienda habilitar las colas para obtener un mejor rendimiento.

Además, los trabajos cron son esenciales y siempre deben configurarse. Se utilizan para:

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

Las colas y los trabajos cron son dos funciones distintas pero complementarias. A continuación se muestra cómo configurar cada una.

Nota importante

La configuración de la cola es opcional. NexoPOS funcionará sin ella y cualquier notificación del panel es simplemente una recomendación. Sin embargo, habilitar las colas mejora el rendimiento al descargar tareas a procesos en segundo plano.

Configurando el archivo .env

Para habilitar el procesamiento de la cola, actualiza tu archivo .env configurando:

QUEUE_CONNECTION=database

El valor predeterminado es sync, que ejecuta las tareas inmediatamente en lugar de en segundo plano.

Configurando trabajos cron

La complejidad de configurar trabajos cron depende de tu entorno. En Windows (sin WSL), esto requiere Tareas programadas, que pueden resultar menos convenientes. Se recomiendan entornos basados en Linux (incluido WSL).

Trabajos programados en 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

Reemplaza nexopos-directory por tu carpeta de instalación real.

Nota: La ruta del binario de PHP (/usr/local/bin/php) puede variar. Puedes confirmarla usando:

which php

Trabajos programados en Laravel Forge

Laravel Forge ofrece una interfaz fácil de usar para trabajos cron.

Usa el siguiente comando (ajustando la versión de PHP y la ruta según sea necesario):

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

Para recuperar la ruta correcta, ejecuta:

pwd

desde dentro de su directorio NexoPOS.

Trabajos programados en Linux (Ubuntu)

Edita el crontab para tu usuario:

crontab -e -u username

Luego agrega:

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

Reemplaza /path/to/nexopos con tu ruta de instalación real.

Configurando Supervisor (Opcional)

El supervisor se utiliza para gestionar procesos en segundo plano de larga duración, como colas. Aunque es opcional, se recomienda para una experiencia más fluida al usar colas.

Dado que NexoPOS está construido sobre Laravel, puedes seguir la documentación oficial de Laravel para la configuración avanzada de colas y Supervisor.