test: 建立 phpunit 測試基建並移植 25 個 HivePress 測試

AddOn 先前 tests=0。新增： - composer.json（dev 依賴 + phpunit/phpcs script） - phpunit.xml（failOnWarning=true） - tests/bootstrap.php：直接 require 核心 plugin 的 unit bootstrap，避免複製 ~700 行 WP stub，再載入本 AddOn 的類別；補 trait wrapper 與自動 WPDO_ alias （includes/back-compat-aliases.php 掛在 plugins_loaded:7，PHPUnit 下不會跑） - tests/unit/ 25 個測試 + WpdbMockTrait（自 A 移植）生產碼一併修對外契約：interface-tmdo-hp-adapter.php 改為先宣告空的 WPDO_HivePress_Adapter、再讓 TMDO_HivePress_Adapter extends 它（PHP 無法 class_alias 介面，只有繼承能讓 instanceof WPDO_HivePress_Adapter 對 implements TMDO_ 名稱的 adapter 成立）。與核心 interface-entity-adapter.php 同一模式。這也讓第三方自訂 adapter 用舊介面名仍可通過核心檢查。 145 tests / 357 assertions GREEN Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TbG1keQQ7XBa7qMQY16KCY
2026-07-31 09:19:01 +08:00
parent b96b041445
commit 0a3b05789e
32 changed files with 2574 additions and 59 deletions
@@ -0,0 +1,79 @@
+<?php
+declare(strict_types=1);
+
+/**
+ * Shared $wpdb mock helper for HivePress adapter tests.
+ *
+ * Several existing wpdo tests (ZoneHotTest, SyncBridgeTest, etc.) replace the
+ * global $wpdb with their own anonymous-class mock and never restore it. When
+ * our adapter tests run after those, $wpdb lacks the query/get_col/delete
+ * methods our mirror_insert / cron-optimizer code paths call, causing
+ * cross-test pollution failures.
+ *
+ * Trait reinstalls a known $wpdb mock + clears the wpdo_features option so
+ * Feature_Flags reports idle — the safe default state.
+ */
+trait WpdbMockTrait {
+
+	/**
+	 * Install a fresh $wpdb mock with the methods adapter code paths call.
+	 *
+	 * Idempotent — call from setUp() in test classes that touch $wpdb.
+	 */
+	protected function install_wpdb_mock(): void {
+		global $wpdb;
+		$wpdb = new class {
+			public string $prefix   = 'wp_';
+			public string $comments = 'wp_comments';
+			public string $postmeta = 'wp_postmeta';
+			public string $posts    = 'wp_posts';
+			public string $options  = 'wp_options';
+
+			/** @var array<int,string> */
+			public array $queries = array();
+
+			public function prepare( string $sql, ...$args ): string {
+				$i = 0;
+				return (string) preg_replace_callback(
+					'/%[sd]/',
+					static function () use ( &$i, $args ) {
+						return $args[ $i++ ] ?? '?';
+					},
+					$sql
+				);
+			}
+
+			public function query( string $sql ): int|bool {
+				$this->queries[] = $sql;
+				return 1;
+			}
+
+			public function get_var( string $sql ): ?string {
+				return null;
+			}
+
+			public function get_col( string $sql ): array {
+				return array();
+			}
+
+			public function get_results( string $sql, $output = OBJECT ): array {
+				return array();
+			}
+
+			public function insert( string $table, array $data, $format = null ): int|false {
+				return 1;
+			}
+
+			public function update( string $table, array $data, array $where, $format = null, $where_format = null ): int|false {
+				return 1;
+			}
+
+			public function delete( string $table, array $where, $format = null ): int|false {
+				return 1;
+			}
+		};
+
+		// Reset Feature_Flags state so is_query_active() returns false in tests.
+		$GLOBALS['_wp_options']['wpdo_features'] = array();
+	}
+}