Установка phpBB: на хостинг, в Docker и как обновить phpBB
phpBB ставится за 15 минут на любой хостинг с PHP и MySQL. Ниже — классическая установка, запуск в Docker и порядок обновления без потери данных.
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 на хостинг
- Распакуйте архив. Внутри — папка
phpBB3. - Загрузите файлы. Содержимое папки — в корень сайта или в подкаталог, например
forum. - Выставьте права. Папки
cache,files,storeиimages/avatars/uploadдолжны быть доступны для записи, как и файлconfig.php. - Запустите установщик. Откройте
https://example.ru/install/и нажмите «Установить». - Пройдите шаги. Данные администратора, подключение к базе (сервер, имя базы, пользователь, пароль, префикс таблиц), настройки почты и адрес форума.
- Удалите папку 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 выходят несколько раз в год, и среди них бывают срочные — с исправлениями уязвимостей. Откладывать их не стоит.
Перед обновлением
- Прочитайте анонс релиза на phpbb.com: там указано, что изменилось и есть ли особые шаги.
- Сделайте полную копию базы и файлов.
- Переключите форум на стандартный стиль Prosilver.
- Отключите расширения в Персонализация → Управление расширениями — отключите, но не удаляйте данные.
Способы обновления
| Способ | Когда подходит |
|---|---|
| Полный пакет | Универсальный: заменяете все файлы, кроме config.php, files, images, store и ext |
| Пакет изменённых файлов | Если ядро не правили: загружаются только файлы, изменённые с вашей версии |
| Автоматический пакет обновления | Установщик сам применяет изменения и показывает конфликты, если файлы правились |
После загрузки файлов откройте https://example.ru/install/ и выберите обновление — установщик обновит структуру базы. Если вы работаете в консоли, обновление базы можно выполнить командой php bin/phpbbcli.php db:migrate.
После обновления
- Удалите папку
install. - Очистите кэш в администраторском разделе.
- Включите расширения по одному и проверьте форум.
- Верните свой стиль, предварительно убедившись, что автор выпустил версию под новый релиз.
- Обновите языковые пакеты — после релиза переводчики обычно выпускают новую версию.
Первые настройки после установки
Сразу после установки стоит пройтись по нескольким разделам администраторского раздела:
- Общие → Настройки конференции — название, описание, часовой пояс, язык и стиль по умолчанию;
- Форумы → Управление форумами — категории и разделы;
- Общие → Регистрация пользователей — активация через почту или администратором;
- Общие → Защита от спам-ботов — вопрос-ответ или капча;
- Общие → Настройки почты — 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.