给WordPress建立测试副本:先隔离数据再试更新

适用:WordPress单站点,需要先测试主题、插件或PHP兼容性,再安排正式站更新。示例正式地址为https://www.example.com,测试地址为https://stage.example.com,均须替换。多站点网络和复杂电商系统不要直接照搬。

一、准备独立目录、数据库和访问入口

  1. 先取得同一时间点的完整网站文件和数据库备份,包含上传文件、主题、插件及配置。WordPress后台的文章导出文件不能代替整站备份。
  2. 创建新的测试站目录和数据库,例如/www/wwwroot/wp-stage与wp_stage。测试数据库账号只能访问测试库,不共用正式库账号。测试目录及上传目录也不能是指向正式站的符号链接。
  3. 为测试入口配置HTTPS和访问密码,或只允许指定来源访问。搜索引擎“不索引”选项不能代替访问限制。
  4. 将文件恢复到新目录,但先不要访问网页、运行计划任务或执行会加载WordPress的命令。

二、先切断与正式业务的联系

只编辑测试目录的wp-config.php,把DB_NAME、DB_USER、DB_PASSWORD、DB_HOST改为测试库连接信息。保留备份中原来的表前缀。核对无误后,才把SQL备份导入新库。

在加载WordPress之前的位置加入以下设置;已有同名常量时修改原行,不要重复定义:

define( 'WP_ENVIRONMENT_TYPE', 'staging' );
define( 'DISABLE_WP_CRON', true );

这两项只是标记环境和停止由访问触发的WP-Cron,不会自动关闭支付、邮件、系统计划任务或插件自己的任务。测试副本不得携带可操作正式业务的SMTP、短信、支付、对象存储、Webhook等凭据;替换成测试凭据或停用对应功能。Redis等共享缓存也须隔离,不能沿用正式站同一缓存空间。

首次加载前,在测试站wp-content/mu-plugins目录新建bly-staging-guard.php,内容如下,用来阻止标准WordPress邮件及HTTP请求:

<?php
if ( ! defined( 'ABSPATH' ) ) {
    exit;
}
if ( wp_get_environment_type() !== 'staging' ) {
    return;
}
add_filter( 'pre_wp_mail', '__return_false', PHP_INT_MAX );
add_filter( 'pre_http_request', function () {
    return new WP_Error( 'staging_blocked', '测试副本已阻止外部请求' );
}, PHP_INT_MAX );

这段保护只覆盖使用WordPress标准接口的程序。插件自己调用SMTP或cURL时仍可能绕过,因此不能省略凭据清理和测试主机的出站限制。涉及真实扣费、发信的副本,未隔离完成前不要启动。该文件也会拦截在线更新请求,测试更新应先准备好需要的安装包。

若插件凭据无法在首次加载前清理,先把测试副本的wp-content/plugins目录临时改名为plugins.hold,并检查复制来的其他MU插件、缓存入口及自定义加载代码。先只启动隔离后的WordPress本体;接口处理完毕后再恢复插件目录,逐个启用和检查。所有改名都只针对测试副本。

三、只在测试库替换网址

以下命令以已安装WP-CLI、由原站点运行账号执行为前提。先读取数据库名称,必须确认返回的是wp_stage。如果仍是正式库,立即停止,回到配置检查。

wp --path=/www/wwwroot/wp-stage config get DB_NAME
wp --path=/www/wwwroot/wp-stage config get DB_HOST
wp --path=/www/wwwroot/wp-stage --skip-plugins --skip-themes \
  search-replace 'https://www.example.com' 'https://stage.example.com' \
  --all-tables-with-prefix --skip-columns=guid --dry-run

核对试运行只涉及测试站表,再去掉--dry-run执行一次。该工具能处理序列化字段,不能用文本编辑器直接批量替换SQL。若原配置写死了WP_HOME、WP_SITEURL或上传目录,也要改为测试地址和测试目录。

四、证明测试不会改到正式站

  1. 登录测试后台,确认地址栏始终是测试域名。在“设置→阅读”中勾选不建议搜索引擎索引,作为访问限制之外的补充。
  2. 创建一篇带“测试副本”标记的草稿、上传一张无敏感信息的图片,确认正式站的内容和上传目录均未出现这些文件。
  3. 按同样路径核对首页、登录、表单、图片及需要使用的后台功能,再开始一次只改变一个组件的升级测试。
  4. 需要测试邮件或支付时,另接受控的测试通道并核验隔离边界,不解除保护后直接使用复制来的正式凭据。

测试完成后记录版本、改动和结果,在正式站重新备份后按记录实施。不要把测试数据库整库覆盖回正式站,否则测试期间新增的订单、用户或文章可能丢失。

相关教程:数据库导出与隔离恢复、WordPress更新与回退、创建网站与数据库。