chore: initial snapshot of 2meet-data-optimizer v0.1.0

Baseline before backporting wp-data-optimizer v3.0.1-v3.4.6. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TbG1keQQ7XBa7qMQY16KCY
2026-07-31 05:06:36 +08:00
commit d36bb954d1
206 changed files with 66538 additions and 0 deletions
@@ -0,0 +1,83 @@
+<?php
+/**
+ * Entity Adapter 合約介面
+ *
+ * 所有實體適配器（Post/User/Term/Comment）必須實作此介面
+ * 將不同實體的行為標準化，供 Hook Bus 統一呼叫
+ *
+ * @package WP_Data_Optimizer
+ */
+
+// phpcs:disable Squiz.Commenting,Generic.Commenting,WordPress.DB.PreparedSQL.NotPrepared,WordPress.DB.PreparedSQL.InterpolatedNotPrepared,WordPress.DB.PreparedSQLPlaceholders.ReplacementsWrongNumber,Generic.CodeAnalysis.UnusedFunctionParameter,Generic.CodeAnalysis.EmptyStatement,Squiz.PHP.DisallowMultipleAssignments,Squiz.PHP.DisallowSizeFunctionsInLoops,WordPress.WP.I18n.MissingTranslatorsComment,WordPress.PHP.NoSilencedErrors,WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents,Squiz.PHP.CommentedOutCode,Universal.NamingConventions.NoReservedKeywordParameterNames,WordPress.PHP.YodaConditions,Squiz.Commenting.InlineComment.InvalidEndChar -- PR-1 ported from UAE; cleanup PR scheduled.
+
+
+defined( 'ABSPATH' ) || exit;
+
+// Back-compat: define WPDO_ marker first so TMDO_ can extend it.
+// PHP class_alias() doesn't work on interfaces; extending is the only option.
+// Any class implementing TMDO_Entity_Adapter_Interface automatically satisfies
+// `instanceof WPDO_Entity_Adapter_Interface` via interface inheritance.
+if ( ! interface_exists( 'WPDO_Entity_Adapter_Interface', false ) ) {
+	interface WPDO_Entity_Adapter_Interface {}
+}
+
+interface TMDO_Entity_Adapter_Interface extends WPDO_Entity_Adapter_Interface {
+
+	/**
+	 * 實體類型識別子
+	 * 必須回傳 WordPress metadata type 之一：post|user|term|comment
+	 */
+	public function get_entity_type(): string;
+
+	/**
+	 * 原生 meta 表完整名稱（含 wp_ 前綴）
+	 * 例：wp_postmeta / wp_usermeta
+	 */
+	public function get_native_meta_table(): string;
+
+	/**
+	 * 原生 meta 表中指向實體的欄位名稱
+	 * 例：post_id / user_id / term_id / comment_id
+	 */
+	public function get_entity_id_column(): string;
+
+	/**
+	 * 對應的主實體表（用於 JOIN）
+	 * 例：wp_posts / wp_users / wp_terms / wp_comments
+	 */
+	public function get_primary_table(): string;
+
+	/**
+	 * 主實體表的主鍵欄位
+	 * 例：ID (post/user) / term_id / comment_ID
+	 */
+	public function get_primary_id_column(): string;
+
+	/**
+	 * 快取群組名稱（供 wp_cache_* 使用）
+	 */
+	public function get_cache_group(): string;
+
+	/**
+	 * 實體刪除時會觸發的 WordPress hook
+	 * 用於自動清理 UAE 資料表中對應列
+	 */
+	public function get_delete_hook(): string;
+
+	/**
+	 * 擴充原生查詢物件以支援 UAE meta_query
+	 *
+	 * @param mixed $query_object WP_Query / WP_User_Query / WP_Comment_Query 等
+	 */
+	public function extend_native_query( $query_object ): void;
+
+	/**
+	 * 取得所有已知的 ID（用於遷移時的迭代）
+	 * 採用 cursor-based 分頁
+	 *
+	 * @param int $after_id 取大於此 ID 的筆
+	 * @param int $limit    取多少筆
+	 * @return array<int>
+	 */
+	public function get_entity_ids_after( int $after_id, int $limit ): array;
+}