As Filas de Tarefas Estão Desativadas

Para lidar de forma eficiente com tarefas pesadas ou repetitivas, o NexoPOS oferece filas. Elas permitem o processamento em segundo plano sem afetar o desempenho da aplicação. Por padrão, o NexoPOS é executado em modo síncrono, ou seja, as tarefas são executadas imediatamente durante a execução. Embora isso funcione, recomenda-se habilitar filas para obter melhor desempenho.

Além disso, os cron jobs são essenciais e devem sempre ser configurados. Eles são usados para:

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

Filas e jobs cron são duas funcionalidades distintas, mas complementares. A seguir, veja como configurar cada uma delas.

Nota Importante

A configuração da fila é opcional. O NexoPOS funcionará sem ela, e qualquer notificação no painel é apenas uma recomendação. No entanto, habilitar filas melhora o desempenho ao descarregar tarefas para processos em segundo plano.

Configurando o arquivo .env

Para habilitar o processamento da fila, atualize seu arquivo .env definindo:

QUEUE_CONNECTION=database

O valor padrão é “sync”, que executa tarefas imediatamente em vez de em segundo plano.

Configurando Tarefas Cron

A complexidade de configurar jobs cron depende do seu ambiente. No Windows (não-WSL), isso exige Tarefas Agendadas, o que pode ser menos conveniente. Ambientes baseados em Linux (incluindo WSL) são recomendados.

Tarefas agendadas no 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&gt;&amp;1

Substitua nexopos-directory pela sua pasta de instalação real.

Nota: O caminho do binário do PHP (/usr/local/bin/php) pode variar. Você pode confirmá-lo usando:

which php

Tarefas Agendadas no Laravel Forge

O Laravel Forge oferece uma interface amigável para tarefas cron.

Use o seguinte comando (ajustando a versão do PHP e o caminho conforme necessário):

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

Para recuperar o caminho correto, execute:

pwd

a partir do seu diretório NexoPOS.

Tarefas Agendadas no Linux (Ubuntu)

Edite o crontab para o seu usuário:

crontab -e -u username

Então adicione:

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

Substitua /path/to/nexopos pelo seu caminho de instalação real.

Configurando o Supervisor (Opcional)

O Supervisor é usado para gerenciar processos em segundo plano de longa duração, como filas. Embora seja opcional, é recomendado para uma experiência mais fluida ao usar filas.

Como o NexoPOS é construído sobre o Laravel, você pode seguir a documentação oficial do Laravel para configurações avançadas de filas e do Supervisor.