phpBB Linux

phpBB: ошибка после установки — config.php не найден

  • Обновлено
  • Чтение ≈ 4 минуты

Краткий ответ

Ошибка установки phpBB, связанная с config.php, возникает из-за отсутствия прав на запись, неверных данных базы, остатков прошлой установки или несовместимой версии PHP. Проверьте права, удалите старый config.php, создайте базу и перезапустите установщик.

В этой статье
  1. Как работает установка
  2. Причины
  3. Порядок
  4. Что делать при обновлении
phpBB config.php error
Unable to write config.php / The config.php file is not writable / Не удалось подключиться к базе данных
По-русскиУстановщик не может создать или прочитать config.php.

#Как работает установка

Установщик phpBB (install/app.php) создаёт файл config.php в корне форума с параметрами подключения к базе. Если файла нет, он будет создан; если он уже существует и не пуст, phpBB решит, что форум установлен, и перенаправит на сам форум или выдаст ошибку. Проблемы возникают в трёх случаях: нет прав на запись в корень форума, в config.php остались данные прошлой установки, либо данные подключения к базе неверны (хост, имя, пользователь, пароль, префикс таблиц). Сначала определите, на каком шаге появляется сообщение.

#Причины

Возможная причинаКак узнатьЧто делать
Нет прав записи на config.phpФайл недоступен.Unable to write.Определите пользователя PHP и точечно настройте доступ на время установки; не назначайте 666/777.
Остатки старого config.phpНепустой файл.Редирект на форум.Для переноса восстановите действующий config.php из копии; для новой установки соблюдайте процедуру своей версии.
Неверные данные БДОпечатка.Невозможно подключиться.Проверьте mysql.
Неверный префикс таблицОстались таблицы.Таблицы уже существуют.При новой установке выберите незанятый префикс после проверки таблиц; существующую базу не очищайте.
Старая версия PHPНесовместимо.Ошибка требований.Обновите PHP.
Отсутствует расширениеmysqli.Нет драйвера.Включите модуль.

#Порядок

  1. Убедитесь, что config.php есть в корне нужного форумаПосле установки phpBB откройте корень форума через файловый менеджер хостинга или SSH и убедитесь, что рядом с common.php существует config.php. Сверьте реальный путь из сообщения об ошибке с документ-корнем сайта: при переносе файлов иногда копируется только часть каталога или меняется корень виртуального хоста.
  2. Отличите новую установку от переноса существующей базыЕсли config.php отсутствует, выясните, была ли завершена штатная установка. Для нового форума запустите установщик phpBB согласно документации своей версии, указав существующую базу и пользователя; для перенесённого форума восстановите именно его config.php из резервной копии. Не создавайте пустой файл с фиктивными реквизитами на работающей базе.
  3. Проверьте реквизиты подключения в config.phpОткройте config.php для чтения в редакторе панели и проверьте значения $dbhost, $dbname, $dbuser и правильность PHP-синтаксиса. Пароль не выводите в публичные ошибки или отчёт; при необходимости обновите реквизиты одновременно с настройками учётной записи БД.
  4. Проверьте доступность config.php для веб-PHP без прав 777Проверьте права доступа к config.php и его родительскому каталогу через ls -l и namei -l, если есть SSH. PHP должен читать конфигурацию, но её нельзя делать доступной на запись всем пользователям сервера. Восстановите права по владельцу, группе и требованиям версии phpBB, не используйте chmod 777.
  5. Проверьте работу форума после восстановления файлаПосле восстановления перезагрузите главную страницу и /adm/, проверьте журнал PHP на отсутствие ошибок чтения и подключения к базе. Если файл есть, но phpBB сообщает об ошибке, уточните путь виртуального хоста и проверьте синтаксис php -l config.php в совместимой версии PHP; не удаляйте базу данных для устранения отсутствующего файла.
  6. Сверьте полноту переноса и версии phpBB и PHPЕсли форум переносился на новый хостинг, сравните на старом и новом сервере версию PHP и состав расширений, убедитесь, что весь каталог phpBB скопирован. Очистку кеша проводите только после копирования настроек и проверки текущей версии форума; несоответствие файлов разных выпусков требует согласованного обновления.
  7. Убедитесь, что конфигурация не доступна посетителямСохраните контрольную копию восстановленного config.php отдельно от публичного каталога и проверьте, что веб-сервер не отдаёт его исходный код как текст. Если браузер предлагает скачать PHP-файл, немедленно ограничьте доступ к сайту: это признак неработающего обработчика PHP и возможной утечки паролей.
  8. Проверьте ограничения PHP и системные политики доступаЕсли после проверок файл недоступен только из PHP, проверьте ограничения open_basedir, AppArmor/SELinux и пользователя фактического пула PHP-FPM через панель. Перед изменениями соберите имя файла, текст ошибки, версии PHP/phpBB; при отсутствии доступа администратора передайте эту информацию поддержке хостинга.
  9. Команды для отдельных ситуацийВыберите только подходящий вариант. Это не одна последовательность: часть команд диагностирует проблему, а часть меняет настройки или данные.
    Выберите подходящий вариант — это не команды для последовательного выполнения
    Вариант 1Проверка версии PHP и расширений
    Linux · Терминал (Bash)Команда
    Проверка версии PHP и расширений
    php -v
    php -m | grep -Ei 'mysqli|pdo_mysql|json|xml|mbstring|zlib|gd'
    Вариант 2Проверить существование и права config.php из каталога форума; команды ничего не создают.
    Linux · Терминал (Bash)Команда
    Проверить существование и права config.php из каталога форума; команды ничего не создают.
    ls -l config.php
    namei -l /полный/путь/phpbb/config.php
    # Уточните путь и владельца файлов по панели хостинга.
    # Не создавайте пустой config.php и не выставляйте права 666/777.
    Вариант 3Просмотр списка баз, без создания пользователей, выдачи избыточных прав и готовых паролей.
    SQLКоманда
    Просмотр списка баз, без создания пользователей, выдачи избыточных прав и готовых паролей.
    # Только диагностика существующей базы: откройте SQL-консоль в панели хостинга
    # и проверьте, какая база используется форумом.
    SHOW DATABASES;
    # Создавать пользователя и выдавать права следует через панель
    # или по отдельной проверенной процедуре только для НОВОГО форума.
    Вариант 4Проверить подключение с этими данными
    Linux · Терминал (Bash)Команда
    Проверить подключение с этими данными
    mysql -u phpbb_user -p -h localhost phpbb -e "SELECT 1"
    Вариант 5После установки: удалить каталог install и ужесточить права.
    Linux · Терминал (Bash)С осторожностью
    После установки: удалить каталог install и ужесточить права. Внимание: команда изменяет систему или файлы. Проверьте пути, права и возможность восстановления перед запуском.
    # После завершения штатной установки проверьте, требует ли ваша версия phpBB
    # удаления/переименования каталога install через панель или SFTP.
    # Сначала сохраните резервную копию, затем удалите только указанную папку.
    # Рекурсивное удаление и изменение прав всех каталогов скриптом не требуются.

    Команда может изменить состояние системы или её настройки. Проверьте параметры и последствия перед запуском.

#Что делать при обновлении

При обновлении существующего форума не удаляйте config.php. Загрузите новые файлы поверх, сохранив config.php, files/, images/ и store/, затем откройте install/app.php → «Обновить». Перед этим сделайте копию файлов и базы командой mysqldump phpbb > phpbb.sql.

Так эту ошибку тоже называют

Источники и обновления

Последнее обновление статьи: 2 ноября 2026. Версии программ и интерфейсы меняются — если шаги не совпадают с вашей версией, сверяйтесь с документацией производителя.