Servicii pentru logica de business

Un serviciu (sau „action") e o clasă care conține un pas de logică de business, izolat de HTTP. „Publică un articol", „procesează o comandă", „calculează factura" — fiecare devine o clasă cu o metodă clară, ușor de testat și de reutilizat.

Anatomia unui serviciu

class PublicaArticol
{
    public function __invoke(Articol $articol): Articol
    {
        $articol->update([
            "publicat" => true,
            "publicat_la" => now(),
        ]);

        PublicareArticol::dispatch($articol);   // eveniment

        return $articol;
    }
}

Folosirea din controller

public function publica(Articol $articol, PublicaArticol $actiune)
{
    $this->authorize("update", $articol);
    $actiune($articol);
    return back()->with("succes", "Articol publicat.");
}
// controllerul: autorizare + delegare + răspuns. Atât.

Ce pui într-un serviciu

• Logica cu mai mulți pași care trebuie să se întâmple împreună.
• Reguli de business (ce înseamnă „a publica", ce validări suplimentare).
• Coordonarea între modele multiple.

Ce NU pui

• Validarea de intrare — aia e în Form Request.
• Formatarea răspunsului — aia e în controller sau resource.
• Interogări simple de citire — pot sta în model sau controller.

Testarea

public function test_publicarea_seteaza_data(): void
{
    $articol = Articol::factory()->create(["publicat" => false]);
    (new PublicaArticol)($articol);
    $this->assertTrue($articol->fresh()->publicat);
    $this->assertNotNull($articol->fresh()->publicat_la);
}

Un serviciu cu mai mulți pași

class ProceseazaComanda
{
    public function __construct(private Stoc $stoc, private Facturare $facturare) {}

    public function __invoke(Comanda $comanda): void
    {
        DB::transaction(function () use ($comanda) {
            $this->stoc->rezerva($comanda->linii);
            $comanda->update(["status" => "confirmata"]);
            $this->facturare->emite($comanda);
        });

        ComandaConfirmata::dispatch($comanda);
    }
}

Exercițiu

Extrage o acțiune cu 2-3 pași din proiectul tău într-o clasă serviciu invocabilă (__invoke). Scrie un test care verifică efectul ei, fără să treacă prin HTTP. Cheam-o din controller.

Greșeli frecvente

• Serviciul primește un Request și extrage date din el — cuplare de HTTP.
• Serviciul întoarce un răspuns HTTP (view/redirect) în loc de date.
• „Serviciu" care e doar un wrapper de o linie peste un apel de model.
• Nu wrappezi în tranzacție operațiile care trebuie să reușească împreună.

De reținut

• Serviciu/action = un pas de logică de business, fără HTTP.
• Primește modele și valori, întoarce modele și valori.
• Se testează direct, fără cerere HTTP.
• Coordonează modele multiple, adesea într-o tranzacție.

Pe scurt

Serviciile scot logica de business din controllere, o fac testabilă și reutilizabilă. Primesc date curate, produc rezultate, declanșează evenimente.

public function approve(int $id): void {
  $changed = ServiceRequest::whereKey($id)
    ->where('status', 'new')
    ->update(['status' => 'approved', 'updated_at' => now()]);
  if ($changed !== 1) {
    throw new DomainException('Cererea nu mai poate fi aprobată.');
  }
}
// Notificarea se coordonează separat, după confirmarea schimbării.

Documentație și surse

• Documentația Laravel 11 — versiunea aplicației demonstrative — Laravel
• OWASP Top 10 — OWASP