Загрузка...

Pest 5: разбираем breaking changes, параллельные кэши и почему старые костыли отправляются в архив

Pest 5: разбираем breaking changes, параллельные кэши и почему старые костыли отправляются в архив

При запуске параллельных тестов и проверки покрытия типов в крупных PHP-проектах на связке Pest + PHPStan разработчики часто сталкиваются со странными падениями. Самый яркий пример — неожиданные ошибки ParseError: syntax error в динамических temp-файлах кэша во время CI-прогонов. Разбираем, почему так происходило в Pest 4, как эту проблему решили в релизе Pest 5 и почему принудительный апдейт зависимостей до сих пор ломает старые конфигурации.

Анатомия проблемы: почему Pest 4 падает при параллельном кэшировании

В ветке Pest 4 (в частности, в плагине pestphp/pest-plugin-type-coverage) механизм сохранения кэша анализа типов устроен через неблокирующую проверку эксклюзивной блокировки файла:


$attempts = 0;
while (! flock($lock, LOCK_EX | LOCK_NB) && $attempts < 100) {
    usleep(1000);
    $attempts++;
}

if ($attempts >= 100) {
    // Пишем без блокировки!
}

Подводный камень этой реализации — поведение flock под нагрузкой. Когда параллельно стартуют сразу несколько воркеров, лимит в 100 попыток (по 1 миллисекунде) исчерпывается мгновенно. Вместо того чтобы дождаться освобождения файла, скрипт срывает защиту и пишет данные напрямую в кэш без локов. Итог: один процесс записывает кусок массива, второй в тот же момент его читает. Отсюда — повреждение cache-файлов и синтаксические ошибки.

Чтобы обойти это ограничение в Pest 4, разработчики вынуждены городить патчи через composer-скрипты, переписывающие внутреннюю логику пакета:


// Пример старого костыля для vendor/pestphp/pest-plugin-type-coverage/src/Support/Cache.php
$tmpFile = $filePath . '.' . bin2hex(random_bytes(8)) . '.tmp';
if (file_put_contents($tmpFile, $content, LOCK_EX) !== false) {
    rename($tmpFile, $filePath);
}

Что изменилось в Pest 5

В релизе Pest 5 команда переписала логику работы с файловым кэшем и зависимостями. Главные изменения:

  1. Атомарность записи: Сохранение кэша переведено на безопасную запись через временные файлы с последующим атомарным rename(), что полностью исключило чтение поврежденных кусков.
  2. Исправление таймаутов блокировки: Внутренние лимиты ожидания flock увеличены, а логика переработана с учетом особенностей многоядерных раннеров в CI (как, например, в PR #58).
  3. Интеграция с PHPStan 2.x: Пятая версия жестко завязана на новые мажорные версии стат.анализатора.

Почему нельзя просто обновиться до Pest 5 в старых проектах

Уйти с проблемной версии 4.x получается не всегда. В файле composer.json плагина pestphp/pest-plugin-type-coverage ^5.0 прописан жесткий конфликт:


"conflict": {
    "pestphp/pest": "<5.0.0",
    "phpstan/phpstan": "<2.2.7"
}

Если проект использует pestphp/pest: ^4.2, а в зависимостях тянется старый PHPStan, composer заблокирует установку пятой версии плагина. При этом бэкпортировать исправление кэша в ветку 4.x разработчики ядра не стали — финальный тег v4.0.4 так и остался с этим багом.

Резюме

Пока проект находится на Pest 4, infrastructure-скрипты вроде patch-vendor-cache.php остаются обязательным атрибутом стабильных CI-пайплайнов. Безболезненно удалить их можно будет только при комплексном переходе на Pest 5 и PHPStan ^2.2.

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *