wp db: выгрузить и загрузить базу WordPress
Перед обновлением WordPress, заменой адреса или переносом сайта базу выгружают в файл: если что-то пойдёт не так, её можно вернуть одной командой. WP-CLI делает это сам — имя базы и пароль он берёт из wp-config.php, вводить их не нужно. Здесь — как выгрузить и загрузить базу и где хранить файл.
Содержание 9
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Перейдите в папку сайта:
cd /var/www/example.com. Вместо/var/www/example.com— папка вашего сайта. - Выгрузите базу в файл в своей домашней папке:
sudo -u www-data wp db export - > ~/site.sqlОтвета нет — так и должно быть:
-значит «вывести дамп в терминал», а> ~/site.sqlзаписывает его в файл. - Проверьте размер файла:
ls -lh ~/site.sqlРазмер больше нуля — дамп записан.
Почему команды запускают через sudo -u www-data — WP-CLI от пользователя сайта.
Почему не в папку сайта
С именем файла WP-CLI запишет дамп в папку, где вы стоите:
sudo -u www-data wp db export site.sqlSuccess: 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.sqlSuccess: 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 | чинит повреждённые таблицы MyISAM | Success: 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 connection | WordPress не может подключиться к базе | разбор |
| файл дампа пустой | команда оборвалась | прочитайте строку Error: в терминале и запустите выгрузку снова |
Команды и ответы сверены с документацией и исходным кодом WP-CLI 2.12.0; WordPress в примерах — 7.1.4.
Источники
- Документация WP-CLI: wp db — на английском: export, import, check, optimize, repair, query и prefix.
Сверено 10 ноября 2026 года.
Что почитать дальше
- mysqldumpкак выгрузить базу без WP-CLI.
- Резервные копии сайтакак хранить копии базы и файлов.
- Команды WP-CLIвсе команды на одной странице.