Command - інкапсуляція дії

Command інкапсулює дію разом із її параметрами в окремий об'єкт, який можна передавати, ставити в чергу й виконувати пізніше.

Яку проблему вирішує

Коли дія викликається прямо там, де виникла, її важко відкласти, повторити, поставити в чергу чи запланувати. Логіка осідає в контролерах і дублюється.

Як вирішує

Дію оформлюють як об'єкт із методом виконання й полями-параметрами. Такий об'єкт легко передати диспетчеру, серіалізувати, поставити в чергу чи запустити з CLI. У Laravel це Jobs і Console Commands.

use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\SerializesModels;

class SendInvoice implements ShouldQueue
{
  use Dispatchable, Queueable, SerializesModels;

  public function __construct(public int $orderId) {}

  public function handle(): void
  {
    $order = Order::findOrFail($this->orderId);
    Mail::to($order->email)->send(new Invoice($order));
  }
}

SendInvoice::dispatch($order->id);

// Console Command - теж реалізація патерну Command:
class SyncRates extends Command
{
  protected $signature = 'rates:sync';

  public function handle(): void
  {
    // sync
  }
}

// Планування у Laravel 11+ - через routes/console.php або bootstrap/app.php:
use Illuminate\Support\Facades\Schedule;

Schedule::command('rates:sync')->hourly();

Де застосовувати

• Фонові задачі в черзі, заплановані команди, ретраї, CLI-інтерфейси.
• Коли дію треба відкласти, повторити або відокремити від місця виклику.

Плюси та мінуси

• + Контролери стають тонкими, логіка переїжджає в команди.
• + Команди легко тестувати, ставити в чергу та планувати.
• − Більше класів і церемонії на просту дію.
• − Параметри краще передавати через DTO, а бізнес-правила тримати в сервісах, а не всередині job - інакше job розростається.