Установка phpBB: на хостинг, в Docker и как обновить phpBB

phpBB ставится за 15 минут на любой хостинг с PHP и MySQL. Ниже — классическая установка, запуск в Docker и порядок обновления без потери данных.

Редакция IpbordaОбновлено 20 ноября 2026 г.

phpBB — один из самых простых в установке движков форумов: дистрибутив небольшой, требования скромные, а установщик сам проверит сервер и подскажет, чего не хватает. Сложнее бывает дальше — с обновлениями, которые выходят регулярно и часто закрывают уязвимости.

Разберём установку phpBB на хостинг, запуск через Docker Compose и порядок обновления.

Что подготовить

  • Хостинг с PHP 7.2 и новее (подходит ветка PHP 8) и расширениями mysqli, gd, xml, json, zlib, mbstring.
  • База данных — MySQL или MariaDB; также поддерживаются PostgreSQL, SQLite 3 и MS SQL.
  • Пустая база и пользователь с полными правами на неё.
  • FTP или SFTP-доступ к серверу.
  • Дистрибутив — полный пакет последней версии с phpbb.com.

Если выбираете, где разместить форум, загляните в статью хостинг для форума.

Установка phpBB на хостинг

  1. Распакуйте архив. Внутри — папка phpBB3.
  2. Загрузите файлы. Содержимое папки — в корень сайта или в подкаталог, например forum.
  3. Выставьте права. Папки cache, files, store и images/avatars/upload должны быть доступны для записи, как и файл config.php.
  4. Запустите установщик. Откройте https://example.ru/install/ и нажмите «Установить».
  5. Пройдите шаги. Данные администратора, подключение к базе (сервер, имя базы, пользователь, пароль, префикс таблиц), настройки почты и адрес форума.
  6. Удалите папку install. Пока она на месте, форум закрыт предупреждением.

После этого откройте администраторский раздел и задайте структуру форумов, права групп и защиту от спама. Русский интерфейс ставится отдельно — см. русификация phpBB.

phpBB в Docker Compose

Docker удобен для локальной разработки и тестов: стили и расширения можно проверить, не трогая живой форум. Официального образа для рабочих установок у phpBB нет, поэтому проще собрать свой на базе официального образа PHP.

Dockerfile:

FROM php:8.2-apache
RUN apt-get update \
 && apt-get install -y libpng-dev libjpeg-dev libzip-dev \
 && docker-php-ext-configure gd --with-jpeg \
 && docker-php-ext-install gd mysqli zip \
 && rm -rf /var/lib/apt/lists/*

docker-compose.yml:

services:
  web:
    build: .
    ports:
      - "8080:80"
    volumes:
      - ./phpbb:/var/www/html
    depends_on:
      - db
  db:
    image: mariadb:10.11
    environment:
      MARIADB_DATABASE: phpbb
      MARIADB_USER: phpbb
      MARIADB_PASSWORD: change_me
      MARIADB_ROOT_PASSWORD: change_me_too
    volumes:
      - db:/var/lib/mysql
volumes:
  db:

Распакуйте содержимое phpBB3 в папку phpbb рядом с файлами, выполните docker compose up -d --build и откройте http://localhost:8080/install/. Сервер базы в установщике — db, остальные данные — из блока environment.

Если папка phpbb смонтирована с хоста, проверьте права на запись для пользователя www-data внутри контейнера. Для рабочего сервера добавьте HTTPS через обратный прокси, регулярные бэкапы тома с базой и не храните пароли прямо в compose-файле.

Как обновить phpBB

Обновления 3.3.x выходят несколько раз в год, и среди них бывают срочные — с исправлениями уязвимостей. Откладывать их не стоит.

Перед обновлением

  1. Прочитайте анонс релиза на phpbb.com: там указано, что изменилось и есть ли особые шаги.
  2. Сделайте полную копию базы и файлов.
  3. Переключите форум на стандартный стиль Prosilver.
  4. Отключите расширения в Персонализация → Управление расширениями — отключите, но не удаляйте данные.

Способы обновления

Способ Когда подходит
Полный пакет Универсальный: заменяете все файлы, кроме config.php, files, images, store и ext
Пакет изменённых файлов Если ядро не правили: загружаются только файлы, изменённые с вашей версии
Автоматический пакет обновления Установщик сам применяет изменения и показывает конфликты, если файлы правились

После загрузки файлов откройте https://example.ru/install/ и выберите обновление — установщик обновит структуру базы. Если вы работаете в консоли, обновление базы можно выполнить командой php bin/phpbbcli.php db:migrate.

После обновления

  1. Удалите папку install.
  2. Очистите кэш в администраторском разделе.
  3. Включите расширения по одному и проверьте форум.
  4. Верните свой стиль, предварительно убедившись, что автор выпустил версию под новый релиз.
  5. Обновите языковые пакеты — после релиза переводчики обычно выпускают новую версию.

Первые настройки после установки

Сразу после установки стоит пройтись по нескольким разделам администраторского раздела:

  • Общие → Настройки конференции — название, описание, часовой пояс, язык и стиль по умолчанию;
  • Форумы → Управление форумами — категории и разделы;
  • Общие → Регистрация пользователей — активация через почту или администратором;
  • Общие → Защита от спам-ботов — вопрос-ответ или капча;
  • Общие → Настройки почты — SMTP-сервер для отправки писем;
  • Права доступа — роли для групп в каждом разделе.

Отдельно включите модерацию первых сообщений новых пользователей: это одна из самых действенных мер против спама.

Частые ошибки при установке

  • Белый экран или ошибка 500. Не хватает PHP-расширения или версия PHP не подходит — смотрите лог ошибок хостинга.
  • Нет прав на запись. Установщик не может создать config.php или писать в cache. Проверьте права.
  • Кракозябры в кириллице. База создана не в utf8mb4. Пересоздайте её с правильной кодировкой до установки.
  • Не приходят письма. Включите отправку через SMTP в настройках почты — mail() на многих хостингах ограничен.

Что дальше

Подберите стиль и расширения в разделе стили и расширения phpBB, а общий обзор движка ищите на странице phpBB. Не хотите сами следить за обновлениями и безопасностью — закажите форум под ключ.

Частые вопросы

Что нужно для установки phpBB?

Хостинг с PHP 7.2 и новее, база MySQL, MariaDB или PostgreSQL и FTP-доступ. Подойдёт и SQLite для небольшого тестового форума.

Как обновить phpBB до последней версии?

Сделайте резервную копию, отключите стили и расширения, загрузите новые файлы или пакет изменённых файлов, запустите обновление базы через установщик и удалите папку install. Затем включите расширения обратно.

Есть ли официальный Docker-образ phpBB?

Готового официального образа для рабочих форумов нет. Обычно собирают свой образ на базе официального образа PHP с Apache и запускают его вместе с MariaDB через docker compose.

Нужно ли удалять папку install после установки phpBB?

Да. Пока папка install существует, форум показывает предупреждение и не работает в обычном режиме. Удалите её или переименуйте сразу после установки и после каждого обновления.

Можно ли обновить phpBB 3.2 сразу до 3.3?

Да, phpBB поддерживает обновление с ветки 3.2 до 3.3 полным пакетом. Перед этим проверьте, что ваши расширения и стиль совместимы с 3.3.