phpBB: ошибки после обновления — очистка кэша

#Типичные проявления

После обновления phpBB форум показывает белый экран, «General Error», ошибки в шаблонах Twig или сообщения о неизвестных классах. Причины: старый кеш в cache/production/, который не совпадает с новыми файлами; остатки устаревших файлов от прошлой версии; неполная загрузка файлов; несовместимые расширения; права на каталоги кеша; новая версия PHP. Очистка кеша и проверка файлов решают большинство проблем.

#Причины

#Порядок

1. Откройте админ-панельЕсли после обновления phpBB ACP ещё доступна, откройте «Общие» → «Очистить кэш» и подтвердите действие. Убедитесь, что на сайте исчезла старая разметка/ошибка; это штатный способ для большинства случаев устаревшего шаблона. Не удаляйте каталог форума целиком.
2. Если админка недоступна, удалите содержимое cache/production/ вручнуюЕсли ACP недоступна, через файловый менеджер сохраните копию директории cache и уточните версию форума. Для phpBB 3.x запрещено удалять защитные файлы index.htm, .htaccess и служебные каталоги в обход указаний версии. Предпочтите поддерживаемую команду очистки, если доступен PHP CLI и консольное приложение форума.
3. Проверьте права на cache/Проверьте по SSH ls -ld cache и доступность каталога на запись пользователю PHP-FPM; именно этот пользователь может отличаться от www-data. Не выполняйте chmod -R 775 cache до проверки владельца, группы и доступа других сайтов; исправляйте только доказанную ошибку прав.
4. Убедитесь, что все файлы нового релиза загружены полностьюСравните загруженные файлы phpBB с официальным пакетом той же версии: после неполной передачи по FTP форум может смешивать старые и новые классы. Если обновление прервалось, повторите штатную процедуру обновления с резервной копией, не перетирая config.php, пользовательские файлы и вложения.
5. Удалите устаревшие файлы по списку из пакета обновленияУдаление устаревших файлов phpBB допустимо только по списку, указанному для конкретного перехода версии. Не удаляйте незнакомые каталоги и модификации вручную; сначала сохраните полный архив форума и базы, затем убедитесь, что обновлённая версия работает на стенде.
6. Временно отключите расширенияЕсли ошибка началась после обновления расширения, откройте ACP → «Настройка → Управление расширениями» и отключите конкретное несовместимое расширение. Если ACP недоступна, делайте аварийное отключение только по официальной инструкции phpBB и после копии состояния расширений; массовое переименование всего ext может затронуть множество функций.
7. Проверьте журнал ошибок и версию PHPПроверьте PHP Fatal error в логах хостинга и требования установленной версии phpBB к PHP/расширениям. Версия CLI (php -v) может отличаться от PHP-FPM сайта; сверяйте веб-версию в панели и проверяйте логи непосредственно проблемного запроса.
8. Выполните обновление базы данных через install/app.php, если оно не былоЕсли после обновления требуются миграции базы данных, запустите штатный инструмент для конкретной версии phpBB в утверждённом порядке, предварительно сохранив SQL-дамп. Не выполняйте произвольную db:migrate на боевой базе до проверки совместимости. Проверьте вход, поиск, сообщения и вложения после обновления.
9. Команды для отдельных ситуацийВыберите только подходящий вариант. Это не одна последовательность: часть команд диагностирует проблему, а часть меняет настройки или данные.
   Выберите подходящий вариант — это не команды для последовательного выполнения

   Вариант 1Очистить кеш phpBB вручную (index.htm оставляем)

   Linux · Терминал (Bash)КомандаКопировать всёВыделить

   Очистить кеш phpBB вручную (index.htm оставляем)

   php bin/phpbbcli.php cache:purge

   # Наличие и синтаксис команды проверьте в установленной версии phpBB.

   # Не удаляйте файлы cache командой find без резервной копии и перечня исключений.

   Вариант 2Через консоль phpBB (версия 3.2+)

   Linux · Терминал (Bash)КомандаКопировать всёВыделить

   Через консоль phpBB (версия 3.2+)

   php bin/phpbbcli.php cache:purge

   php bin/phpbbcli.php db:migrate

   Вариант 3Права на каталоги кеша

   Linux · Терминал (Bash)КомандаКопировать всёВыделить

   Права на каталоги кеша

   ls -ld cache cache/production files store

   # Право записи проверяйте по фактическому пользователю PHP-FPM.

   Вариант 4Временно отключить расширения: переименовать каталог ext

   Linux · Терминал (Bash)КомандаКопировать всёВыделить

   Временно отключить расширения: переименовать каталог ext

   ls -ld ext

   # Отключайте только конкретное несовместимое расширение по инструкции phpBB.

   Вариант 5Журнал ошибок

   Linux · Терминал (Bash)КомандаКопировать всёВыделить

   Журнал ошибок

   tail -n 40 ~/logs/error.log

   php -v

#Как избежать повторения

Обновляйте phpBB по официальной инструкции: сначала полная копия, затем замена файлов (кроме config.php, files/, store/, images/, ext/), затем запуск install/app.php → «Обновить», удаление каталога install/ и очистка кеша. Обновляйте расширения до версий, совместимых с новой версией phpBB, на https://www.phpbb.com/customise/db/extensions-36 .