PHPTime

Система онлайн-бронирования на PHP: от модели данных до защиты от двойных записей

Разберём архитектуру сервиса бронирования на актуальных версиях PHP. Основное внимание — консистентность данных при пиковых нагрузках: как не продать один номер или слот дважды и корректно работать с датами в разных часовых поясах.

Какие данные хранит система бронирования

При проектировании схемы важно разделять сущности ресурса, слота и заявки (брони). Ресурс — это то, что бронируют: номер, стол, время специалиста. Слот — конкретный период доступности. Бронь — связь пользователя со слотом с определённым статусом.

Минимальная рабочая схема в SQL выглядит так:

SQL
CREATE TABLE resources (
    id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(255) NOT NULL,
    timezone VARCHAR(64) NOT NULL DEFAULT 'UTC',
    is_active TINYINT(1) NOT NULL DEFAULT 1
) ENGINE=InnoDB;

CREATE TABLE slots (
    id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    resource_id BIGINT UNSIGNED NOT NULL,
    starts_at DATETIME NOT NULL,
    ends_at DATETIME NOT NULL,
    capacity TINYINT UNSIGNED NOT NULL DEFAULT 1,
    is_available TINYINT(1) NOT NULL DEFAULT 1,
    CONSTRAINT fk_slots_resource FOREIGN KEY (resource_id) REFERENCES resources(id),
    INDEX idx_slots_resource_time (resource_id, starts_at, ends_at)
) ENGINE=InnoDB;

CREATE TABLE bookings (
    id BIGINT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
    slot_id BIGINT UNSIGNED NOT NULL,
    customer_id BIGINT UNSIGNED NOT NULL,
    status ENUM('pending','confirmed','cancelled','expired') NOT NULL DEFAULT 'pending',
    token CHAR(64) NOT NULL,
    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
    CONSTRAINT fk_bookings_slot FOREIGN KEY (slot_id) REFERENCES slots(id),
    UNIQUE KEY uq_bookings_slot_status (slot_id, status),
    UNIQUE KEY uq_bookings_token (token)
) ENGINE=InnoDB;

Ключевая идея — не хранить количество занятых мест отдельным полем, а вычислять его из подтверждённых броней в рамках слота. Это исключает рассинхронизацию счётчика при отменах и повторных попытках записи.

Защита от двойного бронирования

Главный риск — конкурентные запросы. Два пользователя одновременно видят свободный слот и оба оформляют бронь. Без явной обработки параллельных транзакций в базе окажутся две подтверждённые записи на одно место.

Пессимистичная блокировка слота

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

PHP
declare(strict_types=1);

final readonly class BookingService
{
    public function __construct(private PDO $pdo) {}

    public function book(int $slotId, int $customerId): BookingResult
    {
        $this->pdo->beginTransaction();

        try {
            $stmt = $this->pdo->prepare(
                'SELECT capacity FROM slots WHERE id = ? FOR UPDATE'
            );
            $stmt->execute([$slotId]);
            $capacity = $stmt->fetchColumn();

            if ($capacity === false) {
                throw new RuntimeException('Слот не найден');
            }

            $stmt = $this->pdo->prepare(
                "SELECT COUNT(*) FROM bookings
                 WHERE slot_id = ? AND status = 'confirmed'"
            );
            $stmt->execute([$slotId]);
            $booked = (int) $stmt->fetchColumn();

            if ($booked >= $capacity) {
                $this->pdo->rollBack();
                return new BookingResult(false, 'Мест больше нет');
            }

            $stmt = $this->pdo->prepare(
                "INSERT INTO bookings (slot_id, customer_id, status, token)
                 VALUES (?, ?, 'confirmed', ?)"
            );
            $stmt->execute([
                $slotId,
                $customerId,
                bin2hex(random_bytes(32)),
            ]);

            $this->pdo->commit();
            return new BookingResult(true);
        } catch (Throwable $e) {
            if ($this->pdo->inTransaction()) {
                $this->pdo->rollBack();
            }
            throw $e;
        }
    }
}

Подход подходит для систем с умеренным трафиком и относительно короткими транзакциями. Блокировка удерживается только на время проверки и вставки — обычно миллисекунды.

Атомарная вставка как дополнительный рубеж

В сценариях, где заранее созданы отдельные слоты на каждое место, можно обойтись без явной блокировки. Используем один запрос с условием: вставляем бронь только если для слота ещё нет другой подтверждённой записи.

PHP
declare(strict_types=1);

public function bookAtomic(int $slotId, int $customerId): BookingResult
{
    $token = bin2hex(random_bytes(32));

    $stmt = $this->pdo->prepare(
        "INSERT INTO bookings (slot_id, customer_id, status, token)
         SELECT :slot_id, :customer_id, 'confirmed', :token
         WHERE NOT EXISTS (
             SELECT 1 FROM bookings
             WHERE slot_id = :slot_id_2 AND status = 'confirmed'
         )"
    );

    $stmt->execute([
        'slot_id' => $slotId,
        'customer_id' => $customerId,
        'token' => $token,
        'slot_id_2' => $slotId,
    ]);

    if ($stmt->rowCount() === 0) {
        return new BookingResult(false, 'Слот уже занят');
    }

    return new BookingResult(true);
}

Этот вариант проще и не держит блокировку, но требует, чтобы слот соответствовал ровно одному месту. Для мест с ёмкостью больше единицы он не подходит.

Часовые пояса без боли

Все даты в базе хранятся в UTC. Это железное правило избавляет от проблем при смене часового пояса пользователя или сервера. Конвертацию выполняем на уровне приложения, а не в SQL-запросах.

Класс ресурса содержит таймзону локации. Пользователь видит время в своём часовом поясе или в поясе ресурса — это зависит от UX. Главное — никогда не полагаться на часовой пояс PHP-процесса, который может быть настроен иначе на проде.

PHP
declare(strict_types=1);

final readonly class SlotFormatter
{
    public function __construct(
        private DateTimeZone $resourceTz,
        private DateTimeZone $customerTz,
    ) {}

    public function format(Slot $slot): array
    {
        $starts = new DateTimeImmutable($slot->startsAt, new DateTimeZone('UTC'));
        $ends = new DateTimeImmutable($slot->endsAt, new DateTimeZone('UTC'));

        return [
            'customer' => [
                'starts_at' => $starts->setTimezone($this->customerTz)->format('Y-m-d H:i'),
                'ends_at' => $ends->setTimezone($this->customerTz)->format('Y-m-d H:i'),
            ],
            'resource' => [
                'starts_at' => $starts->setTimezone($this->resourceTz)->format('Y-m-d H:i'),
                'ends_at' => $ends->setTimezone($this->resourceTz)->format('Y-m-d H:i'),
            ],
        ];
    }
}

Особое внимание — стыкам дат. Слот с 22:00 до 02:00 в UTC может соответствовать разным календарным суткам в клиентском поясе. При отображении сетки доступности проверяйте полный диапазон, а не только дату начала.

Подтверждение брони и истекающие сессии

Модель с предварительным удержанием места лучше подходит для сервисов с ограниченным предложением и ручным подтверждением. Пользователь создаёт бронь со статусом pending, получает письмо или ссылку с токеном, и только после подтверждения статус меняется на confirmed.

Время жизни неподтверждённой брони ограничиваем, например, 15 минутами. По истечении срока запись меняет статус на expired, и место снова свободно. Очистку лучше делать фоновым процессом через cron, а не в веб-запросе.

PHP
declare(strict_types=1);

public function expireStaleBookings(DateTimeImmutable $now): int
{
    $stmt = $this->pdo->prepare(
        "UPDATE bookings
         SET status = 'expired'
         WHERE status = 'pending'
           AND created_at execute([
        'threshold' => $now->modify('-15 minutes')->format('Y-m-d H:i:s'),
    ]);

    return $stmt->rowCount();
}

Статус pending не должен блокировать место насовсем. При подсчёте занятых мест учитываем только confirmed и, в некоторых бизнес-логиках, pending с неистёкшим сроком. Второй вариант сложнее, но даёт пользователю гарантию, что за время заполнения формы место не уйдёт.

Блокировка по token: защита подтверждения

Ссылка подтверждения содержит случайный токен длиной не менее 32 байт. Не используйте предсказуемые идентификаторы или хеши персональных данных. При переходе по ссылке сравниваем токен безопасным способом.

PHP
declare(strict_types=1);

public function confirm(string $token): BookingResult
{
    $stmt = $this->pdo->prepare(
        "SELECT id, status FROM bookings WHERE token = ?"
    );
    $stmt->execute([$token]);
    $booking = $stmt->fetch(PDO::FETCH_ASSOC);

    if ($booking === false) {
        return new BookingResult(false, 'Бронь не найдена');
    }

    if ($booking['status'] === 'expired') {
        return new BookingResult(false, 'Время подтверждения истекло');
    }

    if ($booking['status'] === 'cancelled') {
        return new BookingResult(false, 'Бронь отменена');
    }

    $stmt = $this->pdo->prepare(
        "UPDATE bookings SET status = 'confirmed' WHERE id = ? AND status = 'pending'"
    );
    $stmt->execute([$booking['id']]);

    if ($stmt->rowCount() === 0) {
        return new BookingResult(false, 'Бронь уже обработана');
    }

    return new BookingResult(true);
}

Условие status = 'pending' в UPDATE защищает от повторного подтверждения отменённой брони. Проверка статуса до UPDATE носит информационный характер — основную защиту обеспечивает именно атомарное условие в запросе.

Обработка гонок при отмене

Отмена брони — не менее ответственная операция. Если одновременно приходит запрос на подтверждение и отмену, важно, чтобы победила ровно одна операция. Обновление с условием по текущему статусу решает задачу без явных блокировок.

PHP
declare(strict_types=1);

public function cancel(int $bookingId, int $customerId): BookingResult
{
    $stmt = $this->pdo->prepare(
        "UPDATE bookings
         SET status = 'cancelled'
         WHERE id = ?
           AND customer_id = ?
           AND status IN ('pending', 'confirmed')"
    );
    $stmt->execute([$bookingId, $customerId]);

    if ($stmt->rowCount() === 0) {
        return new BookingResult(false, 'Бронь уже обработана или не принадлежит пользователю');
    }

    return new BookingResult(true);
}

Дополнительная проверка customer_id не даёт случайно снять чужую бронь по угаданному идентификатору. Для административных операций используйте отдельный метод с более строгой авторизацией.

Изоляция транзакций и уровень REPEATABLE READ

InnoDB по умолчанию работает с уровнем изоляции REPEATABLE READ. Для сценария с SELECT ... FOR UPDATE это приемлемо: блокировка читает актуальную версию строки. Но в сценариях с агрегатами без явной блокировки возможны фантомные чтения.

Если переходите на PostgreSQL, там уровень по умолчанию READ COMMITTED, и его часто достаточно. Главное — не полагаться на отсутствие блокировок там, где нужна строгая консистентность. Явная блокировка слота остаётся самым понятным и предсказуемым решением на обеих платформах.

Индексы и производительность

Запросы бронирования почти всегда фильтруют по ресурсу и диапазону дат. Составной индекс (resource_id, starts_at, ends_at) покрывает выборку слотов для календаря. Для проверки занятости слота нужен индекс по (slot_id, status) — он обслуживает и внешний ключ, и условия по статусам.

ЗапросИндексПричина
Сетка слотов ресурса за период(resource_id, starts_at, ends_at)Фильтр по ресурсу и сортировка по дате
Подсчёт занятых мест слота(slot_id, status)Агрегация по конкретному слоту
Поиск брони по токенуUNIQUE(token)Быстрый точечный поиск

Не создавайте отдельный индекс на каждую колонку «на всякий случай». Индексы замедляют запись, а в системе бронирования запись идёт почти наравне с чтением. Каждый индекс должен покрывать реальный запрос из кодовой базы.

Чек-лист для боевой системы бронирования

  • Все даты хранятся в UTC, конвертация — на приложении через DateTimeImmutable и явные DateTimeZone.
  • Занятость места проверяется внутри транзакции с блокировкой слота или через атомарную вставку с NOT EXISTS.
  • Токены подтверждения и отмены генерируются через random_bytes(), длина — от 32 байт.
  • Статусная модель покрывает все ветки: pending, confirmed, cancelled, expired.
  • Фоновый процесс снимает устаревшие pending-брони, не полагаясь на запрос пользователя.
  • UPDATE-запросы смены статуса всегда включают текущий статус в WHERE для атомарности.
  • Составные индексы покрывают реальные выборки: календарь ресурса и проверку занятости слота.
  • Код работает на PHP 8.3+ со строгой типизацией и readonly-классами для неизменяемых сервисов.

Частые вопросы

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

Используйте транзакцию с SELECT ... FOR UPDATE по строке слота. Это сериализует конкурентные запросы: второй запрос дождётся завершения первого и увидит актуальное количество занятых мест. Для частных случаев с единственным местом подойдёт атомарная вставка через INSERT ... SELECT WHERE NOT EXISTS.

В каком часовом поясе хранить даты слотов?

Только в UTC. Часовой пояс ресурса и пользователя храните отдельными полями и применяйте на уровне PHP через DateTimeImmutable::setTimezone(). Это исключает путаницу при смене сервера и упрощает агрегацию по датам.

Нужно ли блокировать место на время заполнения формы?

Зависит от бизнес-модели. Если предложение ограничено, создавайте бронь со статусом pending и удерживайте место до подтверждения. Неподтверждённые заявки снимайте фоновым процессом через 10–15 минут. Если нагрузка умеренная, можно подтверждать сразу и использовать только confirmed.

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

Генерируйте токен через random_bytes(32), храните его в UNIQUE-поле. При переходе по ссылке выполняйте UPDATE с условием status = 'pending'. Если rowCount() равен нулю — бронь уже подтверждена, отменена или истекла. Не полагайтесь только на предварительный SELECT.

Справка по теме

Ещё в разделе «Yii»

Архитектура приложения на Yii2. Часть 1. MVC, точки входа и конфиги

Как организовать приложение на Yii2 и PHP 8.3–8.5: разделить frontend и backend, вынести сценарии в сервисы и собрать конфиги для разных окружений.

7 мин

Расширения Yii 2: где искать и как устанавливать через Composer

Где искать расширения Yii 2, как проверить совместимость с PHP 8.3–8.5 и выбрать пакет. Установка через Composer, настройка и примеры популярных расширений.

7 мин

Yii 2 сегодня: установка, PHP 8.x и выбор фреймворка

Как установить Yii 2 на PHP 8.3–8.5, выбрать шаблон Basic или Advanced, проверить зависимости и решить, когда перейти на Yii 3 или Laravel.

6 мин

Миграция с Yii 1.1 на Yii 2: как перенести действующий проект

Как перенести проект с Yii 1.1 на Yii 2: пространства имён, ActiveRecord, формы, виджеты и конфигурация. План миграции с тестами и откатом.

7 мин