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().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()}
| Package | Role |
|---|---|
| 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.1 | 2026-10-14 |
| v1.1.0 | 2026-10-13 |
| v1.0.1 | 2026-10-08 |
| v1.0.0 | 2026-09-27 |
| v0.12.0 | 2026-09-19 |
| v0.11.0 | 2026-09-18 |
| v0.10.0 | 2026-09-06 |
| v0.9.0 | 2026-09-05 |
| v0.8.0 | 2026-09-05 |
| v0.7.2 | 2026-09-04 |
… и ещё 11 раньше. Все релизы
/ поиск · n N следующее, предыдущее · g G начало, конец · q к индексу