Поиск
Справочник

wp db: выгрузить и загрузить базу WordPress

Перед обновлением WordPress, заменой адреса или переносом сайта базу выгружают в файл: если что-то пойдёт не так, её можно вернуть одной командой. WP-CLI делает это сам — имя базы и пароль он берёт из wp-config.php, вводить их не нужно. Здесь — как выгрузить и загрузить базу и где хранить файл.

≈ 4 мин чтения
Содержание 9

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Перейдите в папку сайта: cd /var/www/example.com. Вместо /var/www/example.com — папка вашего сайта.
  3. Выгрузите базу в файл в своей домашней папке:
    sudo -u www-data wp db export - > ~/site.sql

    Ответа нет — так и должно быть: - значит «вывести дамп в терминал», а > ~/site.sql записывает его в файл.

  4. Проверьте размер файла:
    ls -lh ~/site.sql

    Размер больше нуля — дамп записан.

Почему команды запускают через sudo -u www-data — WP-CLI от пользователя сайта.

Почему не в папку сайта

С именем файла WP-CLI запишет дамп в папку, где вы стоите:

sudo -u www-data wp db export site.sql
Success: Exported to 'site.sql'.

Если вы стоите в папке сайта, файл site.sql окажется в ней — и его можно скачать по адресу https://example.com/site.sql. В дампе — вся база: пользователи, почты, хэши паролей. Без имени файла WP-CLI тоже положит дамп в текущую папку, назвав его именем базы.

Не оставляйте дамп в папке сайта. Если он уже там, перенесите: sudo mv /var/www/example.com/site.sql ~/.

Команда с - из шага 3 этого не допускает: файл записывает ваш терминал, а не www-data, и он ложится в вашу домашнюю папку.

Сжатая копия

Дамп — текст, он хорошо сжимается:

sudo -u www-data wp db export - | gzip > ~/site.sql.gz

Ответа нет — сжатый дамп в ~/site.sql.gz. Скачать файл на компьютер — резервные копии сайта.

Загрузить базу из файла

Загрузка заменяет таблицы базы таблицами из файла. Всё, что изменилось на сайте после выгрузки, — новые заказы, комментарии, записи — пропадёт.
sudo -u www-data wp db import - < ~/site.sql
Success: Imported from 'STDIN'.

STDIN значит, что дамп пришёл через < из вашего терминала. Сжатый дамп:

gunzip < ~/site.sql.gz | sudo -u www-data wp db import -

После загрузки сбросьте кэш: sudo -u www-data wp cache flush (кэш, ссылки и cron).

Проверить и починить таблицы

КомандаЧто делаетОтвет в конце
wp db checkпроверяет таблицыSuccess: Database checked.
wp db optimizeсжимает таблицы после удаления большого числа записейSuccess: Database optimized.
wp db repairчинит повреждённые таблицы MyISAMSuccess: Database repaired.

Перед строкой Success: — список таблиц и итог проверки каждой. Перед wp db repair выгрузите базу. Таблицы InnoDB MySQL так не чинит: у них в списке будет The storage engine for the table doesn't support repair — что делать, разобрано в WP_ALLOW_REPAIR.

Запрос к базе

Посмотреть данные:

sudo -u www-data wp db query "SELECT option_value FROM wp_options WHERE option_name='home'"

WP-CLI выведет ответ базы — адрес сайта. Вместо wp_ — префикс таблиц вашего сайта: его покажет wp db prefix.

На запросы, которые меняют данные, — UPDATE, DELETE, INSERT, — ответ Success: Query succeeded. Rows affected: и число изменённых строк. Перед такими запросами выгрузите базу. Адрес сайта удобнее менять командой wp search-replace, а настройки — wp option.

Ошибки и как их исправить

Что видитеПричинаЧто делать
Error: Import file missing or not readable: site.sqlфайла нет в этой папке или www-data не может его прочитатьwp db import - < ~/site.sql с - и <
Error: Query failed: и текст ошибки MySQLошибка в запросе или нет доступатекст после двоеточия — от MySQL
Access denied for userневерный логин или пароль базы в wp-config.phpразбор, ошибка 1045
сайт пишет Error establishing a database connectionWordPress не может подключиться к базеразбор
файл дампа пустойкоманда оборваласьпрочитайте строку Error: в терминале и запустите выгрузку снова

Команды и ответы сверены с документацией и исходным кодом WP-CLI 2.12.0; WordPress в примерах — 7.1.4.

Источники

Сверено 10 ноября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше