При запуске параллельных тестов и проверки покрытия типов в крупных 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 команда переписала логику работы с файловым кэшем и зависимостями. Главные изменения:
- Атомарность записи: Сохранение кэша переведено на безопасную запись через временные файлы с последующим атомарным
rename(), что полностью исключило чтение поврежденных кусков. - Исправление таймаутов блокировки: Внутренние лимиты ожидания
flockувеличены, а логика переработана с учетом особенностей многоядерных раннеров в CI (как, например, в PR #58). - Интеграция с 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.