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

ИМЯ ​

understudy — тестовые дублёры, где настраиваемый вызов — это настоящий вызов метода, а не строка с его именем

ОБЗОР ​

$ composer require --dev rasuvaeff/understudy

use Rasuvaeff\Understudy\Understudy;use function Rasuvaeff\Understudy\expect;use function Rasuvaeff\Understudy\when; $repository = Understudy::for(BookRepository::class); when(fn () => $repository->find(123))->returns($book); expect(fn () => $repository->save($book))->times(1);

Переименуете find — IDE переименует и вызов в тесте, а устаревший вызов поймает статический анализ. for() возвращает собственный тип контракта.

ОПИСАНИЕ ​

Тестовые дублёры, где настраиваемый вызов — это настоящий вызов, а не строка с именем метода.

Моки на строках ломаются при рефакторинге и опечатках, а ещё добавляют в дублёр служебные методы (shouldReceive, expects), которые дублируемый контракт потом никогда не сможет использовать.

  • Описывает вызовы настоящими замыканиями: when(fn () => $repo->find(123))->returns($book).
  • expect() с times(); проверка постфактум через verify() (включая never: true) и nothingElse().
  • Матчеры аргументов: Arg::any, satisfies, rest и captor с типизированными last() / all().
  • Дублирует сразу несколько интерфейсов; работает с final-классами и property hooks из PHP 8.4.
  • Understudy::delegate() передаёт незаглушённые вызовы настоящему объекту и записывает их.
  • Один контекст на файбер вместо общего статического состояния.
  • Аргументы с #[\SensitiveParameter] скрываются в сообщениях об ошибках и в transcript().

ПРИМЕРЫ ​

Типизированный captor достаёт аргумент, реально переданный тестируемым кодом, без instanceof.

$options = Arg::captor(DeliveryOptions::class);  // Captor<DeliveryOptions>when(fn () => $store->temporaryUrl(Arg::any(), Arg::any(), $options->capture()))    ->returns('https://…'); $subject->run(); $options->last()->downloadName;  // typed: DeliveryOptions$options->all();  // list<DeliveryOptions>, in call order

Условие where() проверяет несколько аргументов сразу; отклонённый вызов получает ответ по умолчанию.

$ledger = Understudy::for(Ledger::class);Understudy::label($ledger, 'ledger'); when(fn() => $ledger->transfer(Arg::any(), Arg::any()))    ->where(fn(int $from, int $to) => $from <= $to, description: 'where(from <= to)')    ->returns(true); $ledger->transfer(3, 7);  // true: the where() guard accepts it$ledger->transfer(9, 4);  // false: refused by the guard, falls to the default answer

Строгий режим отклоняет любой незаданный вызов, а сообщение называет этот вызов.

$strict = Understudy::for(Clock::class);Understudy::label($strict, 'clock');Understudy::strict($strict); when(fn() => $strict->now())->returns(7); try {    $strict->zone();} catch (StrictModeViolation $violation) {    $violation->getMessage();names the refused call: zone()}

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

PackageRole
understudy-testo(3)Адаптер для Testo
understudy-phpunit(3)Адаптер для PHPUnit и Pest
understudy-psalm(3)Плагин Psalm
understudy-phpstan(3)Расширение PHPStan

ОШИБКИ ​

when() — это разрешение, а не утверждение. expect() считает только вызовы, подходящие под его собственные аргументы, поэтому для отлова прочих вызовов добавьте Understudy::nothingElse(). Только dev-зависимость, не для production.

Требует PHP 8.3–8.5 и ext-tokenizer.

ЗАВИСИМОСТИ

от него зависят: understudy-phpstan(3), understudy-phpunit(3), understudy-psalm(3), understudy-testo(3)

ИСТОРИЯ

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

v1.1.12026-10-14
v1.1.02026-10-13
v1.0.12026-10-08
v1.0.02026-09-27
v0.12.02026-09-19
v0.11.02026-09-18
v0.10.02026-09-06
v0.9.02026-09-05
v0.8.02026-09-05
v0.7.22026-09-04

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

rasuvaeff/understudy 1.1.1мутационный порог 92%зависят пакетов 4UNDERSTUDY(3)

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