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

ИМЯ ​

context — дедлайны, отмена и значения в рамках запроса для PHP

ОБЗОР ​

$ composer require rasuvaeff/context

$root = Context::background();never terminates by itself [$request, $requestController] = $root->withTimeout(3.0);seconds[$step, $stepController] = $request->withCancel();cancellable branch $traced = $request->withValue(RequestId::class, new RequestId('r-42'));$traced->value(RequestId::class)?->value;'r-42' (nearest ancestor wins) [$work] = $request->withReserve(0.2);the parent deadline minus 200 ms

ОПИСАНИЕ ​

context.Context из Go для PHP, без зависимостей. Один бюджет проходит сквозь запрос через все слои.

Без общего бюджета у каждого слоя своё представление о времени, поэтому код может начать шаг, когда бюджет запроса уже исчерпан. Вызывающие проверяют один неизменяемый дедлайн.

  • withTimeout, withDeadline, withCancel, withReserve порождают дочерние контексты.
  • Дедлайн потомка никогда не позже дедлайна родителя.
  • assertActive() бросает ContextCancelledException или ContextExpiredException.
  • remainingMs() переводит бюджет в таймаут транспорта.
  • Слушатели onTerminate(); requestCancel() безопасен в обработчиках сигналов.
  • iterate() и sleep() учитывают дедлайн.
  • WireCodec передаёт бюджет и значения из белого списка между процессами, без unserialize().
  • FakeTimeSource и SteppingTimeSource для детерминированных тестов.

ПРИМЕРЫ ​

Воркер очереди берёт TTR задачи как дедлайн и подтверждает сообщение, только если все шаги уложились.

[$jobContext, $jobController] = Context::background()->withTimeout($ttrSeconds);try {    foreach ($steps as $step) {        $jobContext->assertActive();        $step($jobContext);    }    $queue->ack($message);} catch (ContextExpiredException) {    $queue->nack($message);  // let the queue decide retry/dead-letter} finally {    $jobController->cancel();}

WireCodec передаёт остаток бюджета и типизированные значения между процессами, считая вход недоверенным.

$codec = new WireCodec(['tenant' => TenantId::class]); $message->attributes = $codec->encode($context);  // ['budget_ms' => 790, 'values' => ['tenant' => 'acme']] [$context, $controller] = $codec->decode($message->attributes, Context::background(), maxBudgetMs: 30_000);

Фиктивные часы делают тесты дедлайнов детерминированными: сдвигаем время, и контекст истекает.

$clock = new FakeTimeSource();also the Sleeper: sleep() advances it[$context] = Context::background($clock)->withTimeout(1.0);$clock->advanceMs(2_000);$context->isExpired();true

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

PackageLayer
context-http(3)PSR-15 / PSR-18 и Guzzle
context-db(3)Таймауты выражений в MySQL, MariaDB, PostgreSQL
context-cli(3)Корректное завершение по сигналам ОС
context-process(3)Подпроцессы, останавливаемые на дедлайне
clickhouse-toolkit(3)max_execution_time

resilience принимает необязательный бюджет контекста и компонует retry, circuit-breaker и bulkhead в порядке, который не усиливает перегрузку: bulkhead внутри, breaker вокруг него, retry снаружи.

ОШИБКИ ​

Контекст останавливает работу, но не прерывает её. Отмена кооперативная, а дедлайны ленивые (фонового таймера нет), поэтому проверяйте перед каждым шагом. Без context-db выполняющийся запрос PDO прервать нельзя, а блокирующий вызов Redis — никогда.

ЗАВИСИМОСТИ

от него зависят: bulkhead(3), clickhouse-toolkit(3), context-cli(3), context-db(3), context-http(3), context-process(3), resilience(3), retry(3), yii3-clickhouse-toolkit(3)

ИСТОРИЯ

Первый релиз v0.1.0 — 2026-10-10, всего релизов: 3.

v0.3.02026-10-15
v0.2.02026-10-11
v0.1.02026-10-10
rasuvaeff/context 0.3.0мутационный порог 90%зависят пакетов 9CONTEXT(3)

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