Как перенести блог WordPress с хостинга на локальный сервер

Как правильно переносить сайт? (TL;DR)

Надо использовать программные средства, специально предназначенные для этого. Упомянутые ниже программы корректно работают с сериализованными данными, пересчитывая длину строк.

Самым простым и автоматизированным решением лично мне представляется плагин Duplicator, который снимает копию локального сайта, предоставляет для скачивания 2 файла: .zip и installer.php, которые надо перенести на новый сервер и там запустить installer.php. Все остальное плагин проделает автоматически. В большинстве случаев имеет смысл переносить только базу с помощью этого плагина, а файлы копировать по FTP.

Скрипт Database Search and Replace поможет корректно внести изменения в базу. Для этого пользователь должен, правда, понимать, что он делает, знать, например, какие пути на старом сайте и какие — на новом.

Плагин WP Migrate DB позволяет корректно подготовить базу для миграции. Для завершения процесса пользователь должен использовать phpMyAdmin для импорта базы на новом сервере.

Интерфейс командной строки для WordPress (WP-CLI) позволяет конвертировать базу одной командой. Например, для конвертации http://site.ru в https://site.org:

wp search-replace --url=http://site.ru http://site.ru https://site.org --recurse-objects --report-changed-only --precise --skip-columns=guid --skip-tables=wp_users --skip-plugins --skip-themes

С мультисайтом ситуация несколько сложнее. Плагины Duplicator и All-in-One WP Migration переносят их только в платной версии.

Мне неизвестны бесплатные плагины для переноса мультисайтов. Если хочется сделать перенос мультисайта бесплатно, то можно скопировать базу, а потом воспользоваться Database Search and Replace.

Причины проблем при переносе

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

http://mysite.com/wp-content/uploads/2022/01/cropped-test-favicon.png

Для правильной работы сайта на новом домене (например, https://newsite.org) ссылка в базе должна измениться на

https://newsite.org/wp-content/uploads/2022/01/cropped-test-favicon.png

Обратите внимание на то, что даже при простом переводе сайта с http на https, все ссылки внутри базы надо менять!

За использованием абсолютных ссылок в WordPress лежат серьезные доводы. Почитайте этот ответ на английском StackOverflow, в котором даны объяснения. В том числе, приведено мнение одного из ведущих разработчиков WordPress. Единственная проблема, которая возникает при использовании абсолютных ссылок — перенос сайтов. Однако перенос сайта с относительными ссылками в общем случае ещё более проблематичен. В упомянутом ответе это тоже обсуждается.

Вторая причина проблем при переносе — сериализованные данные в базе. Все современные плагины (включая WooCommerce, слайдеры, различные визуальные редакторы типа Visual Composer), темы — хранят данные в базе в сериализованном виде. Это упакованные в строки массивы и объекты. Несколько примеров:

Информация о последнем отредактированном файле из темы twentyseventeen:

(39, 'recently_edited', 'a:3:{i:0;s:46:"/var/www/test/wp-content/themes/test/style.css";i:2;s:50:"/var/www/test/wp-content/themes/test/functions.php";i:3;s:0:"";}', 'no'),

Данные Jetpack

(5104, 'jpsq_sync-1494597052.351881-573008-5', 'a:6:{i:0;s:21:"jetpack_sync_constant";i:1;a:2:{i:0;s:7:"ABSPATH";i:1;s:14:"/var/www/test/";}i:2;i:1;i:3;d:1494597052.351856;i:4;b:0;i:5;a:9:{s:12:"display_name";s:4:"kagg";s:10:"user_email";s:12:"info@kagg.eu";s:2:"ip";s:14:"87.110.237.209";s:7:"is_cron";b:0;s:11:"is_wp_admin";b:1;s:7:"is_rest";b:0;s:9:"is_xmlrpc";b:0;s:10:"is_wp_rest";b:0;s:7:"is_ajax";b:0;}}', 'no'),

Данные популярного плагина бэкапа сайтов BackWPUp

(5884, 'backwpup_jobs', 'a:1:{i:1;a:32:{s:5:"jobid";i:1;s:10:"backuptype";s:7:"archive";s:4:"type";a:3:{i:0;s:6:"DBDUMP";i:1;s:4:"FILE";i:2;s:8:"WPPLUGIN";}s:12:"destinations";a:1:{i:0;s:6:"FOLDER";}s:4:"name";s:15:"Database backup";s:14:"mailaddresslog";s:12:"info@kagg.eu";s:20:"mailaddresssenderlog";s:28:"BackWPup test <info@kagg.eu>";s:13:"mailerroronly";b:1;s:13:"archiveformat";s:4:".zip";s:11:"archivename";s:24:"%Y-%m-%d_%H-%i-%s_%hash%";s:11:"fileexclude";s:51:".DS_Store,.git,.svn,.tmp,/node_modules/,desktop.ini";s:10:"dirinclude";s:0:"";s:19:"backupexcludethumbs";b:0;s:18:"backupspecialfiles";b:1;s:10:"backuproot";b:0;s:17:"backupabsfolderup";b:0;s:13:"backupcontent";b:0;s:13:"backupplugins";b:0;s:12:"backupthemes";b:0;s:13:"backupuploads";b:0;s:21:"backuprootexcludedirs";a:0:{}s:24:"backupcontentexcludedirs";a:1:{i:0;s:7:"upgrade";}s:24:"backuppluginsexcludedirs";a:1:{i:0;s:8:"backwpup";}s:23:"backupthemesexcludedirs";a:0:{}s:24:"backupuploadsexcludedirs";a:0:{}s:9:"backupdir";s:32:"uploads/backwpup-a34fdc-backups/";s:10:"maxbackups";i:7;s:18:"backupsyncnodelete";b:0;s:7:"lastrun";d:1510222228;s:7:"logfile";s:98:"/var/www/test/wp-content/uploads/backwpup-a34fdc-logs/backwpup_log_a34fdc_2022-11-09_10-10-28.html";s:21:"lastbackupdownloadurl";s:129:"http://test.kagg.eu/wp-admin/admin.php?page=backwpupbackups&action=downloadfolder&file=2022-11-09_10-10-28_SKRU7XDQ01.zip&jobid=1";s:11:"lastruntime";d:1;}}', 'no'),

во всех примерах можно найти путь к папке сайта на сервере: /var/www/test/.

Вот пример сохраненных настроек из очень популярного SEO-плагина Yoast

(291, 2, 'wp_yoast_notifications', 'a:3:{i:0;a:2:{s:7:"message";s:309:"The configuration wizard helps you to easily configure your site to have the optimal SEO settings.<br/>We have detected that you have not finished this wizard yet, so we recommend you to <a href="http://test.kagg.eu/wp-admin/?page=wpseo_configurator">start the configuration wizard to configure Yoast SEO</a>.";s:7:"options";a:8:{s:4:"type";s:7:"warning";s:2:"id";s:31:"wpseo-dismiss-onboarding-notice";s:5:"nonce";N;s:8:"priority";d:0.80000000000000004;s:9:"data_json";a:0:{}s:13:"dismissal_key";N;s:12:"capabilities";s:14:"manage_options";s:16:"capability_check";s:3:"all";}}i:1;a:2:{s:7:"message";s:768:"We've noticed you've been using Yoast SEO for some time now; we hope you love it! We'd be thrilled if you could <a href="https://yoa.st/rate-yoast-seo?utm_content=4.8">give us a 5 stars rating on WordPress.org</a>!nnIf you are experiencing issues, <a href="https://yoa.st/bugreport?utm_content=4.8">please file a bug report</a> and we'll do our best to help you out.nnBy the way, did you know we also have a <a href='https://yoa.st/premium-notification?utm_content=4.8'>Premium plugin</a>? It offers advanced features, like a redirect manager and support for multiple keywords. It also comes with 24/7 personal support.nn<a class="button" href="http://test.kagg.eu/wp-admin/?page=wpseo_dashboard&yoast_dismiss=upsell">Please don't show me this notification anymore</a>";s:7:"options";a:8:{s:4:"type";s:7:"warning";s:2:"id";s:19:"wpseo-upsell-notice";s:5:"nonce";N;s:8:"priority";d:0.80000000000000004;s:9:"data_json";a:0:{}s:13:"dismissal_key";N;s:12:"capabilities";s:14:"manage_options";s:16:"capability_check";s:3:"all";}}i:2;a:2:{s:7:"message";s:162:"Don't miss your crawl errors: <a href="http://test.kagg.eu/wp-admin/admin.php?page=wpseo_search_console&tab=settings">connect with Google Search Console here</a>.";s:7:"options";a:8:{s:4:"type";s:7:"warning";s:2:"id";s:17:"wpseo-dismiss-gsc";s:5:"nonce";N;s:8:"priority";d:0.5;s:9:"data_json";a:0:{}s:13:"dismissal_key";N;s:12:"capabilities";s:14:"manage_options";s:16:"capability_check";s:3:"all";}}}'),

Здесь мы видим в сериализованных данных строку с упоминанием домена: href="http://test.kagg.eu/wp-admin/?page=wpseo_configurator". Она мало того, что сериализована, да ещё и экранирована (").

Третья причина — наличие в базе путей к файлам. Они могут быть не только от корня WordPress, но и от домашнего каталога пользователя хостинг-аккаунта или даже от корня веб-сервера (некоторые плагины так делают). Пути могут быть представлены как обычными строками, так и сериализованными данными (первый пример выше). При переносе на другой хостинг их тоже надо менять.

Что произойдет, если просто перекинуть базу как есть на новый сервер? Очевидно, перестанут работать вещи, связанные с путями к файлам и ссылками, содержащими предыдущий домен.

Что надо делать? Очевидно, менять пути к файлам на новые и имя домена в базе. Вопрос, как. Совершенно непригодны три плохих совета, которые часто можно встретить:

1. Заменить в базе в таблице wp_options записи c option_name = siteurl и home на новое имя домена. Работает только на самых примитивных сайтах.

2. Сделать дамп базы в файл .sql, и провести текстовые замены путей и домена, затем залить базу на новый сервер. Это прямой путь к разрушению базы. Сериализованные данные при этом будут безнадежно испорчены.

3. Послать несколько SQL-запросов, которые произведут замену домена. То же самое, что и выше — это прямой путь к разрушению базы. Сериализованные данные будут безнадежно испорчены.

Рассмотрим первый пример выше с сериализованными данными. После текстовой замены /var/www/test/ на, скажем, /home/i/account-name/site-name.org/public_html (как на одном популярном хостинге), из строки

s:46:"/var/www/test/wp-content/themes/test/style.css"

получится строка

s:46:"/home/i/account-name/site-name.org/public_html/wp-content/themes/test/style.css"

Только ее длина уже ни разу не 46 символов, и WordPress не сможет прочитать эти сериализованные данные из базы.

Таким образом, все три «популярных» совета надо признать вредными.