Создание бизнес-логики на PHP: от статусов до шины событий

Как создать простой конечный автомат без внешних библиотек?

Для небольших проектов или MVP можно реализовать собственный автомат на основе массива правил. Это дает полный контроль и не требует установки дополнительных пакетов.

class SimpleStateMachine
{
    private array $transitions = [];
    private string $currentState;

    public function __construct(string $initialState, array $transitions)
    {
        $this->currentState = $initialState;
        $this->transitions = $transitions;
    }

    public function can(string $transition): bool
    {
        return isset($this->transitions[$transition]) &&
               in_array($this->currentState, $this->transitions[$transition]['from']);
    }

    public function apply(string $transition): void
    {
        if (!$this->can($transition)) {
            throw new \InvalidArgumentException("Transition $transition not allowed from state $this->currentState");
        }
        $this->currentState = $this->transitions[$transition]['to'];
    }

    public function getState(): string
    {
        return $this->currentState;
    }
}

// Использование:
$transitions = [
    'process' => ['from' => ['new'], 'to' => 'processing'],
    'ship' => ['from' => ['processing'], 'to' => 'shipped'],
];
$machine = new SimpleStateMachine('new', $transitions);
echo $machine->getState(); // new
$machine->apply('process');
echo $machine->getState(); // processing

Случаи использования: протектирование, простые анкеты, статусы пользователей. Ограничение - плохо поддерживается при росте числа состояний.

Как организовать последовательность действий с цепочкой обязанностей?

Паттерн Chain of Responsibility позволяет последовательно обрабатывать запрос, передавая его по цепочке обработчиков. Это полезно для бизнес-процессов, состоящих из нескольких этапов (например, валидация, расчет скидки, уведомление).

abstract class OrderHandler
{
    private ?OrderHandler $next = null;

    public function setNext(OrderHandler $handler): OrderHandler
    {
        $this->next = $handler;
        return $handler;
    }

    public function handle(Order $order): void
    {
        $result = $this->process($order);
        if ($this->next !== null) {
            $this->next->handle($order);
        }
    }

    abstract protected function process(Order $order): bool;
}

class ValidationHandler extends OrderHandler
{
    protected function process(Order $order): bool
    {
        if (empty($order->getItems())) {
            throw new \Exception('Order has no items');
        }
        return true;
    }
}

class DiscountHandler extends OrderHandler
{
    protected function process(Order $order): bool
    {
        $order->setDiscount($order->getTotal() > 100 ? 10 : 0);
        return true;
    }
}

Цепочка строится явно: $validation->setNext($discount). Каждый обработчик выполняет свою задачу и передает управление дальше.

Цели: валидация, модификация данных, логгирование, отправка уведомлений. Подходит для процессов с четкой последовательностью и возможностью добавления новых шагов без изменения существующих.

Как использовать события для слабосвязанного бизнес-процесса?

Event-Driven подход с Symfony EventDispatcher позволяет разделить фазы процесса на независимые слушатели. Это дает гибкость и возможность легко добавлять новое поведение.

// src/Event/OrderProcessedEvent.php
class OrderProcessedEvent extends \Symfony\Contracts\EventDispatcher\Event
{
    public const NAME = 'order.processed';
    private $order;

    public function __construct(Order $order)
    {
        $this->order = $order;
    }

    public function getOrder(): Order
    {
        return $this->order;
    }
}

// src/EventSubscriber/OrderSubscriber.php
class OrderSubscriber implements \Symfony\Component\EventDispatcher\EventSubscriberInterface
{
    public static function getSubscribedEvents()
    {
        return [
            OrderProcessedEvent::NAME => 'onOrderProcessed',
        ];
    }

    public function onOrderProcessed(OrderProcessedEvent $event)
    {
        $order = $event->getOrder();
        // отправка email, логирование
    }
}

В контроллере после обработки заказа диспатчится событие: $eventDispatcher->dispatch(new OrderProcessedEvent($order), OrderProcessedEvent::NAME).

Случаи использования: уведомления, журналирование, интеграция с CRM, когда действия не критичны для основного потока. Подходит для высоконагруженных систем с микросервисной архитектурой.