Статусы заказов на PHP: от простого к сложному

Расширенные примеры реализации статусов заказов

Помимо базовых вариантов, рассмотрим полноценный менеджер статусов с транзакциями, логированием и правами доступа. Пример использует enum и PDO.

<?php

declare(strict_types=1);

class OrderStatusManager
{
    private PDO $pdo;
    private Logger $logger;

    public function __construct(PDO $pdo, Logger $logger)
    {
        $this->pdo = $pdo;
        $this->logger = $logger;
    }

    /**
     * Обновить статус заказа с проверкой перехода и записью лога.
     *
     * @param int $orderId
     * @param OrderStatus $newStatus
     * @param string $changedBy
     * @return bool
     * @throws \RuntimeException
     */
    public function updateStatus(int $orderId, OrderStatus $newStatus, string $changedBy): bool
    {
        $this->pdo->beginTransaction();
        try {
            // Получаем текущий статус
            $stmt = $this->pdo->prepare('SELECT status FROM orders WHERE id = :id FOR UPDATE');
            $stmt->execute([':id' => $orderId]);
            $row = $stmt->fetch();
            if (!$row) {
                throw new \RuntimeException('Заказ не найден');
            }
            $currentStatus = OrderStatus::fromInt((int)$row['status']);

            // Проверяем допустимость перехода (пример: только вперед по числовому значению)
            if ($newStatus->value <= $currentStatus->value) {
                throw new \RuntimeException('Недопустимый переход статуса');
            }

            // Обновляем статус
            $stmt = $this->pdo->prepare('UPDATE orders SET status = :status WHERE id = :id');
            $stmt->execute([':status' => $newStatus->value, ':id' => $orderId]);

            // Логируем изменение
            $this->logger->log([
                'order_id' => $orderId,
                'old_status' => $currentStatus->name,
                'new_status' => $newStatus->name,
                'changed_by' => $changedBy,
                'changed_at' => date('Y-m-d H:i:s'),
            ]);

            $this->pdo->commit();
            return true;
        } catch (\Throwable $e) {
            $this->pdo->rollBack();
            throw $e;
        }
    }

    /**
     * Получить список доступных для перехода статусов.
     */
    public function getAvailableStatuses(OrderStatus $current): array
    {
        $all = OrderStatus::cases();
        return array_filter($all, fn(OrderStatus $s) => $s->value > $current->value);
    }
}
?>

Результат выполнения (пример лога):

Array
(
    [order_id] => 123
    [old_status] => New
    [new_status] => Processing
    [changed_by] => admin@example.com
    [changed_at] => 2025-03-01 14:35:12
)

Ещё один расширенный пример – интеграция с Symfony Form. Используем ChoiceType с перечислением.

// в Form/OrderType.php
use Symfony\Component\Form\Extension\Core\Type\ChoiceType;
use Symfony\Component\Form\FormBuilderInterface;

public function buildForm(FormBuilderInterface $builder, array $options): void
{
    $builder
        ->add('status', ChoiceType::class, [
            'choices' => array_combine(
                array_map(fn(OrderStatus $s) => $s->label(), OrderStatus::cases()),
                OrderStatus::cases()
            ),
            'choice_value' => fn(?OrderStatus $status) => $status?->value,
        ]);
}

Результат: пользователь видит выпадающий список с русскими названиями статусов, а форма сохраняет числовое значение.

Для ещё более гибкой системы можно добавить асинхронное обновление через AJAX с проверкой прав доступа:

// controller/ajax.php
public function changeStatusAction(Request $request): JsonResponse
{
    if (!$this->isGranted('ROLE_ADMIN')) {
        return new JsonResponse(['error' => 'Доступ запрещён'], 403);
    }
    $orderId = $request->request->getInt('order_id');
    $newStatusValue = $request->request->getInt('status');
    $newStatus = OrderStatus::tryFrom($newStatusValue);
    if (!$newStatus) {
        return new JsonResponse(['error' => 'Неверный статус'], 400);
    }
    try {
        $this->orderManager->updateStatus($orderId, $newStatus, $this->getUser()->getUsername());
        return new JsonResponse(['success' => true]);
    } catch (\Throwable $e) {
        return new JsonResponse(['error' => $e->getMessage()], 500);
    }
}

Результат: в админке можно менять статус без перезагрузки страницы.