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

wp search-replace: заменить старый адрес сайта в базе WordPress

После переноса сайта на новый домен или перехода на https в базе WordPress остаются старые адреса: в записях, картинках, меню, настройках плагинов. Из-за них сайт ведёт на старый адрес или браузер ругается на смешанное содержимое. Команда wp search-replace заменяет адрес во всей базе одной командой. Здесь — как сделать это безопасно.

≈ 5 мин чтения
Содержание 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 (wp db).

  4. Посмотрите, сколько будет замен, ничего не меняя:
    sudo -u www-data wp search-replace 'http://old.example.com' 'https://example.com' --skip-columns=guid --dry-run

    Вместо http://old.example.com — старый адрес, вместо https://example.com — новый. Ответ — таблица и строка вида:

    Success: 57 replacements to be made.
  5. Если число похоже на правду, запустите ту же команду без --dry-run:
    sudo -u www-data wp search-replace 'http://old.example.com' 'https://example.com' --skip-columns=guid
    Success: Made 57 replacements.
  6. Сбросьте кэш и проверьте адрес сайта — ниже.

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

Как читать таблицу

Перед строкой Success: WP-CLI выводит таблицу:

СтолбецЧто значит
Tableтаблица базы, например wp_posts или wp_options
Columnстолбец этой таблицы
Replacementsсколько замен в нём сделано или будет сделано
Typeкак WP-CLI заменял: SQL — прямо в базе, PHP — с разбором сохранённых настроек

Если в строке Success: ноль замен, старый адрес в базе не найден: проверьте, как он записан, — с http или https, с www или без.

Как писать адреса

Что меняетеКоманда
домен при переносеwp search-replace 'https://old.example.com' 'https://example.com' --skip-columns=guid
http на httpswp search-replace 'http://example.com' 'https://example.com' --skip-columns=guid
сайт с www на сайт без wwwwp search-replace 'https://www.example.com' 'https://example.com' --skip-columns=guid

Пишите адрес целиком, с http:// или https://, и без / в конце. Короткая строка вроде old заменится везде, где встретится, — и в словах текста.

Адреса берите в одинарные кавычки '…': так терминал не поменяет в них ни одного знака.

Зачем --skip-columns=guid

В столбце guid таблицы wp_posts WordPress хранит неизменный номер каждой записи в виде адреса. По нему программы для чтения RSS отличают новые записи от старых. Если его поменять, такие программы могут показать старые записи как новые. Ключ --skip-columns=guid оставляет этот столбец как есть.

Настройки плагинов

Плагины и виджеты хранят настройки в базе в особом виде: в записи указана длина каждой строки. Если заменить адрес простой заменой в файле дампа, длина не совпадёт, и плагин потеряет настройки. wp search-replace разбирает такие настройки, меняет адрес и пересчитывает длину — в таблице это строки с PHP в столбце Type.

После замены

  1. Сбросьте кэш:
    sudo -u www-data wp cache flush

    Ответ: Success: The cache was flushed. Если к сайту подключён объектный кэш в Redis или Memcached, WP-CLI после замены сам напомнит об этой команде. Кэш плагинов страниц сбрасывайте в их настройках (кэш, ссылки и cron).

  2. Проверьте адрес сайта:
    sudo -u www-data wp option get home
    sudo -u www-data wp option get siteurl

    Обе команды должны вывести новый адрес. Если адрес старый, проверьте, не задан ли он в wp-config.php константами WP_HOME и WP_SITEURL (разбор).

  3. Откройте сайт в браузере, проверьте ссылки, картинки и вход в админку.

Весь перенос по шагам — перенос сайта на другой хостинг.

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

Что видитеПричинаЧто делать
Success: 0 replacements to be made.старый адрес в базе записан иначепроверьте http или https и www: wp option get home на старой копии базы
Warning: Replacement value '…' is identical to search value '…'. Skipping operation.старый и новый адрес одинаковыепроверьте, что написали в команде
Error: You cannot supply --dry-run and --export at the same time.заданы два несовместимых ключауберите --export: он пишет результат в файл вместо базы
после замены сайт ведёт на старый адресадрес задан в wp-config.php или остался в кэшеwp config get WP_HOME (wp config), wp cache flush
замена испортила сайтзаменили слишком короткую строкуверните базу из дампа: sudo -u www-data wp db import - < ~/site.sql (wp db)

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

Источники

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

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

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