Увійти Реєстрація
Вакансії
Вакансії Laravel Компанії Статистика
Підготовка
Як підготуватися Співбесіди Тестування Документація
Блог
Всі статті Серії
Екосистема
Пакети Ресурси Проєкти Інструменти Події Відео
Інше
Про нас Реклама
Переклади 18 листопада 2026

PHPStan 2.3 на реальному Laravel-застосунку: що прискорилося, а що зламалося

PHPStan 2.3 вийшов 1 жовтня з гучною обіцянкою: до 7,5 раза швидше, ніж PHPStan 2.1 минулого грудня. Цифри з анонсу випуску зняли на WordPress і Drupal. Гарні проєкти, але не той код, з яким я працюю щодня.

Тож того ж місяця я оновив робочий Laravel-застосунок і заміряв час. Холодний запуск став удвічі швидшим. Запуск, який я роблю п'ятдесят разів на день, зекономив приблизно секунду. А новий детектор невикористаних змінних не знайшов нічого, бо Rector уже все прибрав.

Ось що я заміряв, що зламалося і чому я поки не вмикаю bleeding edge.

Налаштування

Застосунок - Laravel 11-проєкт середнього розміру, над яким я працюю:

  • app/ з 1145 PHP-файлами
  • Larastan, рівень 5, плюс phpstan-baseline.neon
  • PHP 8.3 у Docker-контейнері, 4 CPU, на WSL2, код лежить у файловій системі Linux
  • до: PHPStan 2.2.8 + Larastan 3.10, після: PHPStan 2.3.1 + Larastan 3.13

Larastan уважно стежить за випусками PHPStan, тож я оновив обидва разом. Це означає, що кожна цифра нижче - це «оновлення PHPStan і Larastan», а не самого PHPStan.

Невеликий shell-скрипт запускав phpstan analyse -vv по 10 разів на кожен сценарій і записував у CSV час, пікову пам'ять і кількість повторно проаналізованих файлів. Перед холодними запусками він видаляв кеш. Я наводжу медіану, а там, де запуски помітно скакали, - ще й діапазон від мінімуму до максимуму.

Застереження: це одна машина, усередині Docker, на WSL2, на рівні 5. Заміряйте власний проєкт, перш ніж довіряти цим цифрам. Вищі рівні роблять більше роботи й можуть поводитися інакше.

Холодні запуски: головна обіцянка справджується

Холодний запуск - це запуск без кешу результатів (result cache). Тобто ваш перший локальний запуск після git clone або кожне завдання CI, яке не відновлює кеш.

Сценарій 2.2.8 2.3.1
Холодний запуск, медіана 34,0 с 15,7 с
Холодний запуск, мін-макс 27-55 с 12-19 с

Удвічі швидше і значно стабільніше. З 2.2.8 один запуск тривав 27 секунд, а інший - 55. З 2.3.1 усе вклалося між 12 і 19.

Анонс випуску порівнює з PHPStan минулого грудня, а той значно старший за 2.2.8. Тож мої «удвічі» не суперечать їхнім 7,5 раза. Чимала частина цього прискорення вже вийшла у випусках 2.2, які в мене стояли.

Пам'яті стало потрібно трохи більше: мій скрипт показав близько 1,4 ГБ на 2.2.8 і 1,55 ГБ на 2.3.1. Ставтеся до цього обережно. Скрипт підсумовує пам'ять усіх процесів PHPStan, а 2.3 запускає воркери через fork, тож частину спільної пам'яті, мабуть, пораховано двічі. Якщо ваш CI працює на слабкому раннері, перевірте це самі до оновлення.

Для CI анонс випуску має рацію. Якщо ваш пайплайн запускає PHPStan без закешованого результату, саме лише це оновлення скоротить цей крок удвічі.

Теплі запуски: там, де ви насправді живете

Але є нюанс: локально я майже ніколи не запускаю PHPStan «на холодну». Я змінюю файл, запускаю, змінюю знову. Це теплий шлях, з кешем результатів від попереднього запуску.

Сценарій 2.2.8 2.3.1
Нічого не змінилося 1,2 с 1,6 с
Змінено один файл 3,2 с 2,0 с
Оновлено guzzlehttp/guzzle 2,6 с, 1 файл 5,7 с, 198 файлів
Оновлено laravel/framework 26,7 с, усі файли 10,5 с, усі файли

Коли нічого не змінилося, 2.3.1 повільніший на 0,4 секунди. Коли змінено один файл - швидший на секунду. Це і є реальна щоденна різниця, і ви ледве відчуєте як одне, так і друге.

Для рядків із пакетами я не робив справжнього composer update. Я змінив reference пакета у vendor/composer/installed.php і один байт у composer.lock, і цього достатньо, щоб PHPStan побачив змінений пакет. Близько до справжнього оновлення, але не те саме.

Оновлення laravel/framework змушує обидві версії викинути весь кеш результатів. З -vv PHPStan пояснює чому:

Composer packages changed (laravel/framework) and register a class in the container; re-analysing everything

«Контейнер» тут - це власний DI-контейнер PHPStan, а не Laravel. Larastan реєструє класи Laravel, як-от Illuminate\Foundation\Application, як сервіси PHPStan, тож оновлення фреймворку зачіпає пакет, від якого залежить сам PHPStan. Повний повторний аналіз - безпечна відповідь. Він усе одно швидший за холодний запуск, бо кеш рефлексії зберігається, і 2.3.1 потрібно 10,5 секунди замість 26,7.

Рядок із guzzle мене здивував. В анонсі випуску сказано:

Раніше проєкт повністю аналізувався заново, коли оновлювалася будь-яка залежність Composer або коли хоч якось змінювався DI-контейнер Symfony.

На моєму застосунку, з моїм імітованим оновленням, 2.2.8 повторно проаналізував лише 1 файл. 2.3.1 проаналізував 198 і витратив удвічі більше часу. Я не перевіряв це справжнім composer update і не знаю, що це за 198 файлів. Тож висновків не роблю. Просто не дивуйтеся, якщо дрібне оновлення пакета займе на кілька секунд більше, ніж раніше.

Чого коштувало оновлення

Без bleeding edge оновлення принесло мені 4 нові помилки. Усі однакової форми: порожній Collection::make(), який PHPStan тепер читає як колекцію never.

Три з них - readonly-властивості, які заповнюються в конструкторі. Ось одна, із сервісу, що завантажує типи цін для користувача (назви скорочено):

// ДО: @var на властивості після оновлення вже не допомагає
final readonly class PriceTypeService
{
  /**
   * @var Collection<int, PriceTypeDto>
   */
  private Collection $priceTypes;

  public function __construct()
  {
    $this->priceTypes = Collection::make();
  }
}

Властивість має правильний @var, але після оновлення тип береться з присвоєння в конструкторі. Порожня колекція не має ні ключів, ні значень, тож тип стає Collection<never, never>, і код, який із неї читає, починає падати.

Виправлення - @var на локальній змінній перед присвоєнням:

// ПІСЛЯ
public function __construct()
{
  // PHPStan 2.3 виводить тип readonly-властивості з присвоєння в конструкторі, а не з @var
  /** @var Collection<int, PriceTypeDto> $priceTypes */
  $priceTypes = Collection::make();
  $this->priceTypes = $priceTypes;
}

Негарно, але коментар пояснює наступному розробникові, навіщо тут зайвий рядок.

Не можу сказати, звідки ця зміна - з PHPStan 2.3 чи з Larastan 3.13. Вони зайшли разом.

Сім записів у phpstan-baseline.neon перестали збігатися, і baseline скоротився на 42 рядки. Два з них стосувалися репозиторію кошика, який я виправив у тому самому коміті, тож вони не рахуються. Інші п'ять зникли самі, бо 2.3 краще виводить типи колекцій. Наприклад:

Method SupplierRepository::getSupplierDeliveryCurrencyData() should return
Collection<int, CurrencyEnum|null> but returns Collection<(int|string), CurrencyEnum|null>.

Це було хибне спрацювання. Тепер 2.3 це розуміє.

Bleeding edge: спершу порахувати, потім вмикати

Bleeding edge - це конфігурація, яку вмикають явно; вона активує правила, заплановані на наступну мажорну версію. У 2.3 найкращі нові можливості сховані саме за нею: детектор невикористаних змінних і нове виведення типів для generics. Я хотів знати, чого вони коштуватимуть, перш ніж їх вмикати.

Хитрість у тому, щоб порахувати, перш ніж перегенерувати baseline. Якщо ввімкнути bleeding edge і одразу запустити --generate-baseline, кожна нова помилка зникне в baseline, і ви так і не дізнаєтеся, що він знайшов.

Тож я ввімкнув його, запустив аналіз і згрупував помилки за ідентифікатором:

Ідентифікатор Кількість
property.internal 8
ignore.unmatched 7
return.type 6
argument.type 2
Усі ідентифікатори невикористаних змінних 0

23 помилки, і жодна з них не була багом:

  • property.internal: наші Artisan-команди використовують $this->components для гарного виводу в консоль, а Laravel позначає його як @internal. Одне правило ігнорування глушить усі 8.
  • ignore.unmatched: записи baseline, які більше не збігаються. Це прибирання. Я не перевіряв, чи це ті самі 7 записів, що й після звичайного оновлення.
  • return.type і argument.type: нові generics точніші за наші теги @return. Це 8 правок у PHPDoc.

А детектор невикористаних змінних знайшов нуль. Спершу я подумав, що на рівні 5 він не працює, тож перевірив його на тестовому файлі з мертвим присвоєнням. Він спрацював. Наш код був просто чистим.

Виявилося, Rector дістався туди першим. Проєкт запускає Rector із SetList::DEAD_CODE у composer test, тож мертве присвоєння провалює перевірку ще до злиття. Цей набір покриває присвоєння невикористаних змінних. Він покриває не все, що тепер знаходить PHPStan (у правил *Flow, наприклад, немає двійника в Rector), але й для них у цій кодовій базі нічого не лишилося.

З увімкненим bleeding edge ті 4 помилки Collection<never, never> з попереднього розділу зникають. Нове виведення типів дивиться, як колекцію використовують далі, тож знаходить тип без моїх рядків з @var.

Отже, ціна - 8 правок у PHPDoc і одне правило ігнорування. Натомість я видалив би 4 обхідні рішення і не знайшов би жодного бага. Поки що не варто, тож на цьому проєкті я його не вмикав. Повернуся до питання, якщо набір мертвого коду Rector зникне з проєкту або коли PHPStan 3 і так зробить ці правила стандартними.

Моє емпіричне правило

  • Оновлюйтеся до 2.3 заради холодних запусків. У CI без відновленого кешу PHPStan стає приблизно вдвічі швидшим.
  • Не чекайте, що ваш локальний цикл сильно зміниться. Теплі запуски й так були швидкими.
  • Стежте за Collection<never, never> на readonly-властивостях. @var на локальній змінній це виправляє.
  • Перш ніж вмикати bleeding edge, порахуйте помилки за ідентифікаторами. Не перегенеровуйте baseline заздалегідь.
  • Якщо у вашому проєкті вже працює набір DEAD_CODE від Rector, детекторові невикористаних змінних може майже нічого не лишитися. Спершу порахуйте й подивіться.

💡 Хочете знати, чого вам коштуватиме bleeding edge? Додайте це до копії своєї конфігурації:

includes:
  - vendor/phpstan/phpstan/conf/bleedingEdge.neon

Потім запустіть аналіз із --error-format=json і згрупуйте помилки за значенням identifier.

Посилання

Переклад оригіналу: dev.to
0

Читати в документації

Коментарі

Увійдіть, щоб залишити коментар

Будьте першим, хто залишить коментар!

Читайте також

Laravel AI SDK у продакшні
Переклади 19 листопада 2026

Новинний пайплайн на Laravel AI SDK: агенти, structured output і пастки, про які не попереджають

Переказ статті Івайло Ніколова про сервіс, що щодня обробляє десятки тисяч новин на laravel/ai: ембединги, кластеризація в pgvector, агенти зі structured output і три збої, яких не помітив жоден тест.

12
wire:key
Переклади 18 листопада 2026

wire:key у Livewire 4: рядок, що зберіг чужі дані

Чому в Livewire 4 без wire:key нотатка в полі вводу і відкрите Alpine-меню після видалення рядка переїжджають на сусідній запис, хоча дані з сервера правильні. Розбираємо морфінг, правильні ключі для списків, вкладених і lazy-компонентів та тест на Pest.

10

Вакансії за темою

TrueLabel
31 день тому

Senior PHP Software Engineer (Payments)

Розробник бекенду для мікросервісу платежів: онбординг і підтримка інтеграцій з платіжними провайдерами, розвиток функціоналу депозитів, виведень і керування валютами, а також основного рушія обробки платежів. Стек: Laravel 10, PHP 8.1, MySQL, RabbitMQ, Docker. Вимоги: понад 5 років комерційного досвіду з PHP, точна грошова арифметика через bcmath, робота з REST API та сторонніми HTTP API, покриття коду тестами, участь у код-рев'ю та розбір продакшн-інцидентів.

Senior Full Stack Engineer (AI-Native) (PHP (Laravel) and TypeScript)

Розробка бекенду на Laravel (MVC) та мобільного застосунку на Expo/React Native з TypeScript для фінтех-проєкту: від API і моделей даних до релізу та моніторингу. Завдання включають модульну еволюцію монолітного коду, оптимізацію продуктивності, безпеку та надійні інтеграції з партнерами, наприклад бюро кредитних історій. Вимоги: досвід власного production MVC-бекенду, робота з чутливими даними, зміни в React Native-застосунку, активне використання LLM-інструментів.

FAVBET Нова
Вчора

PHP Tech Lead

Технічний лідер PHP-команди з ownership над ключовими сервісами: інтеграціями, обробкою транзакцій і сегментацією користувачів. Проєктує сервіси, веде SDD і TIP, робить code review, менторить розробників і впроваджує AI-assisted розробку. Вимоги: 6+ років досвіду на Symfony або Laravel, 2+ роки на ролі Tech Lead, глибоке знання PHP 8+ і Symfony, PostgreSQL, Redis, RabbitMQ, Docker/Kubernetes.

Пакети за темою

Larastan

larastan/larastan

Статичний аналіз для Laravel: вчить PHPStan розуміти фасади, магічні методи Eloquent і контейнер. Ловить помилки типів і неіснуючі методи до того, як код дійде до тестів.

6,482 v3.10.0 13 2

Kalimera

welldigit/kalimera

Interactive installer that scaffolds Laravel applications the Well Digit way.

v1.0.0 17