大型WordPress站点手动迁移至子域名：WP-CLI核心实践指南

本教程详细阐述了如何手动将大型WordPress站点迁移至子域名进行测试或开发，尤其适用于传统迁移工具受限的场景。核心策略是避免直接修改文件中的域名信息，而是通过编辑wp-config.php文件并利用WordPress命令行工具（WP-CLI）的search-replace功能，安全、高效地更新数据库中所有URL和路径，包括序列化数据，从而确保站点在迁移后的正常运行。

在处理大型wordpress站点迁移时，传统的图形界面迁移插件可能因数据量过大而失效，此时手动迁移，尤其是通过ssh命令行操作，成为高效且可靠的替代方案。本教程将指导您如何将一个基于lemp（linux, nginx, mariadb, php）环境的wordpress主站迁移至一个子域名进行开发或测试，重点在于正确处理wordpress站点url和文件路径的更新，避免常见的错误。

迁移前准备

在开始数据库和文件操作之前，请确保已完成以下基础设置：

• 子域名创建： 您的Web服务器（如Nginx）已配置好新的子域名，并指向新的WordPress安装目录。
• 数据库克隆： 主站点的MariaDB数据库已完整克隆到新的数据库实例，并为子域名WordPress配置了相应的数据库用户和权限。
• DNS配置： 子域名的DNS记录已正确解析到您的服务器IP。
• WordPress安装： 在子域名目录下，已经全新安装了一个WordPress实例，并且可以正常访问（尽管内容是空的）。

核心原理：为什么不直接修改文件？

许多初学者在迁移时会尝试通过sed等工具直接在WordPress文件（如主题模板、插件文件）中查找并替换旧域名。然而，这种做法是错误的且危险的。WordPress通过其内部函数动态生成URL，并将大部分站点配置（包括URL和文件路径）存储在数据库中。更重要的是，WordPress会存储序列化的数据（例如小工具设置、插件配置），这些数据包含长度信息。直接的文件替换会破坏这些序列化数据的完整性，导致站点功能异常甚至崩溃。

正确的做法是：主要修改数据库。

步骤一：更新 wp-config.php 文件

在新的子域名WordPress安装目录下，编辑wp-config.php文件，强制WordPress使用新的站点URL和主页URL。这可以在您登录到后台之前，确保WordPress知道其新的地址。

// 在 wp-config.php 文件中，通常在文件顶部或任何 define() 语句之后添加 define('WP_SITEURL', 'http://dev.yourwebsite.com'); // 将 'dev.yourwebsite.com' 替换为您的子域名 define('WP_HOME', 'http://dev.yourwebsite.com');   // 将 'dev.yourwebsite.com' 替换为您的子域名

请确保将http://dev.yourwebsite.com替换为您的实际子域名URL。如果您的站点使用HTTPS，请使用https://。

步骤二：复制站点文件

通过SSH连接到您的服务器，将主站点的WordPress文件复制到子域名对应的目录。请注意，不要复制wp-config.php文件，因为子域名站点有其独立的数据库配置。

假设主站点目录为/var/www/html/mainsite，子域名目录为/var/www/html/dev.mainsite。

# 进入主站点WordPress安装目录的父目录 cd /var/www/html/mainsite/..  # 复制所有文件和文件夹，排除 wp-config.php # rsync 是一个更健壮的复制工具，可以处理大文件和保持权限 rsync -av --exclude 'wp-config.php' mainsite/ dev.mainsite/

完成文件复制后，请检查dev.mainsite目录下的文件权限是否正确，确保Web服务器用户（如www-data或nginx）拥有读写权限。

步骤三：使用 WP-CLI 更新数据库

这是迁移过程中最关键的一步，它确保数据库中所有旧的URL和文件路径都被正确替换为新的，并且能够正确处理序列化数据。WP-CLI是WordPress的命令行工具，提供了强大的search-replace功能。

3.1 安装 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

安装完成后，您可以在WordPress安装目录下直接使用wp命令。

3.2 执行数据库查找和替换

进入子域名WordPress的根目录，然后执行wp search-replace命令。为了确保数据的完整性，尤其是对于序列化数据，请遵循以下原则：

• 先替换长字符串，后替换短字符串： 例如，先替换完整的URL（http://old.com），再替换裸域名（old.com）。这可以避免在替换裸域名时意外修改到完整URL中的部分。
• 使用 –all-tables： 确保替换操作覆盖所有WordPress数据库表。
• 使用 –precise： 这个选项对序列化数据尤其重要，它能确保只替换精确匹配的字符串，而不会破坏序列化数据的长度信息。

假设您的旧域名是old.com，新域名是dev.yourwebsite.com。

# 进入子域名WordPress的根目录 cd /var/www/html/dev.mainsite  # 第一步：替换完整的旧URL为新URL wp search-replace 'http://old.com' 'http://dev.yourwebsite.com' --all-tables --precise  # 第二步：替换旧域名的裸字符串为新域名的裸字符串（如果旧域名在某些地方没有带协议） wp search-replace 'old.com' 'dev.yourwebsite.com' --all-tables --precise  # （可选）如果您的WordPress站点内部还存储了绝对文件路径，也需要进行替换 # 例如：/var/www/html/mainsite 替换为 /var/www/html/dev.mainsite wp search-replace '/var/www/html/mainsite' '/var/www/html/dev.mainsite' --all-tables --precise

注意事项：

• 备份： 在执行任何search-replace操作之前，务必对数据库进行完整备份。
• 协议一致性： 确保替换时协议（http://或https://）与您的实际站点配置一致。
• 测试： 完成替换后，立即尝试登录新的子域名WordPress后台，并访问前台页面，检查所有链接、图片、CSS/JS文件是否正常加载。

总结

通过遵循上述步骤，您可以使用WP-CLI安全高效地将大型WordPress站点手动迁移到子域名。这种方法避免了直接修改文件可能导致的序列化数据损坏问题，确保了迁移后的站点功能完整性。WP-CLI的search-replace命令是手动WordPress迁移的强大工具，对于处理复杂的URL和路径更新场景至关重要。完成迁移后，建议清除所有缓存（WordPress缓存、插件缓存、服务器缓存等），以确保新配置生效。