{"id":3080,"date":"2024-12-06T09:34:52","date_gmt":"2024-12-06T12:34:52","guid":{"rendered":"https:\/\/thiagorossi.com.br\/blog\/?p=3080"},"modified":"2025-12-06T12:06:33","modified_gmt":"2025-12-06T15:06:33","slug":"tarefas-concorrentes-no-laravel","status":"publish","type":"post","link":"https:\/\/thiagorossi.com.br\/blog\/tarefas-concorrentes-no-laravel\/","title":{"rendered":"Tarefas Concorrentes no Laravel"},"content":{"rendered":"Tempo de leitura: <\/span> 4<\/span> minutos<\/span><\/span>\n

Tarefas Concorrentes no Laravel<\/strong>: O conceito de Tarefas Concorrentes<\/strong> (ou tarefas em segundo plano) \u00e9 crucial para construir aplica\u00e7\u00f5es r\u00e1pidas<\/strong> e responsivas<\/strong>. Como o PHP e o HTTP s\u00e3o s\u00edncronos, tarefas demoradas (como enviar 1000 e-mails, processar uma imagem ou gerar um relat\u00f3rio) bloqueiam a requisi\u00e7\u00e3o do usu\u00e1rio.<\/p>\n\n\n\n

O Laravel resolve isso com um sistema de Filas (Queues)<\/strong> robusto. Ao inv\u00e9s de executar a tarefa imediatamente, ela \u00e9 empacotada em um Job<\/strong> e enviada para uma fila, onde ser\u00e1 processada posteriormente por um Trabalhador (Worker)<\/strong>. Isso libera o ciclo de vida da requisi\u00e7\u00e3o HTTP para que a resposta seja enviada imediatamente ao usu\u00e1rio.<\/p>\n\n\n\n

<\/div>\n\n\n\n

1. \ud83c\udfaf Mecanismos de Execu\u00e7\u00e3o Concorrente<\/h2>\n\n\n\n

O Laravel oferece tr\u00eas mecanismos principais para desvincular o trabalho do fluxo principal da aplica\u00e7\u00e3o:<\/p>\n\n\n\n

Mecanismo<\/strong><\/td>Conceito<\/strong><\/td>Driver Comum<\/strong><\/td>Uso T\u00edpico<\/strong><\/td><\/tr><\/thead>
Filas (Jobs)<\/strong><\/td>Coloca uma tarefa em uma lista para ser processada por um Worker<\/strong>.<\/td>Redis, Database, Beanstalkd, Amazon SQS.<\/td>Envio de e-mails, processamento de uploads<\/em>.<\/td><\/tr>
Agendamento (Scheduling)<\/strong><\/td>Executa comandos Artisan em segundo plano em hor\u00e1rios fixos.<\/td>Cron Job (do sistema operacional).<\/td>Limpeza de cache, gera\u00e7\u00e3o de relat\u00f3rios noturnos.<\/td><\/tr>
Broadcasting<\/strong><\/td>Envia eventos para clientes em tempo real (WebSockets).<\/td>Pusher, Redis, Ably.<\/td>Notifica\u00e7\u00f5es instant\u00e2neas, chats<\/em>.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
<\/div>\n\n\n\n

Foco: O Sistema de Filas (Queues)<\/h3>\n\n\n\n

As filas usam o padr\u00e3o Produtor-Consumidor<\/strong>:<\/p>\n\n\n\n

    \n
  1. Produtor (Dispatcher):<\/strong> Sua aplica\u00e7\u00e3o (Controller, Service) cria e envia um Job<\/strong> para a fila (Produz a tarefa).<\/li>\n\n\n\n
  2. Consumidor (Worker):<\/strong> Um processo PHP separado fica ouvindo a fila e executa os Jobs quando eles chegam (Consome a tarefa).<\/li>\n<\/ol>\n\n\n\n
    <\/div>\n\n\n\n

    2. \ud83d\udce7 Criando um Job para Envio de E-mails<\/h2>\n\n\n\n

    A tarefa de enviar um e-mail \u00e9 um caso de uso cl\u00e1ssico para filas, pois pode demorar de centenas de milissegundos a v\u00e1rios segundos.<\/p>\n\n\n\n

    <\/div>\n\n\n\n

    Passo 1: Gerar o Job<\/h3>\n\n\n\n

    O comando Artisan cria a estrutura b\u00e1sica:<\/p>\n\n\n\n

    Bash<\/p>\n\n\n\n

    php artisan make:job SendWelcomeEmail\n<\/code><\/pre>\n\n\n\n
    <\/div>\n\n\n\n
    Passo 2: Implementa\u00e7\u00e3o do Job<\/h3>\n\n\n\n
    A classe deve implementar a interface ShouldQueue<\/code><\/strong> e conter a l\u00f3gica de execu\u00e7\u00e3o no m\u00e9todo handle()<\/code><\/strong>.<\/p>\n\n\n\n
    PHP<\/p>\n\n\n\n
    \/\/ App\/Jobs\/SendWelcomeEmail.php\nnamespace App\\Jobs;\n\nuse Illuminate\\Bus\\Queueable;\nuse Illuminate\\Contracts\\Queue\\ShouldQueue;\nuse Illuminate\\Foundation\\Bus\\Dispatchable;\nuse Illuminate\\Queue\\InteractsWithQueue;\nuse Illuminate\\Queue\\SerializesModels;\nuse Mail;\nuse App\\Mail\\WelcomeEmail;\n\nclass SendWelcomeEmail implements ShouldQueue\n{\n    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;\n\n    public $user; \/\/ \u00c9 seguro serializar Models do Eloquent\n\n    public function __construct(User $user)\n    {\n        $this->user = $user;\n    }\n\n    \/**\n     * Executa o Job.\n     *\/\n    public function handle(): void\n    {\n        \/\/ A l\u00f3gica de envio de e-mail agora \u00e9 executada pelo Worker\n        Mail::to($this->user->email)->send(new WelcomeEmail($this->user->name));\n    }\n}\n<\/code><\/pre>\n\n\n\n
    <\/div>\n\n\n\n
    3. \ud83d\udce4 Adicionando Jobs \u00e0 Fila<\/h2>\n\n\n\n
    No seu Controller, voc\u00ea usa o helper<\/em> dispatch()<\/code> ou a Facade<\/em> Queue<\/code> para enviar o Job para processamento.<\/p>\n\n\n\n
    <\/div>\n\n\n\n
    A. Disparando Imediatamente<\/h3>\n\n\n\n
    PHP<\/p>\n\n\n\n
    use App\\Jobs\\SendWelcomeEmail;\n\n\/\/ No Controller, ap\u00f3s criar o usu\u00e1rio:\n$user = User::create($request->validated());\n\/\/ O m\u00e9todo dispatch() envia o Job para a fila configurada\ndispatch(new SendWelcomeEmail($user)); \n\n\/\/ O fluxo da requisi\u00e7\u00e3o continua imediatamente.\nreturn redirect('\/dashboard')->with('success', 'Conta criada com sucesso.');\n<\/code><\/pre>\n\n\n\n
    <\/div>\n\n\n\n
    B. Adiando Tarefas (delay<\/code>)<\/h3>\n\n\n\n
    Voc\u00ea pode agendar a execu\u00e7\u00e3o para um momento futuro:<\/p>\n\n\n\n
    PHP<\/p>\n\n\n\n
    use App\\Jobs\\SendReminderEmailJob;\n\n\/\/ O e-mail de lembrete ser\u00e1 processado 5 minutos a partir de agora\nSendReminderEmailJob::dispatch($user)->delay(now()->addMinutes(5));\n<\/code><\/pre>\n\n\n\n
    <\/div>\n\n\n\n
    4. \ud83d\udc77 Processando a Fila (Workers)<\/h2>\n\n\n\n
    Para que as tarefas sejam processadas, voc\u00ea precisa iniciar um ou mais Workers<\/strong> no seu ambiente.<\/p>\n\n\n\n
    <\/div>\n\n\n\n
    Iniciando o Worker<\/h3>\n\n\n\n
    O comando Artisan queue:work<\/code><\/strong> inicia o processo de escuta:<\/p>\n\n\n\n
    Bash<\/p>\n\n\n\n
    # Inicia um Worker que ouve a fila 'default'\nphp artisan queue:work \n\n# Inicia o Worker em modo daemon (melhor para produ\u00e7\u00e3o)\nphp artisan queue:work --daemon --sleep=3 --tries=3\n<\/code><\/pre>\n\n\n\n
    <\/div>\n\n\n\n
    \n
    Importante:<\/strong> Em produ\u00e7\u00e3o, o queue:work<\/code> n\u00e3o deve ser executado diretamente, mas sim gerenciado por um monitor de processos (como Supervisor<\/strong> no Linux) para garantir que ele esteja sempre rodando e seja reiniciado em caso de falha.<\/p>\n<\/blockquote>\n\n\n\n
    <\/div>\n\n\n\n
    5. \ud83d\ude80 Vantagens de Usar Filas<\/h2>\n\n\n\n
    O uso de filas traz ganhos significativos para a aplica\u00e7\u00e3o:<\/p>\n\n\n\n