WordPress · 8 мин чтения

WordPress install.php вместо сайта: почему так происходит и как вернуть сайт

Ситуация «wordpress install.php вместо сайта» выглядит так: открываешь домен и вместо главной видишь выбор языка и форму «Добро пожаловать», либо адрес сам превращается в /wp-admin/install.php. Первая реакция у всех одинаковая: сайт пропал. На практике в большинстве случаев файлы и данные на месте, а ядро не находит в базе то, что считает признаком установленного сайта. Ниже порядок, в котором я это разбираю, и список причин от самых частых до самых неприятных.

Почему WordPress запускает установщик вместо сайта

При каждом запросе ядро проверяет, установлен ли сайт: смотрит в базу данных, есть ли там таблицы и запись об адресе сайта (опция siteurl). Если проверка не проходит, WordPress решает, что перед ним чистая установка, и отправляет посетителя на install.php. Сам по себе установщик ничего не ломает, он лишь сообщает, что по текущим настройкам подключения нужных данных нет.

Отсюда следует главный вывод: надо выяснить, куда именно смотрит wp-config.php и что лежит в этой базе. Чаще всего причина одна из четырёх:

  • в wp-config.php указан другой префикс таблиц, чем в базе;
  • конфиг подключён к пустой или чужой базе (например, к копии для теста);
  • дамп при переносе импортировался не полностью;
  • базу очистили: из-за взлома, неудачного обновления или действия хостинга.

Отдельно отличаю три похожих экрана, потому что лечатся они по-разному:

Что видите Что это значит
Форма «Добро пожаловать» на install.php Подключение к базе работает, но ядро не нашло в ней установленный сайт
Форма с полями имени базы, пользователя и пароля на setup-config.php Файла wp-config.php нет или он не читается
«Error establishing a database connection» Неверные параметры подключения или сервер MySQL недоступен

Если у вас второй или третий случай, эта статья только частично подходит: там проблема в доступе к базе, а не в её содержимом.

Диагностика: что проверить в первую очередь

Первое правило: не заполняйте форму установщика на боевом сайте. Если вы введёте название и пароль, ядро создаст новые таблицы под текущим префиксом. Старые таблицы с другим префиксом, насколько я с этим сталкивался, остаются нетронутыми, но диагностика запутывается, а вместо сайта вы получаете пустой блог с одной записью «Привет, мир!». Сначала разбираемся, потом ставим что-либо.

Порядок проверки у меня такой:

  1. Делаю копию файла wp-config.php и, если есть доступ, выгрузку базы. Даже испорченная база может понадобиться.
  2. Открываю wp-config.php и выписываю DB_NAME, DB_USER, DB_HOST и строку $table_prefix.
  3. Захожу в phpMyAdmin на хостинге и открываю именно ту базу, что указана в DB_NAME.
  4. Смотрю, есть ли там таблицы и с каким префиксом они начинаются.
  5. Если таблицы есть, открываю таблицу options и ищу строки siteurl и home.

То же самое быстро делается через WP-CLI, если он есть на хостинге (на большинстве обычных тарифов доступен по SSH):

wp config get table_prefix
wp db query "SHOW TABLES"
wp core is-installed && echo "установлен" || echo "не установлен"

Первая команда показывает префикс из конфига, вторая выводит все таблицы базы, третья повторяет ту проверку, которую делает само ядро. Сравнение первых двух результатов обычно сразу даёт ответ.

Бесплатный материал

🎁 Полезный скрипт в подарок

Подпишитесь на Telegram - пришлю готовый скрипт по этой теме.

Без спама. Отписка в 1 клик.

Префикс таблиц не совпадает с wp-config.php

Это самая частая причина, которую я встречал после переездов. Типичная история: сайт жил на старом хостинге с префиксом wp_, при переносе его сменили на что-то вроде wpx7_ ради безопасности (так советуют некоторые плагины) или наоборот, при импорте дампа взяли конфиг от соседнего сайта. В базе таблицы называются wpx7_posts, wpx7_options, а в конфиге стоит $table_prefix = 'wp_';. Ядро ищет wp_options, не находит и запускает установщик.

Признак в phpMyAdmin: таблицы в базе есть, их много, а префикс не тот, что в конфиге. Лечится одной строкой:

$table_prefix = 'wpx7_';

Префикс нужно скопировать из phpMyAdmin буква в букву, с учётом регистра и подчёркивания в конце. После правки обновляю страницу: если сайт вернулся, то всё. Но есть второй слой, о котором забывают. В таблице options есть запись wpx7_user_roles, а в таблице usermeta ключи wpx7_capabilities и wpx7_user_level, в которых префикс тоже зашит. Если вы не меняли префикс в базе, а просто подправили конфиг под существующие таблицы, всё согласовано. А вот если вы переименовывали таблицы руками, эти значения тоже нужно обновить, иначе после входа в админку пользователь окажется без прав.

На WooCommerce-магазинах эта проблема неприятнее: заказы лежат в тех же таблицах с тем же префиксом, и пока конфиг смотрит не туда, магазин выглядит пустым. Один раз при переносе магазина с приёмом оплаты через T‑Bank именно так и вышло: сайт «обнулился», хотя все заказы были в базе, а запись о префиксе просто потерялась при копировании конфига.

Пустая или недогруженная база после переноса

Если таблиц в нужной базе нет вообще, возможны два сценария. Первый: DB_NAME указывает на новую пустую базу, а данные остались в старой. Такое бывает, когда хостинг создаёт базу с похожим именем, и в конфиг попадает не то. Проверьте в панели хостинга список баз и посмотрите, в какой из них лежат таблицы вашего сайта. Если нашли, правите DB_NAME (и при необходимости DB_USER с паролем) в конфиге.

Второй сценарий коварнее: таблицы есть, но не все. Дамп загружался через веб-интерфейс phpMyAdmin, упёрся в лимит размера или времени выполнения, и импорт оборвался на середине. Таблица options в алфавитном порядке дампа идёт позже многих других, поэтому часть таблиц создана, а до записи siteurl импорт не дошёл. Ядро видит неполную картину и уходит в установщик.

Как это проверить:

  • открыть файл дампа в текстовом редакторе и посмотреть последние строки: у выгрузки mysqldump в конце стоит комментарий «Dump completed on» с датой, если его нет, файл обрезан;
  • сравнить количество таблиц в базе с количеством блоков CREATE TABLE в дампе;
  • посмотреть, сколько строк в таблице posts, и сопоставить с оригиналом.

Если дамп большой, я не загружаю его через браузер. По SSH импорт делается так:

mysql -u USER -p DBNAME < dump.sql

Здесь USER и DBNAME заменяются на ваши значения, пароль команда спросит сама. Если SSH на тарифе нет, дамп можно разрезать на части или воспользоваться скриптами импорта по частям вроде BigDump. Перед повторным импортом базу лучше очистить, иначе получите ошибки «table already exists».

Базу очистили: взлом, обновление или действие хостинга

Третья группа причин самая неприятная, потому что данных в базе действительно может не быть. Что я проверяю в таком случае:

  • дату изменения таблиц в phpMyAdmin и размер базы, если он резко упал, данные удалены;
  • наличие в корне сайта чужих файлов, недавно изменённых index.php, wp-config.php, незнакомых PHP-файлов в wp-content/uploads;
  • историю действий в панели хостинга: не восстанавливали ли бэкап, не менялся ли тариф или версия PHP;
  • логи ошибок, там часто видно момент, когда запросы к таблицам начали падать.

Если файлов после взлома много и они подозрительные, то восстановление базы из бэкапа без чистки файлов бессмысленно: сайт заразится снова. Для таких случаев у меня отдельная работа: лечение от вирусов и восстановление после заражения от 15 000 ₽. А чтобы подобное не повторялось, на сайтах клиентов я держу регулярные бэкапы базы и файлов за пределами самого хостинга сайта, и это входит в техподдержку сайта.

Отдельный случай: таблицы есть, но повреждены (после сбоя сервера MySQL или нехватки места на диске). Тогда ядро получает ошибки чтения и ведёт себя непредсказуемо. Штатный инструмент WordPress для этого описан в документации по wp-config.php. Добавьте в конфиг строку:

define( 'WP_ALLOW_REPAIR', true );

После этого откройте /wp-admin/maint/repair.php и запустите восстановление таблиц. Страница доступна без входа в админку, поэтому сразу после ремонта удалите эту строку из конфига.

Как вернуть сайт: порядок действий

Собираю всё вместе в одну последовательность, которой я пользуюсь на практике:

Что нашли Что делаем Риск
Таблицы есть, префикс отличается от конфига Правим $table_prefix в wp-config.php Минимальный, меняется одна строка
Таблицы есть в другой базе Правим DB_NAME, DB_USER, DB_PASSWORD Минимальный
Таблицы повреждены Запускаем repair.php через WP_ALLOW_REPAIR Средний, сначала бэкап
Дамп импортирован частично Очищаем базу и импортируем заново через SSH или по частям Средний, нужен целый дамп
База пуста, бэкапа нет Ищем бэкап на хостинге, в панели, у регистратора, на старом сервере Высокий, данные могут быть потеряны

После того как сайт открылся, проверяю по порядку:

  1. главную и несколько внутренних страниц, особенно ссылки на записи: если они дают 404, достаточно зайти в «Настройки», «Постоянные ссылки» и просто сохранить настройки;
  2. вход в админку и список пользователей с их ролями;
  3. значения siteurl и home в таблице options: если сайт переехал на другой домен, там должен стоять новый адрес, иначе страницы будут редиректить на старый;
  4. для магазина на WooCommerce список заказов и тестовую оплату;
  5. отправку писем с форм и уведомления о заказах.

Если доступ в админку потерян, потому что в базе не осталось пользователя, WP-CLI выручает и здесь: wp user list покажет учётные записи, а wp user update ID --user_pass=НОВЫЙ_ПАРОЛЬ сменит пароль.

После восстановления настройте регулярный экспорт базы. На обычном хостинге хватает штатного планировщика заданий панели, который раз в сутки запускает mysqldump и складывает архив в отдельное место. Отдельный сервер для этого не нужен.

Условия и возможности WordPress и WP-CLI меняются, поэтому перед работой с боевым сайтом я сверяюсь с актуальной документацией.

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

Пропадут ли мои записи и заказы, если я пройду установку на install.php?

Не обязательно, но рисковать не стоит. Установщик создаёт таблицы под текущим префиксом и не удаляет таблицы с другим. Если ваши данные лежат под другим префиксом, они останутся, но вы получите пустой сайт рядом с ними и лишнюю путаницу. Если же в базе есть частично созданные таблицы с тем же префиксом, результат непредсказуем. Сначала сделайте копию базы и файлов, потом разбирайтесь, откуда подключается конфиг.

Чем отличаются install.php и setup-config.php?

Установщик install.php появляется, когда подключение к базе работает, но сайта в ней не нашлось. Страница setup-config.php с полями имени базы и пароля появляется, когда wp-config.php отсутствует. В первом случае проверяйте префикс и содержимое базы, во втором ищите потерянный конфиг или заново укажите параметры подключения.

Могла ли причиной стать неправильная настройка кэш-плагина или .htaccess?

Это маловероятно. Установщик запускает само ядро, когда не находит данные в базе, а правила .htaccess и кэш влияют на маршрутизацию и отдачу страниц. Если после возврата префикса и подключения сайт всё равно открывает установщик, лучше смотреть в сторону базы, а не кэша. Но после восстановления кэш всё равно стоит очистить, чтобы посетители не видели старую версию страницы.

Что делать, если бэкапа нет, а база пуста?

Сначала проверьте все источники: резервные копии в панели хостинга (многие провайдеры хранят их без отдельного запроса), копии у регистратора или разработчика, старый хостинг, если сайт переезжал. Файлы тем, плагинов и загрузок в wp-content обычно остаются, поэтому внешний вид и медиафайлы восстановимы. Записи и настройки без базы придётся восстанавливать из того, что осталось: кэша поисковиков, веб-архива, RSS-ленты.

Есть задача?

Обсудим в мессенджере

Расскажите, что нужно сделать — отвечу в течение 4 часов в рабочее время. Первая консультация бесплатно.

Продолжая пользование настоящим сайтом Вы выражаете своё согласие на обработку Ваших персональных данных (файлов куки) с использованием Yandex.Metrika.
Понятно