Laravel Octane 2.24.0, що вийшов 10 листопада, закриває давню незручність Octane на проді: воркер, який обробив один важкий запит - імпорт, експорт, великий JSON, - лишається з тією самою пам'яттю до перезапуску. Тепер зрозуміло, звідки це береться, і є штатний спосіб це прибрати.
Нагадаємо, що попередній реліз Octane 2.23 лагодив стрімінг відповідей-генераторів на FrankenPHP і Swoole. 2.24 - про інше.
Звідки береться роздутий воркер
Автор змін bert-w у PR #1181 називає дві незалежні причини.
Перша: оброблений запит лишається на посиланнях до наступного. Octane клонує застосунок під кожен запит, але кілька довгоживучих об'єктів продовжували дивитися на останній запит:
- binding
request базового застосунку;
Router::$currentRequest;
- закешовані гарди автентифікації;
- getter застосунку в Carbon: слухач
FlushLocaleState ставив туди замикання, яке захоплювало всю подію, а разом із нею і запит.
Тож воркер, що простоює, тримає живим свій останній запит разом з усіма даними запиту.
Друга: PHP не віддає звільнену пам'ять. Пам'ять, звільнена з-під дрібних значень, лишається за процесом, доки не викликати gc_mem_caches(), PHP не наблизиться до memory_limit або запит не завершиться. Останнього у воркері Octane не стається ніколи. Поведінку обговорювали в php-src#18019.
Що змінилося
Першу причину 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. Якщо конфіг у вас опублікований давно, допишіть блок самі разом з імпортами:
use Laravel\Octane\Events\OperationReleased;
use Laravel\Octane\Listeners\ReleaseFreedMemory;
'listeners' => [
// ...
OperationReleased::class => [
// CollectGarbage::class,
ReleaseFreedMemory::class,
],
],
Поріг береться з наявного ключа garbage, за замовчуванням 50 МБ:
'garbage' => 50,
Тут є нюанс, якого PR не проговорює. Якщо прогрітий воркер вашого застосунку і так займає понад 50 МБ, умова спрацьовуватиме після кожного запиту. Вартість частих викликів gc_mem_caches() у PR не міряли, тому розумно підняти поріг трохи вище за пам'ять прогрітого воркера: тоді слухач працюватиме саме після важких запитів.
Що показали виміри
Автор відтворив проблему на свіжому застосунку з FrankenPHP і одним воркером: один запит тримав на собі близько 200 МБ дрібних рядків (gist з відтворенням). Пам'ять контейнера:
|
Прогрітий |
Після запиту |
Після ще 20 запитів |
| Octane 2.22.0 |
99,8 МіБ |
388,0 МіБ |
356,1 МіБ |
| З цим PR |
так само |
103,6 МіБ |
104,0 МіБ |
Важливе застереження з того ж PR: перевіряли тільки на FrankenPHP. Зміни в циклах RoadRunner і Swoole автор не тестував, тож на цих рушіях перевіряйте результат самі.
Інші зміни релізу
Мінімальні версії залежностей (#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). Раніше 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. Але не прибирайте його зовсім: він захищає і від витоків у вашому власному коді, наприклад від статичних кешів чи синглтонів, що ростуть від запиту до запиту, а з цим реліз нічого не робить.