Infection

Infection — инструмент мутационного тестирования для PHP. Testo подключается к нему через отдельный адаптер php-testo/bridge-infection.

Установка

Поставьте Infection и пакет интеграции как dev-зависимости:

composer require --dev infection/infection php-testo/bridge-infection

Если вы используете Phar-архив Infection, то адаптер устанавливать не нужно — он уже включён в состав Phar.

Конфигурация

Для работы Infection требуются два отчёта от Testo:

• Coverage XML — папка с XML-файлами в формате PHPUnit Coverage. По нему Infection понимает, какими тестами покрываются строки кода, чтобы запускать только нужный набор тестов для каждого мутанта. Обязательно.
• JUnit XML — единый файл с результатами тестов. Помогает Infection быстро сопоставлять тест с файлом, в котором он лежит, чтобы эффективнее пользоваться фильтрами Testo. Опционально, но сильно рекомендуется.

Оба отчёта Infection ищет в фиксированной структуре:

└── <tmpDir>/
    └── infection/
        ├── coverage-xml/*.xml
        └── junit.xml

Важный момент:

tmpDir мы должны указать в настройках Infection а путь до coverage-xml — в testo.php.

infection.json

В настройках Infection (обычно infection.json) укажите, что вы используете Testo, и настройте временную директорию:

{
    "$schema": "vendor/infection/infection/resources/schema.json",
    "source": {
        "directories": ["src"]
    },
    "testFramework": "testo",
    "tmpDir": "runtime",
    "logs": {
        "text": "runtime/infection.log",
        "html": "runtime/infection.html"
    }
}

testo.php

Зарегистрируйте плагин Codecov с отчётом PhpUnitXmlReportnew PhpUnitXmlReport(string $outputDir)Генерирует отчёт в формате PHPUnit Coverage XML — директорию с индексом и отдельным файлом для каждого исходника., указывающим на папку <tmpDir>/infection/coverage-xml:

use Testo\Application\Config\ApplicationConfig;
use Testo\Codecov\CodecovPlugin;
use Testo\Codecov\Report\PhpUnitXmlReport;

return new ApplicationConfig(
    src: ['src'],
    plugins: [
        new CodecovPlugin(
            reports: [
                new PhpUnitXmlReport(__DIR__ . '/runtime/infection/coverage-xml'),
            ],
        ),
    ],
);

Для сбора покрытия требуется расширение PCOV или XDebug. О настройке расширений и компромиссах между ними подробно написано на странице Codecov.

Запуск

XDEBUG_MODE=coverage vendor/bin/infection

Можно использовать PCOV — требования к драйверу покрытия диктует Codecov, а не Infection.

Infection прогоняет Testo дважды:

1. Начальный прогон — запускает все тесты против оригинального кода и параллельно собирает покрытие и JUnit-лог. Это медленная фаза: тесты идут целиком, а драйвер покрытия активен.
2. Прогон мутантов — для каждого мутанта Infection берёт только те тесты, которые задевают изменённые строки, и запускает их. Покрытие здесь уже не собирается, поэтому каждый мутант проверяется быстро.

Переиспользование готового покрытия

Если отчёт о покрытии уже сгенерирован — например, на предыдущем шаге CI — его можно подсунуть Infection вместо нового прогона Testo с помощью флага --coverage:

vendor/bin/infection --coverage=runtime/infection

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

Чтобы получить эти отчёты, запустите Testo с флагами --coverage --log-junit=<tmpDir>/infection/junit.xml — так же, как это делает адаптер для начального прогона. Важно, чтобы структура папок и имена файлов совпадали с тем, что ожидает Infection.