寻求WordPress全站PHPUnit测试方案：保留数据库的测试配置

核心思路：复用现有数据库快照，避免全量重置 #

针对多插件相互依赖、配置存储在数据库的场景，核心是基于现有站点的数据库快照搭建测试环境，而非每次测试都初始化全新WordPress及空数据库。

具体实现步骤 #

1. 生成目标数据库快照 #

• 导出当前站点的数据库（包含所有插件配置、自定义表数据），保存为test-db-snapshot.sql
• 可选：排除wp_posts、wp_postmeta这类动态内容表（若测试无需验证内容逻辑），仅保留插件配置表（wp_options）、自定义业务表

2. 配置PHPUnit测试环境 #

• 在phpunit.xml中指定独立的测试数据库配置，与主环境完全隔离：

  <php>
      <env name="DB_NAME" value="wp_test_multiple_plugins"/>
      <env name="DB_USER" value="root"/>
      <env name="DB_PASSWORD" value=""/>
      <env name="DB_HOST" value="localhost"/>
      <env name="WP_TESTS_DIR" value="./vendor/wordpress/wordpress-tests-lib"/>
      <env name="WP_CORE_DIR" value="./wordpress"/>
      <env name="WP_PLUGIN_DIR" value="./wp-content/plugins"/>
  </php>
  

• 禁用WordPress测试套件默认的数据库重置逻辑：修改测试启动脚本，跳过install_wordpress()和reset_database()步骤

3. 加载快照到测试数据库 #

• 在测试套件的setUpBeforeClass()方法中，执行快照导入：

  public static function setUpBeforeClass(): void {
      // 连接测试数据库
      $db = new wpdb( getenv('DB_USER'), getenv('DB_PASSWORD'), getenv('DB_NAME'), getenv('DB_HOST') );
      // 导入预先生成的数据库快照
      $sql_content = file_get_contents( __DIR__ . '/test-db-snapshot.sql' );
      $db->query( $sql_content );
      // 初始化WordPress核心环境
      require_once getenv('WP_CORE_DIR') . '/wp-load.php';
  }
  

• 可选：为保证测试独立性，在单测试方法前后用事务包裹修改操作：

  protected function setUp(): void {
      parent::setUp();
      global $wpdb;
      $wpdb->query( 'START TRANSACTION' );
  }
  
  protected function tearDown(): void {
      global $wpdb;
      $wpdb->query( 'ROLLBACK' );
      parent::tearDown();
  }
  

4. 按依赖顺序加载插件 #

• 在测试入口文件中，手动按依赖顺序加载所有自定义插件的主文件：

  // 先加载基础依赖插件
  require_once WP_PLUGIN_DIR . '/plugin-core/plugin-core.php';
  // 再加载依赖它的插件
  require_once WP_PLUGIN_DIR . '/plugin-feature-a/plugin-feature-a.php';
  require_once WP_PLUGIN_DIR . '/plugin-feature-b/plugin-feature-b.php';
  

• 若插件需激活状态，可在setUpBeforeClass()中调用activate_plugin()批量激活：

  activate_plugin( 'plugin-core/plugin-core.php' );
  activate_plugin( 'plugin-feature-a/plugin-feature-a.php' );
  

5. 轻量模拟数据库数据（可选） #

• 若无需完整快照，可通过WP CLI生成模拟配置数据，写入test-setup.sh脚本在测试前执行：

  wp option update plugin_core_settings '{"api_key": "test_key", "debug": true}' --url=test.local
  wp db query "INSERT INTO wp_plugin_feature_a_custom (id, name, status) VALUES (1, 'test_item', 'active');"
  

注意事项 #

• 测试数据库必须与生产/开发环境物理隔离，避免误操作污染真实数据
• 定期更新数据库快照，确保测试用例基于最新的插件配置
• 涉及数据修改的测试，务必通过事务回滚或快照恢复保证测试独立性

内容的提问来源于stack exchange，提问作者Jacku