Document restarting PHP after deploying updates (opcache gotcha)

2026-07-06 17:06:05 +03:00
parent 4d87deb176
commit ec57fbc633
2 changed files with 27 additions and 0 deletions
@@ -47,5 +47,19 @@ occ-команд.
  завершаться по таймауту с ошибкой.
 - Не используйте `occ maintenance:mode --on`, это очевидно...

+## Обновление кода на сервере
+
+После того как новый код скопирован/спуллен в `nextcloud/apps/occweb/`,
+обязательно перезапустите PHP, иначе изменения не применятся. `occ
+app:disable`/`app:enable` **не помогает** — эта команда не сбрасывает
+opcode-кэш PHP, из-за чего может продолжать работать старая закэшированная
+версия кода (характерный симптом — маршруты внезапно отвечают 404).
+Перезапустите сам процесс PHP, например:
+
+```bash
+sudo systemctl restart php8.3-fpm   # укажите свою версию PHP
+sudo systemctl restart apache2      # если PHP работает как модуль Apache
+```
+
 ## Планы (TODO):
 См. [открытые issues](https://github.com/Adphi/occweb/issues)