Actions no Laravel: O que são e como utilizá-las

O Laravel é conhecido por sua flexibilidade e por oferecer diversas abordagens para organizar a lógica de negócios dentro de uma aplicação. Uma dessas abordagens é o uso de Actions (Ações), que permitem encapsular funcionalidades específicas em classes separadas, melhorando a organização e a reutilização do código.

O que são Actions?

Actions são classes que encapsulam uma única responsabilidade ou tarefa dentro de uma aplicação Laravel. Elas ajudam a manter o código mais limpo e organizado, seguindo o princípio de Single Responsibility (Responsabilidade Única). Uma Action pode ser usada para isolar uma operação que seria muito grande ou complexa para ser colocada diretamente em um Controller ou Service, tornando o código mais legível e fácil de manter.

Quando utilizar Actions?

O uso de Actions é ideal quando você tem uma funcionalidade específica e reutilizável que precisa ser usada em diferentes partes do sistema. Exemplos comuns incluem:

• Processar pagamentos.
• Gerar relatórios.
• Enviar notificações ou emails.
• Realizar cálculos ou processamento de dados complexos.

Se você perceber que uma determinada funcionalidade está sendo repetida em diferentes controllers ou services, encapsular essa lógica em uma Action pode ser uma boa prática.

Criando uma Action no Laravel

O Laravel não tem um comando específico para criar Actions por padrão, mas você pode facilmente criar uma classe no diretório app/Actions (você pode escolher o nome ou diretório que preferir). Vamos ver um exemplo prático.

Passo 1: Criar a Classe da Action

Primeiro, vamos criar uma classe para processar o registro de usuários. Crie um arquivo no diretório app/Actions/ chamado RegisterUser.php:

namespace App\Actions;

use App\Models\User;
use Illuminate\Support\Facades\Hash;

class RegisterUser
{
    public function execute(array $data)
    {
        return User::create([
            'name' => $data['name'],
            'email' => $data['email'],
            'password' => Hash::make($data['password']),
        ]);
    }
}

Aqui, a classe RegisterUser encapsula a lógica de criar um novo usuário. O método execute() recebe os dados do usuário e cria um novo registro no banco de dados.

Passo 2: Utilizando a Action

Agora que temos nossa Action criada, podemos usá-la nos controllers ou outros lugares da aplicação:

namespace App\Http\Controllers;

use App\Actions\RegisterUser;
use Illuminate\Http\Request;

class UserController extends Controller
{
    public function store(Request $request, RegisterUser $registerUser)
    {
        $data = $request->validate([
            'name' => 'required|string|max:255',
            'email' => 'required|string|email|max:255|unique:users',
            'password' => 'required|string|min:8',
        ]);

        $user = $registerUser->execute($data);

        return response()->json(['user' => $user], 201);
    }
}

Nesse exemplo, a Action RegisterUser é injetada no controller através do Service Container do Laravel, e a lógica de registro é executada pelo método execute().

Vantagens de usar Actions

1. Organização e clareza: Ao separar responsabilidades em classes específicas, o código do controller fica mais simples e focado apenas em receber a requisição e chamar a Action.
2. Reutilização: As Actions podem ser reutilizadas em diferentes partes da aplicação. Por exemplo, se você precisar registrar um usuário tanto em uma API quanto em um formulário da web, pode usar a mesma Action em ambos os casos.
3. Testabilidade: Testar uma Action isoladamente é mais simples do que testar a lógica dentro de um controller. As Actions seguem um padrão claro de entrada e saída, facilitando a escrita de testes unitários.
4. Facilidade de manutenção: Quando a lógica de negócio está separada, fica mais fácil localizar e modificar funcionalidades específicas, sem a necessidade de mexer em código de controle de fluxo ou validação que normalmente ficam em controllers.

Estrutura sugerida

É comum que os projetos Laravel mais complexos adotem uma estrutura de diretórios organizada para facilitar o uso de Actions. Uma estrutura comum seria:

app/
    Actions/
        RegisterUser.php
        UpdateUserProfile.php
        SendWelcomeEmail.php

Você também pode agrupar Actions por domínio ou módulo, criando subdiretórios:

app/
    Actions/
        User/
            RegisterUser.php
            UpdateUserProfile.php
        Orders/
            CreateOrder.php
            ProcessOrderPayment.php

Conclusão

As Actions no Laravel são uma ótima maneira de organizar e estruturar a lógica de negócios de uma aplicação. Elas seguem o princípio da responsabilidade única e facilitam a reutilização, testabilidade e manutenção do código. Ao adotar o padrão de Actions, você está separando tarefas complexas dos controllers, promovendo uma arquitetura mais limpa e sustentável.