Skip to content
YII3-OUTBOX(3)Руководство по PHP-библиотекам rasuvaeffYII3-OUTBOX(3)

ИМЯ ​

yii3-outbox — stateless-ядро transactional outbox для Yii3 с политиками повторов и сменным хранилищем

ОБЗОР ​

$ composer require rasuvaeff/yii3-outbox

$storage = new InMemoryStorage();rasuvaeff/yii3-outbox-db for a real one$outbox = new Outbox(storage: $storage, clock: $clock); $message = $outbox->record(    type: 'order.created',    payload: json_encode(['orderId' => 42]),    aggregateId: 'order-42',); $processor = new Processor(    storage: $storage,    publisher: $publisher,    retryPolicy: new RetryPolicy(maxAttempts: 3, delaySeconds: 60),    clock: $clock,    batchSize: 100,);$result = $processor->process();

ОПИСАНИЕ ​

Stateless-ядро transactional outbox для Yii3 с политиками повторов.

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

  • Outbox::record() с необязательными aggregateId, id и приоритетом; recordMany() читает часы один раз и сохраняет пачкой, если хранилище это умеет.
  • Порядок захвата: приоритет по убыванию, затем createdAt по возрастанию (диапазон приоритета от -32768 до 32767).
  • Processor захватывает, публикует и применяет RetryPolicy(maxAttempts, delaySeconds).
  • PublishException::terminal() сразу помечает сообщение как Failed.
  • Параметр types у Processor ограничивает потребителя теми типами сообщений, которыми он владеет.
  • Необязательные интерфейсы хранилища: учёт повторов, пакетное подтверждение, пакетное сохранение, requeue, статистика.
  • Подключаемый MessageIdGeneratorInterface; реализация по умолчанию не требует библиотеки UUID.
  • Поставляется с тестовым дублёром InMemoryStorage и Serializer.

ПРИМЕРЫ ​

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

$db->transaction(static function () use ($orders, $outbox, $order, $json): void {    $orders->insert($order);     $outbox->record(        type: 'order.created',        payload: $json,        aggregateId: $order->id,    );});

Публикатор сообщает об ошибке через PublishException, процессор повторяет попытки, пока они не кончатся.

final class RabbitPublisher implements PublisherInterface{    public function publish(OutboxMessage $message): void    {        try {            // publish to RabbitMQ, Kafka, etc.        } catch (\Throwable $e) {            throw new PublishException(                message: $e->getMessage(),                outboxMessage: $message,                previous: $e,            );        }    }}

RetryPolicy решает, можно ли повторять сообщение и прошла ли задержка между попытками.

$policy = new RetryPolicy(maxAttempts: 3, delaySeconds: 60);$now = new DateTimeImmutable(); $attempted = new OutboxMessage(    id: 'msg-1',    type: 'order.created',    payload: '{}',    status: OutboxStatus::Pending,    createdAt: new DateTimeImmutable(),    attempts: 2,    lastAttemptAt: new DateTimeImmutable('-30 seconds'),);echo "2 attempts, 30s ago — should retry: " . ($policy->shouldRetry($attempted) ? 'yes' : 'no') . "\n";echo "2 attempts, 30s ago — ready (delay=60s): " . ($policy->isReadyForRetry($attempted, $now) ? 'yes' : 'no') . "\n";

СМОТРИТЕ ТАКЖЕ ​

PackageRole
yii3-outbox-db(3)SQL-хранилище
yii3-outbox-clickhouse(3)Пакетный экспортёр в ClickHouse
yii3-outbox-webhooks-bridge(3)Доставка вебхуков через outbox
yii3-ab-testing-outbox(3)События показов и конверсий A/B

ОШИБКИ ​

Ядро не открывает транзакцию, поэтому обязанность атомарной записи остаётся на вызывающем. Доставка at-least-once, а Processor без types захватывает сообщения всех типов в общем хранилище.

ЗАВИСИМОСТИ

от него зависят: yii3-ab-testing-outbox(3), yii3-outbox-clickhouse(3), yii3-outbox-db(3), yii3-outbox-webhooks-bridge(3)

ИСТОРИЯ

Первый релиз v1.0.0 — 2026-06-13, всего релизов: 11.

v1.8.02026-10-03
v1.7.02026-09-18
v1.6.02026-09-16
v1.5.02026-08-20
v1.4.02026-08-20
v1.3.02026-07-26
v1.2.02026-07-25
v1.1.02026-07-24
v1.0.22026-06-30
v1.0.12026-06-27

… и ещё 1 раньше. Все релизы

rasuvaeff/yii3-outbox 1.8.0мутационный порог 99%зависят пакетов 4YII3-OUTBOX(3)

/ поиск · n N следующее, предыдущее · g G начало, конец · q к индексу