---
title: "Laravel Octane 2.24: воркер більше не тримає пам'ять великого запиту"
url: https://laravelukraine.com/blog/laravel-octane-224-vorker-bilse-ne-trimaje-pamiat-velikogo-zapitu
date: 2026-11-16
---

# Laravel Octane 2.24: воркер більше не тримає пам'ять великого запиту

[Laravel Octane 2.24.0](https://github.com/laravel/octane/releases/tag/v2.24.0), що вийшов 10 листопада, закриває давню незручність Octane на проді: воркер, який обробив один важкий запит - імпорт, експорт, великий JSON, - лишається з тією самою пам'яттю до перезапуску. Тепер зрозуміло, звідки це береться, і є штатний спосіб це прибрати.

Нагадаємо, що попередній реліз [Octane 2.23](https://laravelukraine.com/blog/laravel-octane-223-striming-vidpovidei-generatoriv-zapraciuvav-na-frankenphp-i-swoole) лагодив стрімінг відповідей-генераторів на FrankenPHP і Swoole. 2.24 - про інше.

### Звідки береться роздутий воркер

Автор змін bert-w у [PR #1181](https://github.com/laravel/octane/pull/1181) називає дві незалежні причини.

**Перша: оброблений запит лишається на посиланнях до наступного.** Octane клонує застосунок під кожен запит, але кілька довгоживучих об'єктів продовжували дивитися на останній запит:

- binding `request` базового застосунку;
- `Router::$currentRequest`;
- закешовані гарди автентифікації;
- getter застосунку в Carbon: слухач `FlushLocaleState` ставив туди замикання, яке захоплювало всю подію, а разом із нею і запит.

Тож воркер, що простоює, тримає живим свій останній запит разом з усіма даними запиту.

**Друга: PHP не віддає звільнену пам'ять.** Пам'ять, звільнена з-під дрібних значень, лишається за процесом, доки не викликати [`gc_mem_caches()`](https://www.php.net/manual/en/function.gc-mem-caches.php), PHP не наблизиться до `memory_limit` або запит не завершиться. Останнього у воркері Octane не стається ніколи. Поведінку обговорювали в [php-src#18019](https://github.com/php/php-src/issues/18019#issuecomment-2712073360).

### Що змінилося

Першу причину Octane тепер прибирає сам, нічого вмикати не треба. В кінці запиту базовий застосунок отримує назад запит, з яким він стартував, `Router::$currentRequest` обнуляється, гарди забуваються через `forgetGuards()`, а `FlushLocaleState` більше не захоплює подію в замикання.

Для другої причини з'явилися дві речі:

- подія `Laravel\Octane\Events\OperationReleased`. Цикли FrankenPHP, RoadRunner і Swoole диспетчеризують її тоді, коли сервер уже не тримає запит, задачу чи тік. Це принципова різниця з `RequestTerminated`: та подія стається, поки запит ще живий, тож звільняти пам'ять у ній запізно;
- слухач `Laravel\Octane\Listeners\ReleaseFreedMemory`. Він викликає `gc_mem_caches()`, якщо `memory_get_usage(true)` перевищує `octane.garbage` мегабайт.

### Як увімкнути

Слухач опційний. У свіжому `config/octane.php` з'явився окремий блок для нової події, куди перенесли і закоментований `CollectGarbage`. Якщо конфіг у вас опублікований давно, допишіть блок самі разом з імпортами:

```php
  use Laravel\Octane\Events\OperationReleased;
  use Laravel\Octane\Listeners\ReleaseFreedMemory;

  'listeners' => [
      // ...

      OperationReleased::class => [
          // CollectGarbage::class,
          ReleaseFreedMemory::class,
      ],
  ],
```

Поріг береться з наявного ключа `garbage`, за замовчуванням 50 МБ:

```php
  'garbage' => 50,
```

Тут є нюанс, якого PR не проговорює. Якщо прогрітий воркер вашого застосунку і так займає понад 50 МБ, умова спрацьовуватиме після кожного запиту. Вартість частих викликів `gc_mem_caches()` у PR не міряли, тому розумно підняти поріг трохи вище за пам'ять прогрітого воркера: тоді слухач працюватиме саме після важких запитів.

### Що показали виміри

Автор відтворив проблему на свіжому застосунку з FrankenPHP і одним воркером: один запит тримав на собі близько 200 МБ дрібних рядків ([gist з відтворенням](https://gist.github.com/bert-w/32831d74c1fb01cc2271bc8cffcb1e01)). Пам'ять контейнера:

| | Прогрітий | Після запиту | Після ще 20 запитів |
|---|---|---|---|
| Octane 2.22.0 | 99,8 МіБ | 388,0 МіБ | 356,1 МіБ |
| З цим PR | так само | 103,6 МіБ | 104,0 МіБ |

Важливе застереження з того ж PR: перевіряли тільки на FrankenPHP. Зміни в циклах RoadRunner і Swoole автор не тестував, тож на цих рушіях перевіряйте результат самі.

### Інші зміни релізу

**Мінімальні версії залежностей** ([#1185](https://github.com/laravel/octane/pull/1185)). `laravel/framework` тепер `^12.69.0|^13.30.0`, підтримку Laravel 11 прибрано. На Laravel 11 `composer update` просто лишить вас на 2.23, а на Laravel 12 нижче 12.69 спершу оновіть фреймворк. Для розробки пакета `orchestra/testbench` теж піднято до `^10.0|^11.0`.

**Перевірка шляху до статичних файлів у Swoole** ([#1187](https://github.com/laravel/octane/pull/1187)). Раніше `SwooleClient` перевіряв, що шлях до файлу починається з `publicPath`, без кінцевої `/`. Тому файл із сусідньої теки, назва якої починається так само, як публічна (скажімо, `public_backup` поруч із `public`), проходив перевірку. Тепер шлях має починатися з `publicPath/`, і це покриває новий тест. Зачіпає лише Swoole з увімкненим `serve_static_files` і лише за умови, що поруч із публічною текою лежить така сусідня тека. Окремої рекомендації з безпеки до релізу немає, але якщо ви тримаєте копії `public` поруч на сервері зі Swoole, оновитися варто.

### Чи варто оновлюватися

Якщо ви на Laravel 12.69+ або 13.30+, так: скидання посилань на запит працює для всіх без налаштувань, і ризик тут невеликий.

`ReleaseFreedMemory` вмикайте з вимірами. Зніміть RSS воркерів до і після (`docker stats`, `ps -o pid,rss,cmd -p <pid>`) на тому самому важкому запиті, або тимчасово логуйте `memory_get_usage(true)` у власному слухачі на `OperationReleased`. Якщо пам'ять після піків повертається до рівня прогрітого воркера, можна подумати про вищий `--max-requests`. Але не прибирайте його зовсім: він захищає і від витоків у вашому власному коді, наприклад від статичних кешів чи синглтонів, що ростуть від запиту до запиту, а з цим реліз нічого не робить.
