wpdev
c46814ce83
A v3.0.1 把 orchestrator 的 11 個 phase 抽成可注入的 Phase 物件，B 仍是 1107 行單體、以 'phase_' . $current 字串魔法分派、completed 甚至 inline 在 tick() 裡。本 commit 對齊： 新增 13 檔 - includes/migration/interface-migration-phase.php - includes/migration/class-tmdo-migration-phase-base.php（log/get_managed_keys/ execute_bulk_pivot/values_loose_equal 等共用 helper） - includes/migration/phases/ 11 個 phase 類別 orchestrator 1107 → 640 行 - tick() 改 make_phase() 工廠 + $phase->execute($job) - 移除 final、self::ENTITY_TYPE → static::（A v3.3.0 late static binding） - 保留 B 原有的 '✓ %s (%.2fs)' 耗時 log（改為 tick 自行量測，A 版已簡化掉） - 公開介面（preflight/start/tick/get_status/cancel/resume/needs_attention/ cron_tick）經 diff 確認與 A 完全一致，呼叫端零影響 連帶 - Schema_Manager 補 table_exists 的 request-scoped cache 與 flush_table_exists_cache()（A v3.1.6 + v3.4.6），Phase 測試需要它 - back-compat 補 12 個 Phase 類別的 WPDO_ alias - 移植 MigrationPhaseTest + MigrationPhaseRemainingTest（527 行） 測試隔離差異（B 的 unit bootstrap 會載入 Member_Fields / Post_Fields， A 的不會）：MigrationPhaseRemainingTest 的 setUp 需額外清空 Entity_Registry 與 wpdo_register_entity_fields listener，否則 install_schema 會真的走進 dbDelta。MigrationPhaseTest 的 interface 斷言改用 TMDO_ 正式名稱 （PHP 無法 class_alias 介面，且該契約是核心內部擴充點）。 unit 451 / integration 398 GREEN Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TbG1keQQ7XBa7qMQY16KCY
197 lines
9.6 KiB
PHP
197 lines
9.6 KiB
PHP
<?php
|
||
/**
|
||
* Back-compat aliases — 對外保留 WPDO_* 類別 / 常數，讓 hub-core / spoke-sso /
|
||
* 其他 sister plugins 在升級到 2meet-data-optimizer 後不需修改任何 class_exists()
|
||
* / new WPDO_X() / WPDO_API::xxx() 呼叫。
|
||
*
|
||
* Phase 1 起穩定。v0.2.0 後可加 _doing_it_wrong() deprecation notice。
|
||
*
|
||
* @package TMDO
|
||
*/
|
||
|
||
if ( ! defined( 'ABSPATH' ) ) {
|
||
exit;
|
||
}
|
||
|
||
// ── 公開合約類別（Phase 1 凍結，不可移除）─────────────────────────────
|
||
$tmdo_class_aliases = array(
|
||
'TMDO_API' => 'WPDO_API',
|
||
'TMDO_Schema_Registry' => 'WPDO_Schema_Registry',
|
||
'TMDO_Entity_Registry' => 'WPDO_Entity_Registry',
|
||
'TMDO_Custom_Table_Registry' => 'WPDO_Custom_Table_Registry',
|
||
'TMDO_Feature_Flags' => 'WPDO_Feature_Flags',
|
||
'TMDO_DB' => 'WPDO_DB',
|
||
'TMDO_Crypto' => 'WPDO_Crypto',
|
||
'TMDO_Logger' => 'WPDO_Logger',
|
||
'TMDO_Capability' => 'WPDO_Capability',
|
||
'TMDO_Safe_Unserialize' => 'WPDO_Safe_Unserialize',
|
||
// Engine / Migration / Adapters（second-tier，部分 sister plugin 已直接呼叫）
|
||
'TMDO_Hook_Bus' => 'WPDO_Hook_Bus',
|
||
'TMDO_Mode_Manager' => 'WPDO_Mode_Manager',
|
||
'TMDO_Migration_Engine' => 'WPDO_Migration_Engine',
|
||
'TMDO_Migration_Orchestrator' => 'WPDO_Migration_Orchestrator',
|
||
'TMDO_Entity_Migration_Engine' => 'WPDO_Entity_Migration_Engine',
|
||
'TMDO_Entity_Health' => 'WPDO_Entity_Health',
|
||
'TMDO_Schema_Manager' => 'WPDO_Schema_Manager',
|
||
'TMDO_Sync_Bridge' => 'WPDO_Sync_Bridge',
|
||
'TMDO_Query_Router' => 'WPDO_Query_Router',
|
||
'TMDO_Post_Query_Router' => 'WPDO_Post_Query_Router',
|
||
'TMDO_Hook_Bus_Bridge' => 'WPDO_Hook_Bus_Bridge',
|
||
'TMDO_Conflict_Monitor' => 'WPDO_Conflict_Monitor',
|
||
'TMDO_Compatibility' => 'WPDO_Compatibility',
|
||
'TMDO_Installer' => 'WPDO_Installer',
|
||
'TMDO_Cache_Layer' => 'WPDO_Cache_Layer',
|
||
'TMDO_Zone_Classifier' => 'WPDO_Zone_Classifier',
|
||
'TMDO_Core' => 'WPDO_Core',
|
||
'TMDO_REST_API' => 'WPDO_REST_API',
|
||
'TMDO_Snapshot_Manager' => 'WPDO_Snapshot_Manager',
|
||
'TMDO_Snapshot_Writer' => 'WPDO_Snapshot_Writer',
|
||
'TMDO_Snapshot_Reader' => 'WPDO_Snapshot_Reader',
|
||
'TMDO_Snapshot_Pruner' => 'WPDO_Snapshot_Pruner',
|
||
'TMDO_FSM_Guard' => 'WPDO_FSM_Guard',
|
||
'TMDO_Site_Health' => 'WPDO_Site_Health',
|
||
'TMDO_Health_Cron' => 'WPDO_Health_Cron',
|
||
'TMDO_Email_Notifier' => 'WPDO_Email_Notifier',
|
||
'TMDO_Slack_Notifier' => 'WPDO_Slack_Notifier',
|
||
'TMDO_Discord_Notifier' => 'WPDO_Discord_Notifier',
|
||
'TMDO_Telegram_Notifier' => 'WPDO_Telegram_Notifier',
|
||
'TMDO_Monthly_Summary' => 'WPDO_Monthly_Summary',
|
||
'TMDO_Site_Metrics_Collector' => 'WPDO_Site_Metrics_Collector',
|
||
'TMDO_FSM_Advisor' => 'WPDO_FSM_Advisor',
|
||
'TMDO_Module_Detector' => 'WPDO_Module_Detector',
|
||
'TMDO_FSM_Automator' => 'WPDO_FSM_Automator',
|
||
'TMDO_Module_Rules' => 'WPDO_Module_Rules',
|
||
'TMDO_CSV_Writer' => 'WPDO_CSV_Writer',
|
||
'TMDO_Export' => 'WPDO_Export',
|
||
'TMDO_CLI' => 'WPDO_CLI',
|
||
'TMDO_CLI_V2' => 'WPDO_CLI_V2',
|
||
'TMDO_CLI_Member' => 'WPDO_CLI_Member',
|
||
'TMDO_CLI_Post' => 'WPDO_CLI_Post',
|
||
'TMDO_CLI_Term_Comment' => 'WPDO_CLI_Term_Comment',
|
||
'TMDO_Member_Fields' => 'WPDO_Member_Fields',
|
||
'TMDO_Post_Fields' => 'WPDO_Post_Fields',
|
||
'TMDO_Points_Manager' => 'WPDO_Points_Manager',
|
||
'TMDO_Demo_Entity_Counter' => 'WPDO_Demo_Entity_Counter',
|
||
'TMDO_Postmeta_Cleaner' => 'WPDO_Postmeta_Cleaner',
|
||
'TMDO_Termmeta_Cleaner' => 'WPDO_Termmeta_Cleaner',
|
||
'TMDO_Commentmeta_Cleaner' => 'WPDO_Commentmeta_Cleaner',
|
||
'TMDO_Post_Stress_Tester' => 'WPDO_Post_Stress_Tester',
|
||
'TMDO_User_Stress_Tester' => 'WPDO_User_Stress_Tester',
|
||
'TMDO_Term_Stress_Tester' => 'WPDO_Term_Stress_Tester',
|
||
'TMDO_Comment_Stress_Tester' => 'WPDO_Comment_Stress_Tester',
|
||
'TMDO_Post_Shadow_Verifier' => 'WPDO_Post_Shadow_Verifier',
|
||
'TMDO_Term_Comment_Shadow_Verifier' => 'WPDO_Term_Comment_Shadow_Verifier',
|
||
'TMDO_Term_Comment_Backfill' => 'WPDO_Term_Comment_Backfill',
|
||
'TMDO_Term_Comment_Misc_Bucket' => 'WPDO_Term_Comment_Misc_Bucket',
|
||
'TMDO_Term_Comment_Garbage_Filter' => 'WPDO_Term_Comment_Garbage_Filter',
|
||
'TMDO_Setup_Wizard' => 'WPDO_Setup_Wizard',
|
||
'TMDO_Dashboard_Widget' => 'WPDO_Dashboard_Widget',
|
||
'TMDO_Help_Tabs' => 'WPDO_Help_Tabs',
|
||
'TMDO_Admin' => 'WPDO_Admin',
|
||
'TMDO_V2_Upgrader' => 'WPDO_V2_Upgrader',
|
||
'TMDO_SQLite_Compat' => 'WPDO_SQLite_Compat',
|
||
'TMDO_Type_Caster' => 'WPDO_Type_Caster',
|
||
'TMDO_Audit_Logger' => 'WPDO_Audit_Logger',
|
||
'TMDO_Shadow_Diff_Logger' => 'WPDO_Shadow_Diff_Logger',
|
||
'TMDO_Conflict_Detector' => 'WPDO_Conflict_Detector',
|
||
'TMDO_Cache_Orchestrator' => 'WPDO_Cache_Orchestrator',
|
||
'TMDO_Query_Compiler' => 'WPDO_Query_Compiler',
|
||
'TMDO_Auto_Promoter' => 'WPDO_Auto_Promoter',
|
||
'TMDO_Adapter_Post' => 'WPDO_Adapter_Post',
|
||
'TMDO_Adapter_User' => 'WPDO_Adapter_User',
|
||
'TMDO_Adapter_Term' => 'WPDO_Adapter_Term',
|
||
'TMDO_Adapter_Comment' => 'WPDO_Adapter_Comment',
|
||
'TMDO_Options_Manager' => 'WPDO_Options_Manager',
|
||
'TMDO_Hot_Migration' => 'WPDO_Hot_Migration',
|
||
'TMDO_Warm_Migration' => 'WPDO_Warm_Migration',
|
||
'TMDO_Cold_Migration' => 'WPDO_Cold_Migration',
|
||
'TMDO_Archive_Migration' => 'WPDO_Archive_Migration',
|
||
'TMDO_Migration_Base' => 'WPDO_Migration_Base',
|
||
'TMDO_Post_Migration' => 'WPDO_Post_Migration',
|
||
'TMDO_Zone_Hot' => 'WPDO_Zone_Hot',
|
||
'TMDO_Zone_Warm' => 'WPDO_Zone_Warm',
|
||
'TMDO_Zone_Cold' => 'WPDO_Zone_Cold',
|
||
'TMDO_Zone_Router' => 'WPDO_Zone_Router',
|
||
'TMDO_Routing_Predicate' => 'WPDO_Routing_Predicate',
|
||
'TMDO_Migration_Phase_Base' => 'WPDO_Migration_Phase_Base',
|
||
'TMDO_Phase_Diagnose' => 'WPDO_Phase_Diagnose',
|
||
'TMDO_Phase_Backup' => 'WPDO_Phase_Backup',
|
||
'TMDO_Phase_Demote' => 'WPDO_Phase_Demote',
|
||
'TMDO_Phase_Install_Schema' => 'WPDO_Phase_Install_Schema',
|
||
'TMDO_Phase_Backfill_Bulk' => 'WPDO_Phase_Backfill_Bulk',
|
||
'TMDO_Phase_Backfill_Unserialize' => 'WPDO_Phase_Backfill_Unserialize',
|
||
'TMDO_Phase_Promote_Shadow' => 'WPDO_Phase_Promote_Shadow',
|
||
'TMDO_Phase_Verify_Sample' => 'WPDO_Phase_Verify_Sample',
|
||
'TMDO_Phase_Promote_Aeav' => 'WPDO_Phase_Promote_Aeav',
|
||
'TMDO_Phase_Cleanup' => 'WPDO_Phase_Cleanup',
|
||
'TMDO_Phase_Completed' => 'WPDO_Phase_Completed',
|
||
'TMDO_Zone_Archive' => 'WPDO_Zone_Archive',
|
||
'TMDO_Interceptor_Base' => 'WPDO_Interceptor_Base',
|
||
'TMDO_Query_Interceptor_Base' => 'WPDO_Query_Interceptor_Base',
|
||
'TMDO_Notifier' => 'WPDO_Notifier',
|
||
);
|
||
|
||
foreach ( $tmdo_class_aliases as $tmdo_class => $wpdo_alias ) {
|
||
if ( class_exists( $tmdo_class, false ) && ! class_exists( $wpdo_alias, false ) ) {
|
||
class_alias( $tmdo_class, $wpdo_alias );
|
||
}
|
||
}
|
||
unset( $tmdo_class_aliases, $tmdo_class, $wpdo_alias );
|
||
|
||
// trait + interface back-compat（PHP class_alias 不支援 trait/interface，用 wrapper 解決）。
|
||
require_once __DIR__ . '/back-compat/trait-wpdo-anti-eav-aware-alias.php';
|
||
require_once __DIR__ . '/back-compat/interface-wpdo-entity-adapter-alias.php';
|
||
|
||
// ── 常數別名（部分 sister plugin 直接讀取常數）─────────────────────────
|
||
if ( ! defined( 'WPDO_VERSION' ) ) {
|
||
define( 'WPDO_VERSION', TMDO_VERSION );
|
||
}
|
||
if ( ! defined( 'WPDO_DB_VERSION' ) ) {
|
||
define( 'WPDO_DB_VERSION', TMDO_DB_VERSION );
|
||
}
|
||
if ( ! defined( 'WPDO_PLUGIN_DIR' ) ) {
|
||
define( 'WPDO_PLUGIN_DIR', TMDO_PATH );
|
||
}
|
||
if ( ! defined( 'WPDO_PLUGIN_URL' ) ) {
|
||
define( 'WPDO_PLUGIN_URL', TMDO_URL );
|
||
}
|
||
if ( ! defined( 'WPDO_PLUGIN_FILE' ) ) {
|
||
define( 'WPDO_PLUGIN_FILE', TMDO_FILE );
|
||
}
|
||
if ( ! defined( 'WPDO_TABLE_PREFIX' ) ) {
|
||
define( 'WPDO_TABLE_PREFIX', TMDO_TABLE_PREFIX );
|
||
}
|
||
if ( ! defined( 'WPDO_CACHE_GROUP' ) ) {
|
||
define( 'WPDO_CACHE_GROUP', TMDO_CACHE_GROUP );
|
||
}
|
||
if ( ! defined( 'WPDO_IS_SQLITE' ) ) {
|
||
define( 'WPDO_IS_SQLITE', TMDO_IS_SQLITE );
|
||
}
|
||
if ( ! defined( 'WPDO_IS_MYSQL' ) ) {
|
||
define( 'WPDO_IS_MYSQL', TMDO_IS_MYSQL );
|
||
}
|
||
|
||
// ── Hook dual-fire bridge ─────────────────────────────────────────────────
|
||
// Phase 1 過渡期：tmdo_* 與 wpdo_* hook 雙向轉發，讓既有 listener 仍能接收事件。
|
||
foreach ( array(
|
||
'wpdo_register_fields',
|
||
'wpdo_register_entity_fields',
|
||
'wpdo_register_custom_tables',
|
||
'wpdo_after_write',
|
||
'wpdo_after_delete',
|
||
'wpdo_schema_updated',
|
||
'wpdo_bridge_mode_changed',
|
||
'wpdo_bridge_emergency_disabled',
|
||
'wpdo_auto_promoted',
|
||
) as $tmdo_back_compat_hook ) {
|
||
$tmdo_new_hook = preg_replace( '/^wpdo_/', 'tmdo_', $tmdo_back_compat_hook );
|
||
add_action(
|
||
$tmdo_new_hook,
|
||
static function ( ...$args ) use ( $tmdo_back_compat_hook ) {
|
||
do_action_ref_array( $tmdo_back_compat_hook, $args );
|
||
},
|
||
1
|
||
);
|
||
}
|
||
unset( $tmdo_back_compat_hook, $tmdo_new_hook );
|