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 ограничивает потребителя теми типами сообщений, которыми он владеет.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";
| Package | Role |
|---|---|
| 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.0 | 2026-10-03 |
| v1.7.0 | 2026-09-18 |
| v1.6.0 | 2026-09-16 |
| v1.5.0 | 2026-08-20 |
| v1.4.0 | 2026-08-20 |
| v1.3.0 | 2026-07-26 |
| v1.2.0 | 2026-07-25 |
| v1.1.0 | 2026-07-24 |
| v1.0.2 | 2026-06-30 |
| v1.0.1 | 2026-06-27 |
… и ещё 1 раньше. Все релизы
/ поиск · n N следующее, предыдущее · g G начало, конец · q к индексу