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 розростається.
