Что даёт турборежим

Постоянный процесс держит индексы всех наборов в памяти и отвечает на AJAX-запросы фильтра без запуска MODX. Замер на 500 тыс. товаров: обычный эндпоинт 37–45 мс, турбо 17–27 мс, повтор того же запроса ~4 мс; на 2 тыс. товаров — 7–11 мс против 21–24 мс. Первая загрузка страницы идёт через MODX, как обычно.

Нужно: VDS с консолью, PHP CLI с расширениями pcntl и posix, nginx, systemd (или supervisor). Памяти — примерно размер индексов всех наборов; воркеры делят её с основным процессом.

Турборежим необязателен. Без него всё работает: страницы обращаются к обычному эндпоинту publicConnector.php.

Включение

Тексты ниже собраны с путями этого сайта. Пользователь службы — тот же, от которого работает пул php-fpm сайта.

  1. Служба systemd — создайте файл и запустите:
    @@unit@@
  2. nginx — добавьте в server { } сайта и перезагрузите nginx (nginx -t && systemctl reload nginx). Пользователь nginx должен иметь доступ к сокету (права 0660 — nginx должен входить в группу пользователя сайта):
    @@nginx@@
  3. Настройка — вкладка «Настройки» → «Турборежим» → адрес /bitfacet-turbo (это системная настройка bitfacet.turbo_url) → «Проверить связь»: оба пункта должны быть зелёными.
  4. Проверка — в «Обзоре» блок «Турборежим» показывает «Работает»; в ответах фильтра есть заголовок X-BitFacet: turbo.

Как он себя ведёт

Параметры и обслуживание

--workers=4сколько запросов одновременно (обычно по числу ядер)
--max-requests=10000после стольких запросов воркер перезапускается
--memory=256перезапуск воркера, если его память выросла на столько МБ
--socket=свой путь сокета (по умолчанию turbo.sock в папке индексов)
systemctl status @@service@@      # состояние
systemctl restart @@service@@     # перезапуск
journalctl -u @@service@@ -n 50   # журнал процесса

Несколько магазинов на одном сервере — у каждого своя служба (имя — по адресу сайта), свой сокет и свой блок nginx; общие у них только память и процессор. На небольшом сервере можно поставить --workers=2.