wp search-replace: заменить старый адрес сайта в базе WordPress
После переноса сайта на новый домен или перехода на https в базе WordPress остаются старые адреса: в записях, картинках, меню, настройках плагинов. Из-за них сайт ведёт на старый адрес или браузер ругается на смешанное содержимое. Команда wp search-replace заменяет адрес во всей базе одной командой. Здесь — как сделать это безопасно.
Содержание 9
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Перейдите в папку сайта:
cd /var/www/example.com. Вместо/var/www/example.com— папка вашего сайта. - Выгрузите базу — замену нельзя отменить:
sudo -u www-data wp db export - > ~/site.sqlОтвета нет — дамп в файле
~/site.sql(wp db). - Посмотрите, сколько будет замен, ничего не меняя:
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. - Если число похоже на правду, запустите ту же команду без
--dry-run:sudo -u www-data wp search-replace 'http://old.example.com' 'https://example.com' --skip-columns=guidSuccess: Made 57 replacements. - Сбросьте кэш и проверьте адрес сайта — ниже.
Почему команды запускают через 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 на https | wp search-replace 'http://example.com' 'https://example.com' --skip-columns=guid |
| сайт с www на сайт без www | wp 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.
После замены
- Сбросьте кэш:
sudo -u www-data wp cache flushОтвет:
Success: The cache was flushed.Если к сайту подключён объектный кэш в Redis или Memcached, WP-CLI после замены сам напомнит об этой команде. Кэш плагинов страниц сбрасывайте в их настройках (кэш, ссылки и cron). - Проверьте адрес сайта:
sudo -u www-data wp option get home sudo -u www-data wp option get siteurlОбе команды должны вывести новый адрес. Если адрес старый, проверьте, не задан ли он в wp-config.php константами
WP_HOMEиWP_SITEURL(разбор). - Откройте сайт в браузере, проверьте ссылки, картинки и вход в админку.
Весь перенос по шагам — перенос сайта на другой хостинг.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
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.
Источники
- Документация WP-CLI: wp search-replace — на английском: ключи --dry-run, --skip-columns и --export, таблица ответа.
Сверено 10 ноября 2026 года.
Что почитать дальше
- wp optionкак посмотреть и сменить адрес сайта в настройках.
- Перенос сайта на другой хостингвесь перенос по шагам.
- Команды WP-CLIвсе команды на одной странице.