---
title: "PHPStan 2.3 на реальному Laravel-застосунку: що прискорилося, а що зламалося"
url: https://laravelukraine.com/blog/phpstan-23-na-realnomu-laravel-zastosunku-shho-priskorilosia-a-shho-zlamalosia
date: 2026-11-18
source: https://dev.to/tegos/phpstan-23-on-a-real-laravel-app-what-got-faster-what-broke-1d08
---

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

PHPStan 2.3 вийшов 1 жовтня з гучною обіцянкою: до 7,5 раза швидше, ніж PHPStan 2.1 минулого грудня. Цифри з [анонсу випуску](https://laravelukraine.com/blog/phpstan-23-stribok-produktivnosti-pokrashheni-generics-i-viiavlennia-nevikoristanix-zminnix) зняли на 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 пояснює чому:

```plaintext
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-властивості, які заповнюються в конструкторі. Ось одна, із сервісу, що завантажує типи цін для користувача (назви скорочено):

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

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

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

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

```php
// ПІСЛЯ
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 краще виводить типи колекцій. Наприклад:

```plaintext
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? Додайте це до копії своєї конфігурації:

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

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

### Посилання

- [PHPStan 2.3: Leap in Performance, Generics Improvements, Detecting Unused Variables, and More!](https://phpstan.org/blog/phpstan-2-3-leap-in-performance)
- [Випуски PHPStan](https://github.com/phpstan/phpstan/releases)
- [Випуски Larastan](https://github.com/larastan/larastan/releases)
