LEMP环境WordPress子域迁移全攻略

理解WordPress站点迁移的挑战

将WordPress站点从一个域名或路径迁移到另一个，尤其是迁移到子域进行开发或测试，是一个常见的操作。对于小型站点，可能存在一些可视化迁移插件。然而，当站点规模庞大，或出于安全性、性能考虑，手动通过SSH进行迁移成为首选。

在手动迁移过程中，一个常见的误区是尝试通过文件系统级别的查找和替换工具（如sed）来更改所有文件中的旧域名或路径。这种方法对于WordPress站点来说是不适用且危险的，原因如下：

1. WordPress域名和路径存储在数据库中： WordPress的核心配置，包括站点URL（WP_SITEURL）和主页URL（WP_HOME），以及文章内容、图片链接、插件设置等，大部分都存储在MySQL/MariaDB数据库中。WordPress在运行时通过数据库查询获取这些信息，而不是硬编码在模板文件中。
2. 序列化数据问题： WordPress数据库中包含大量的序列化数据（Serialized Data），这些数据通常用于存储复杂的数组或对象（例如，插件设置、小工具配置）。序列化数据中包含了字符串的长度信息。如果直接使用sed等工具替换字符串，而不更新其对应的长度信息，会导致数据损坏，使得WordPress无法正确解析这些数据，进而引发站点功能异常。

因此，正确的迁移方法必须着重于数据库内容的精确替换，并辅以必要的配置文件修改。

WP-CLI：WordPress站点迁移的利器

WP-CLI是WordPress的命令行接口，它允许用户通过命令行管理WordPress站点，无需通过浏览器界面。WP-CLI提供了强大的search-replace命令，能够安全地处理WordPress数据库中的序列化数据，这是手动迁移大型站点的核心工具。

WP-CLI的安装（简要提及）： 通常，可以通过以下命令下载并安装WP-CLI：

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp

安装完成后，您可以通过运行wp --info来验证安装是否成功。

分步迁移指南

本指南假设您已完成了子域的创建、MariaDB数据库的克隆、DNS和Nginx的配置，并且已在子域上安装了全新的WordPress实例。

步骤1：环境准备与文件复制

在开始数据库操作之前，请务必进行以下准备：

1. 完整备份： 在进行任何迁移操作之前，务必对源站点（文件和数据库）进行完整备份。这是防止意外发生的最重要步骤。

2. 文件复制： 通过SSH，将主站点的所有WordPress文件（除了wp-config.php文件，因为它包含旧的数据库凭证和配置）复制到子域对应的Web根目录。例如：

   # 假设主站点在 /var/www/html/mainsite
   # 假设子域在 /var/www/html/dev.mainsite
   rsync -avz --exclude 'wp-config.php' /var/www/html/mainsite/ /var/www/html/dev.mainsite/

   请确保新目录的文件权限设置正确，以便Web服务器可以读取和写入。

步骤2：修改wp-config.php文件

将子域目录下的wp-config.php文件配置为指向克隆后的数据库，并更新站点URL和主页URL。虽然WP-CLI会处理数据库中的URL，但显式定义这些常量可以确保WordPress在启动时使用正确的URL，尤其是在首次访问或调试时。

打开子域目录下的wp-config.php文件，找到或添加以下两行（通常放在文件顶部，ABSPATH定义之前）：

define('WP_SITEURL', 'http://dev.yourwebsite.com'); // 将 'dev.yourwebsite.com' 替换为你的子域
define('WP_HOME', 'http://dev.yourwebsite.com');    // 将 'dev.yourwebsite.com' 替换为你的子域

注意： 这里的URL应该与你的子域配置（包括HTTP/HTTPS）完全匹配。

步骤3：使用WP-CLI进行数据库替换

这是迁移的核心步骤。通过WP-CLI的search-replace命令，我们可以安全地将数据库中所有旧的URL和路径替换为新的。

进入子域WordPress安装的根目录，并执行以下命令：

1. 替换完整URL（带协议）： 首先替换包含协议的完整URL。这有助于处理所有精确匹配的链接。

   wp search-replace 'http://old.website.com' 'http://dev.website.com' --all-tables --precise --dry-run

   解释：

   • 'http://old.website.com'：你的旧站点URL。
   • 'http://dev.website.com'：你的新子域URL。
   • --all-tables：表示在WordPress数据库的所有表中执行替换操作。
   • --precise：确保替换操作对序列化数据是安全的，它会同时更新字符串的长度信息。
   • --dry-run：强烈建议先使用此选项。它会显示将要进行的更改，但不会实际执行它们。检查输出以确保替换操作符合预期。

   在确认--dry-run的输出无误后，移除--dry-run并执行实际替换：

   wp search-replace 'http://old.website.com' 'http://dev.website.com' --all-tables --precise

2. 替换不带协议的域名： 接着，替换不带协议的旧域名。这可以捕获到一些可能没有协议前缀的引用。

   wp search-replace 'old.website.com' 'dev.website.com' --all-tables --precise --dry-run

   同样，确认无误后，执行实际替换：

   wp search-replace 'old.website.com' 'dev.website.com' --all-tables --precise

关于文件路径替换的说明： WordPress通常不将文件系统路径硬编码在数据库中，而是使用相对路径或通过PHP常量（如ABSPATH）动态生成。因此，在大多数情况下，你不需要在数据库中或通过sed命令在文件中替换文件系统路径（例如/var/www/html/mainsite到/var/www/html/dev.mainsite）。如果你的站点存在自定义的硬编码文件路径，这可能是个例外，但对于标准的WordPress安装，URL替换足以。

重要注意事项

• 备份是第一要务： 再次强调，在执行任何数据库操作前，请务必进行完整的数据库和文件备份。
• 清理缓存： 迁移完成后，如果使用了任何缓存插件（如WP Super Cache, W3 Total Cache, LiteSpeed Cache等）或服务器端缓存（如Nginx FastCGI Cache），请务必清除所有缓存，以确保新URL生效。
• 测试： 登录到新的子域WordPress后台，检查所有设置、页面、文章、图片链接和插件功能是否正常。尤其要检查媒体库中的图片链接是否正确指向了新域名。
• SSL/HTTPS： 如果原站点使用HTTPS，并且子域也计划使用HTTPS，请确保Nginx配置正确，并且在wp-config.php和WP-CLI替换时使用https://前缀。
• Nginx/Web服务器配置： 确保子域的Nginx或Apache配置正确指向了新的WordPress文件目录，并且启用了URL重写（Permalinks）。

总结

通过遵循上述步骤并利用WP-CLI的强大功能，您可以安全、高效地将大型LEMP环境下的WordPress站点迁移到子域进行开发或测试。WP-CLI的search-replace命令是处理WordPress序列化数据的关键，它避免了手动替换可能导致的数据损坏问题。记住，细致的准备、备份和测试是确保迁移成功的基石。