wpdev/2meet-data-optimizer
1
0
Fork 0
Code Issues Pull Requests 2 Actions Packages Projects Releases 1 Wiki Activity

build: 移植 PHPCS + PHPStan L6 品質 gate（PR-I 前半）

Browse Source 
- phpcs.xml（自 A 移植）：ruleset 改名、*/tools/* 例外換成 */back-compat/*、
  中文註解全域排除 Squiz.Commenting.InlineComment.InvalidEndChar、
  interface 別名檔排除 OneObjectStructurePerFile
- 檔頭正規化：16 個檔案的 declare(strict_types=1) 與前導 // 註解移到
  file docblock 之後，並移除 <?php 後多餘空行（phpcbf 另自動修 190 處）
- phpstan.neon + .phpstan/stubs.php（TMDO_ 與 WPDO_ 兩套常數）+
  重新產生的 phpstan-baseline.neon（710 errors，A 的 3877 行 baseline
  因前綴與路徑不同無法沿用）

現況：PHPCS 0 errors / 0 warnings、PHPStan L6 No errors、
unit 451 / integration 398 GREEN

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TbG1keQQ7XBa7qMQY16KCY
This commit is contained in:
wpdev
2026-07-31 06:22:00 +08:00
parent 76c01e44df
commit f524ea3f16
23 changed files with 4356 additions and 340 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.gitignore
+1
View File
@@ -14,3 +14,4 @@ Thumbs.db
.playwright-mcp/ .playwright-mcp/
.claude/ .claude/
dist/ dist/
.phpcs-cache
.phpstan/stubs.php
+34
View File
@@ -0,0 +1,34 @@
<?php
/**
* PHPStan bootstrap stubs — plugin constants defined at runtime.
*
* PHPStan cannot see define()'d constants, so it reports "undefined constant"
* for every one of them. Stubbing them here keeps level 6 signal-to-noise high.
*
* TMDO_IS_SQLITE / TMDO_IS_MYSQL (and their WPDO_ aliases) are intentionally
* NOT stubbed to avoid literal-narrowing "always true/false" false positives
* on runtime-dynamic values.
*
* @package TMDO
*/
declare(strict_types=1);
define( 'TMDO_VERSION', '0.0.0' );
define( 'TMDO_DB_VERSION', '0.0.0' );
define( 'TMDO_PATH', '/' );
define( 'TMDO_URL', 'https://example.test/wp-content/plugins/2meet-data-optimizer/' );
define( 'TMDO_FILE', '/2meet-data-optimizer.php' );
define( 'TMDO_TABLE_PREFIX', 'wpdo_' );
define( 'TMDO_CACHE_GROUP', 'wpdo' );
define( 'TMDO_MIN_PHP', '8.1' );
define( 'TMDO_MIN_WP', '6.0' );
// Back-compat aliases exposed by class-tmdo-back-compat.php.
define( 'WPDO_VERSION', '0.0.0' );
define( 'WPDO_DB_VERSION', '0.0.0' );
define( 'WPDO_PLUGIN_DIR', '/' );
define( 'WPDO_PLUGIN_URL', 'https://example.test/wp-content/plugins/2meet-data-optimizer/' );
define( 'WPDO_PLUGIN_FILE', '/2meet-data-optimizer.php' );
define( 'WPDO_TABLE_PREFIX', 'wpdo_' );
define( 'WPDO_CACHE_GROUP', 'wpdo' );
admin/class-tmdo-admin.php
+7 -6
View File
@@ -1,13 +1,14 @@
<?php <?php
declare(strict_types=1);
// phpcs:ignore WPDO.AntiEAV -- platform admin UI: native meta queries for management dashboard
/** /**
* WP Data Optimizer admin UI class. * WP Data Optimizer admin UI class.
* *
* @package WP_Data_Optimizer * @package WP_Data_Optimizer
*/ */
// phpcs:ignore WPDO.AntiEAV -- platform admin UI: native meta queries for management dashboard
declare(strict_types=1);
if ( ! defined( 'ABSPATH' ) ) { if ( ! defined( 'ABSPATH' ) ) {
exit; exit;
} }
@@ -3109,9 +3110,9 @@ wpdo.getListings({ per_page: 3 }).then(r => console.log(r));'
); );
echo '</tr></thead><tbody>'; echo '</tr></thead><tbody>';
foreach ( $enable as $module => $r ) { foreach ( $enable as $module => $r ) {
$conf = (float) $r['confidence']; $conf = (float) $r['confidence'];
$bar_w = (int) round( $conf * 100 ); $bar_w = (int) round( $conf * 100 );
$color = $conf >= 0.7 ? '#46b450' : ( $conf >= 0.5 ? '#dba617' : '#c3c4c7' ); $color = $conf >= 0.7 ? '#46b450' : ( $conf >= 0.5 ? '#dba617' : '#c3c4c7' );
printf( printf(
'<tr><td><code>%s</code></td><td><div style="background:#f0f0f1;border-radius:3px;width:80px;height:18px;position:relative;"><div style="background:%s;width:%d%%;height:100%%;border-radius:3px;"></div><span style="position:absolute;inset:0;text-align:center;font-size:11px;line-height:18px;">%s</span></div></td>', '<tr><td><code>%s</code></td><td><div style="background:#f0f0f1;border-radius:3px;width:80px;height:18px;position:relative;"><div style="background:%s;width:%d%%;height:100%%;border-radius:3px;"></div><span style="position:absolute;inset:0;text-align:center;font-size:11px;line-height:18px;">%s</span></div></td>',
esc_html( $module ), esc_html( $module ),
admin/class-tmdo-dashboard-widget.php
+5 -4
View File
@@ -1,7 +1,4 @@
<?php <?php
declare(strict_types=1);
// phpcs:ignore WPDO.AntiEAV -- platform admin UI: native postmeta count for dashboard widget
/** /**
* TMDO_Dashboard_Widget — wp-admin home dashboard widget (v2.4.0 M9). * TMDO_Dashboard_Widget — wp-admin home dashboard widget (v2.4.0 M9).
* *
@@ -17,6 +14,10 @@ declare(strict_types=1);
* @package WP_Data_Optimizer * @package WP_Data_Optimizer
*/ */
// phpcs:ignore WPDO.AntiEAV -- platform admin UI: native postmeta count for dashboard widget
declare(strict_types=1);
if ( ! defined( 'ABSPATH' ) ) { if ( ! defined( 'ABSPATH' ) ) {
exit; exit;
} }
@@ -60,7 +61,7 @@ class TMDO_Dashboard_Widget {
* @return void * @return void
*/ */
public static function render(): void { public static function render(): void {
$page_url = admin_url( 'tools.php?page=wp-data-optimizer' ); $page_url = admin_url( 'tools.php?page=wp-data-optimizer' );
$bridge_url = add_query_arg( 'tab', 'entity-bridge', $page_url ); $bridge_url = add_query_arg( 'tab', 'entity-bridge', $page_url );
$status = self::compute_status(); $status = self::compute_status();
admin/class-tmdo-setup-wizard.php
+4 -3
View File
@@ -1,7 +1,4 @@
<?php <?php
declare(strict_types=1);
// phpcs:ignore WPDO.AntiEAV -- platform admin UI: postmeta inventory for setup wizard
/** /**
* TMDO_Setup_Wizard — First-run onboarding wizard (v2.3.0 M5). * TMDO_Setup_Wizard — First-run onboarding wizard (v2.3.0 M5).
* *
@@ -22,6 +19,10 @@ declare(strict_types=1);
* @package WP_Data_Optimizer * @package WP_Data_Optimizer
*/ */
// phpcs:ignore WPDO.AntiEAV -- platform admin UI: postmeta inventory for setup wizard
declare(strict_types=1);
if ( ! defined( 'ABSPATH' ) ) { if ( ! defined( 'ABSPATH' ) ) {
exit; exit;
} }
admin/templates/comment-stress-test.php
+4 -3
View File
@@ -1,7 +1,4 @@
<?php <?php
declare(strict_types=1);
// phpcs:ignore WPDO.AntiEAV -- platform admin UI: stress test SQL example display
/** /**
* Comment Stress Test template (v2.13.1). * Comment Stress Test template (v2.13.1).
* *
@@ -18,6 +15,10 @@ declare(strict_types=1);
* @package WP_Data_Optimizer * @package WP_Data_Optimizer
*/ */
// phpcs:ignore WPDO.AntiEAV -- platform admin UI: stress test SQL example display
declare(strict_types=1);
if ( ! defined( 'ABSPATH' ) ) { if ( ! defined( 'ABSPATH' ) ) {
exit; exit;
} }
admin/templates/term-stress-test.php
+4 -3
View File
@@ -1,7 +1,4 @@
<?php <?php
declare(strict_types=1);
// phpcs:ignore WPDO.AntiEAV -- platform admin UI: stress test SQL example display
/** /**
* Term Stress Test template (v2.13.0). * Term Stress Test template (v2.13.0).
* *
@@ -18,6 +15,10 @@ declare(strict_types=1);
* @package WP_Data_Optimizer * @package WP_Data_Optimizer
*/ */
// phpcs:ignore WPDO.AntiEAV -- platform admin UI: stress test SQL example display
declare(strict_types=1);
if ( ! defined( 'ABSPATH' ) ) { if ( ! defined( 'ABSPATH' ) ) {
exit; exit;
} }
cli/class-tmdo-cli-member.php
+4 -3
View File
@@ -1,7 +1,4 @@
<?php <?php
declare(strict_types=1);
// phpcs:ignore WPDO.AntiEAV -- platform CLI inspector tool: raw meta queries needed for diagnostics
/** /**
* TMDO_CLI_Member — Member flat-table CLI subcommands. * TMDO_CLI_Member — Member flat-table CLI subcommands.
* *
@@ -19,6 +16,10 @@ declare(strict_types=1);
* @since 2.5.5 * @since 2.5.5
*/ */
// phpcs:ignore WPDO.AntiEAV -- platform CLI inspector tool: raw meta queries needed for diagnostics
declare(strict_types=1);
if ( ! defined( 'ABSPATH' ) ) { if ( ! defined( 'ABSPATH' ) ) {
exit; exit;
} }
cli/class-tmdo-cli-post.php
+4 -3
View File
@@ -1,7 +1,4 @@
<?php <?php
declare(strict_types=1);
// phpcs:ignore WPDO.AntiEAV -- platform CLI inspector tool: raw meta queries needed for diagnostics
/** /**
* TMDO_CLI_Post — Post entity CLI subcommands (v2.9.0+). * TMDO_CLI_Post — Post entity CLI subcommands (v2.9.0+).
* *
@@ -18,6 +15,10 @@ declare(strict_types=1);
* @since 2.9.0 * @since 2.9.0
*/ */
// phpcs:ignore WPDO.AntiEAV -- platform CLI inspector tool: raw meta queries needed for diagnostics
declare(strict_types=1);
if ( ! defined( 'ABSPATH' ) ) { if ( ! defined( 'ABSPATH' ) ) {
exit; exit;
} }
cli/class-tmdo-cli-term-comment.php
+4 -3
View File
@@ -1,7 +1,4 @@
<?php <?php
declare(strict_types=1);
// phpcs:ignore WPDO.AntiEAV -- platform CLI inspector tool: raw meta queries needed for diagnostics
/** /**
* TMDO_CLI_Term_Comment — Term + Comment entity CLI subcommands (v2.12.0+). * TMDO_CLI_Term_Comment — Term + Comment entity CLI subcommands (v2.12.0+).
* *
@@ -21,6 +18,10 @@ declare(strict_types=1);
* @since 2.12.0 * @since 2.12.0
*/ */
// phpcs:ignore WPDO.AntiEAV -- platform CLI inspector tool: raw meta queries needed for diagnostics
declare(strict_types=1);
if ( ! defined( 'ABSPATH' ) ) { if ( ! defined( 'ABSPATH' ) ) {
exit; exit;
} }
includes/advisor/class-tmdo-fsm-advisor.php
+4 -3
View File
@@ -1,7 +1,4 @@
<?php <?php
declare(strict_types=1);
// phpcs:ignore WPDO.AntiEAV -- platform diagnostic: raw meta inspection for FSM state advisor
/** /**
* TMDO_FSM_Advisor — Recommends the next FSM state per module (v2.4.0 M12). * TMDO_FSM_Advisor — Recommends the next FSM state per module (v2.4.0 M12).
* *
@@ -24,6 +21,10 @@ declare(strict_types=1);
* @package WP_Data_Optimizer * @package WP_Data_Optimizer
*/ */
// phpcs:ignore WPDO.AntiEAV -- platform diagnostic: raw meta inspection for FSM state advisor
declare(strict_types=1);
if ( ! defined( 'ABSPATH' ) ) { if ( ! defined( 'ABSPATH' ) ) {
exit; exit;
} }
includes/class-tmdo-back-compat.php
+113 -113
View File
@@ -17,121 +17,121 @@ if ( ! defined( 'ABSPATH' ) ) {
// ── 公開合約類別（Phase 1 凍結，不可移除）───────────────────────────── // ── 公開合約類別（Phase 1 凍結，不可移除）─────────────────────────────
$tmdo_class_aliases = array( $tmdo_class_aliases = array(
'TMDO_API' => 'WPDO_API', 'TMDO_API' => 'WPDO_API',
'TMDO_Schema_Registry' => 'WPDO_Schema_Registry', 'TMDO_Schema_Registry' => 'WPDO_Schema_Registry',
'TMDO_Entity_Registry' => 'WPDO_Entity_Registry', 'TMDO_Entity_Registry' => 'WPDO_Entity_Registry',
'TMDO_Custom_Table_Registry' => 'WPDO_Custom_Table_Registry', 'TMDO_Custom_Table_Registry' => 'WPDO_Custom_Table_Registry',
'TMDO_Feature_Flags' => 'WPDO_Feature_Flags', 'TMDO_Feature_Flags' => 'WPDO_Feature_Flags',
'TMDO_DB' => 'WPDO_DB', 'TMDO_DB' => 'WPDO_DB',
'TMDO_Crypto' => 'WPDO_Crypto', 'TMDO_Crypto' => 'WPDO_Crypto',
'TMDO_Logger' => 'WPDO_Logger', 'TMDO_Logger' => 'WPDO_Logger',
'TMDO_Capability' => 'WPDO_Capability', 'TMDO_Capability' => 'WPDO_Capability',
'TMDO_Safe_Unserialize' => 'WPDO_Safe_Unserialize', 'TMDO_Safe_Unserialize' => 'WPDO_Safe_Unserialize',
// Engine / Migration / Adapters（second-tier，部分 sister plugin 已直接呼叫） // Engine / Migration / Adapters（second-tier，部分 sister plugin 已直接呼叫）
'TMDO_Hook_Bus' => 'WPDO_Hook_Bus', 'TMDO_Hook_Bus' => 'WPDO_Hook_Bus',
'TMDO_Mode_Manager' => 'WPDO_Mode_Manager', 'TMDO_Mode_Manager' => 'WPDO_Mode_Manager',
'TMDO_Migration_Engine' => 'WPDO_Migration_Engine', 'TMDO_Migration_Engine' => 'WPDO_Migration_Engine',
'TMDO_Migration_Orchestrator' => 'WPDO_Migration_Orchestrator', 'TMDO_Migration_Orchestrator' => 'WPDO_Migration_Orchestrator',
'TMDO_Entity_Migration_Engine' => 'WPDO_Entity_Migration_Engine', 'TMDO_Entity_Migration_Engine' => 'WPDO_Entity_Migration_Engine',
'TMDO_Entity_Health' => 'WPDO_Entity_Health', 'TMDO_Entity_Health' => 'WPDO_Entity_Health',
'TMDO_Schema_Manager' => 'WPDO_Schema_Manager', 'TMDO_Schema_Manager' => 'WPDO_Schema_Manager',
'TMDO_Sync_Bridge' => 'WPDO_Sync_Bridge', 'TMDO_Sync_Bridge' => 'WPDO_Sync_Bridge',
'TMDO_Query_Router' => 'WPDO_Query_Router', 'TMDO_Query_Router' => 'WPDO_Query_Router',
'TMDO_Post_Query_Router' => 'WPDO_Post_Query_Router', 'TMDO_Post_Query_Router' => 'WPDO_Post_Query_Router',
'TMDO_Hook_Bus_Bridge' => 'WPDO_Hook_Bus_Bridge', 'TMDO_Hook_Bus_Bridge' => 'WPDO_Hook_Bus_Bridge',
'TMDO_Conflict_Monitor' => 'WPDO_Conflict_Monitor', 'TMDO_Conflict_Monitor' => 'WPDO_Conflict_Monitor',
'TMDO_Compatibility' => 'WPDO_Compatibility', 'TMDO_Compatibility' => 'WPDO_Compatibility',
'TMDO_Installer' => 'WPDO_Installer', 'TMDO_Installer' => 'WPDO_Installer',
'TMDO_Cache_Layer' => 'WPDO_Cache_Layer', 'TMDO_Cache_Layer' => 'WPDO_Cache_Layer',
'TMDO_Zone_Classifier' => 'WPDO_Zone_Classifier', 'TMDO_Zone_Classifier' => 'WPDO_Zone_Classifier',
'TMDO_Core' => 'WPDO_Core', 'TMDO_Core' => 'WPDO_Core',
'TMDO_REST_API' => 'WPDO_REST_API', 'TMDO_REST_API' => 'WPDO_REST_API',
'TMDO_Snapshot_Manager' => 'WPDO_Snapshot_Manager', 'TMDO_Snapshot_Manager' => 'WPDO_Snapshot_Manager',
'TMDO_Snapshot_Writer' => 'WPDO_Snapshot_Writer', 'TMDO_Snapshot_Writer' => 'WPDO_Snapshot_Writer',
'TMDO_Snapshot_Reader' => 'WPDO_Snapshot_Reader', 'TMDO_Snapshot_Reader' => 'WPDO_Snapshot_Reader',
'TMDO_Snapshot_Pruner' => 'WPDO_Snapshot_Pruner', 'TMDO_Snapshot_Pruner' => 'WPDO_Snapshot_Pruner',
'TMDO_FSM_Guard' => 'WPDO_FSM_Guard', 'TMDO_FSM_Guard' => 'WPDO_FSM_Guard',
'TMDO_Site_Health' => 'WPDO_Site_Health', 'TMDO_Site_Health' => 'WPDO_Site_Health',
'TMDO_Health_Cron' => 'WPDO_Health_Cron', 'TMDO_Health_Cron' => 'WPDO_Health_Cron',
'TMDO_Email_Notifier' => 'WPDO_Email_Notifier', 'TMDO_Email_Notifier' => 'WPDO_Email_Notifier',
'TMDO_Slack_Notifier' => 'WPDO_Slack_Notifier', 'TMDO_Slack_Notifier' => 'WPDO_Slack_Notifier',
'TMDO_Discord_Notifier' => 'WPDO_Discord_Notifier', 'TMDO_Discord_Notifier' => 'WPDO_Discord_Notifier',
'TMDO_Telegram_Notifier' => 'WPDO_Telegram_Notifier', 'TMDO_Telegram_Notifier' => 'WPDO_Telegram_Notifier',
'TMDO_Monthly_Summary' => 'WPDO_Monthly_Summary', 'TMDO_Monthly_Summary' => 'WPDO_Monthly_Summary',
'TMDO_Site_Metrics_Collector' => 'WPDO_Site_Metrics_Collector', 'TMDO_Site_Metrics_Collector' => 'WPDO_Site_Metrics_Collector',
'TMDO_FSM_Advisor' => 'WPDO_FSM_Advisor', 'TMDO_FSM_Advisor' => 'WPDO_FSM_Advisor',
'TMDO_Module_Detector' => 'WPDO_Module_Detector', 'TMDO_Module_Detector' => 'WPDO_Module_Detector',
'TMDO_FSM_Automator' => 'WPDO_FSM_Automator', 'TMDO_FSM_Automator' => 'WPDO_FSM_Automator',
'TMDO_Module_Rules' => 'WPDO_Module_Rules', 'TMDO_Module_Rules' => 'WPDO_Module_Rules',
'TMDO_CSV_Writer' => 'WPDO_CSV_Writer', 'TMDO_CSV_Writer' => 'WPDO_CSV_Writer',
'TMDO_Export' => 'WPDO_Export', 'TMDO_Export' => 'WPDO_Export',
'TMDO_CLI' => 'WPDO_CLI', 'TMDO_CLI' => 'WPDO_CLI',
'TMDO_CLI_V2' => 'WPDO_CLI_V2', 'TMDO_CLI_V2' => 'WPDO_CLI_V2',
'TMDO_CLI_Member' => 'WPDO_CLI_Member', 'TMDO_CLI_Member' => 'WPDO_CLI_Member',
'TMDO_CLI_Post' => 'WPDO_CLI_Post', 'TMDO_CLI_Post' => 'WPDO_CLI_Post',
'TMDO_CLI_Term_Comment' => 'WPDO_CLI_Term_Comment', 'TMDO_CLI_Term_Comment' => 'WPDO_CLI_Term_Comment',
'TMDO_Member_Fields' => 'WPDO_Member_Fields', 'TMDO_Member_Fields' => 'WPDO_Member_Fields',
'TMDO_Post_Fields' => 'WPDO_Post_Fields', 'TMDO_Post_Fields' => 'WPDO_Post_Fields',
'TMDO_Points_Manager' => 'WPDO_Points_Manager', 'TMDO_Points_Manager' => 'WPDO_Points_Manager',
'TMDO_Demo_Entity_Counter' => 'WPDO_Demo_Entity_Counter', 'TMDO_Demo_Entity_Counter' => 'WPDO_Demo_Entity_Counter',
'TMDO_Postmeta_Cleaner' => 'WPDO_Postmeta_Cleaner', 'TMDO_Postmeta_Cleaner' => 'WPDO_Postmeta_Cleaner',
'TMDO_Termmeta_Cleaner' => 'WPDO_Termmeta_Cleaner', 'TMDO_Termmeta_Cleaner' => 'WPDO_Termmeta_Cleaner',
'TMDO_Commentmeta_Cleaner' => 'WPDO_Commentmeta_Cleaner', 'TMDO_Commentmeta_Cleaner' => 'WPDO_Commentmeta_Cleaner',
'TMDO_Post_Stress_Tester' => 'WPDO_Post_Stress_Tester', 'TMDO_Post_Stress_Tester' => 'WPDO_Post_Stress_Tester',
'TMDO_User_Stress_Tester' => 'WPDO_User_Stress_Tester', 'TMDO_User_Stress_Tester' => 'WPDO_User_Stress_Tester',
'TMDO_Term_Stress_Tester' => 'WPDO_Term_Stress_Tester', 'TMDO_Term_Stress_Tester' => 'WPDO_Term_Stress_Tester',
'TMDO_Comment_Stress_Tester' => 'WPDO_Comment_Stress_Tester', 'TMDO_Comment_Stress_Tester' => 'WPDO_Comment_Stress_Tester',
'TMDO_Post_Shadow_Verifier' => 'WPDO_Post_Shadow_Verifier', 'TMDO_Post_Shadow_Verifier' => 'WPDO_Post_Shadow_Verifier',
'TMDO_Term_Comment_Shadow_Verifier' => 'WPDO_Term_Comment_Shadow_Verifier', 'TMDO_Term_Comment_Shadow_Verifier' => 'WPDO_Term_Comment_Shadow_Verifier',
'TMDO_Term_Comment_Backfill' => 'WPDO_Term_Comment_Backfill', 'TMDO_Term_Comment_Backfill' => 'WPDO_Term_Comment_Backfill',
'TMDO_Term_Comment_Misc_Bucket' => 'WPDO_Term_Comment_Misc_Bucket', 'TMDO_Term_Comment_Misc_Bucket' => 'WPDO_Term_Comment_Misc_Bucket',
'TMDO_Term_Comment_Garbage_Filter' => 'WPDO_Term_Comment_Garbage_Filter', 'TMDO_Term_Comment_Garbage_Filter' => 'WPDO_Term_Comment_Garbage_Filter',
'TMDO_Setup_Wizard' => 'WPDO_Setup_Wizard', 'TMDO_Setup_Wizard' => 'WPDO_Setup_Wizard',
'TMDO_Dashboard_Widget' => 'WPDO_Dashboard_Widget', 'TMDO_Dashboard_Widget' => 'WPDO_Dashboard_Widget',
'TMDO_Help_Tabs' => 'WPDO_Help_Tabs', 'TMDO_Help_Tabs' => 'WPDO_Help_Tabs',
'TMDO_Admin' => 'WPDO_Admin', 'TMDO_Admin' => 'WPDO_Admin',
'TMDO_V2_Upgrader' => 'WPDO_V2_Upgrader', 'TMDO_V2_Upgrader' => 'WPDO_V2_Upgrader',
'TMDO_SQLite_Compat' => 'WPDO_SQLite_Compat', 'TMDO_SQLite_Compat' => 'WPDO_SQLite_Compat',
'TMDO_Type_Caster' => 'WPDO_Type_Caster', 'TMDO_Type_Caster' => 'WPDO_Type_Caster',
'TMDO_Audit_Logger' => 'WPDO_Audit_Logger', 'TMDO_Audit_Logger' => 'WPDO_Audit_Logger',
'TMDO_Shadow_Diff_Logger' => 'WPDO_Shadow_Diff_Logger', 'TMDO_Shadow_Diff_Logger' => 'WPDO_Shadow_Diff_Logger',
'TMDO_Conflict_Detector' => 'WPDO_Conflict_Detector', 'TMDO_Conflict_Detector' => 'WPDO_Conflict_Detector',
'TMDO_Cache_Orchestrator' => 'WPDO_Cache_Orchestrator', 'TMDO_Cache_Orchestrator' => 'WPDO_Cache_Orchestrator',
'TMDO_Query_Compiler' => 'WPDO_Query_Compiler', 'TMDO_Query_Compiler' => 'WPDO_Query_Compiler',
'TMDO_Auto_Promoter' => 'WPDO_Auto_Promoter', 'TMDO_Auto_Promoter' => 'WPDO_Auto_Promoter',
'TMDO_Adapter_Post' => 'WPDO_Adapter_Post', 'TMDO_Adapter_Post' => 'WPDO_Adapter_Post',
'TMDO_Adapter_User' => 'WPDO_Adapter_User', 'TMDO_Adapter_User' => 'WPDO_Adapter_User',
'TMDO_Adapter_Term' => 'WPDO_Adapter_Term', 'TMDO_Adapter_Term' => 'WPDO_Adapter_Term',
'TMDO_Adapter_Comment' => 'WPDO_Adapter_Comment', 'TMDO_Adapter_Comment' => 'WPDO_Adapter_Comment',
'TMDO_Options_Manager' => 'WPDO_Options_Manager', 'TMDO_Options_Manager' => 'WPDO_Options_Manager',
'TMDO_Hot_Migration' => 'WPDO_Hot_Migration', 'TMDO_Hot_Migration' => 'WPDO_Hot_Migration',
'TMDO_Warm_Migration' => 'WPDO_Warm_Migration', 'TMDO_Warm_Migration' => 'WPDO_Warm_Migration',
'TMDO_Cold_Migration' => 'WPDO_Cold_Migration', 'TMDO_Cold_Migration' => 'WPDO_Cold_Migration',
'TMDO_Archive_Migration' => 'WPDO_Archive_Migration', 'TMDO_Archive_Migration' => 'WPDO_Archive_Migration',
'TMDO_Migration_Base' => 'WPDO_Migration_Base', 'TMDO_Migration_Base' => 'WPDO_Migration_Base',
'TMDO_Post_Migration' => 'WPDO_Post_Migration', 'TMDO_Post_Migration' => 'WPDO_Post_Migration',
'TMDO_Zone_Hot' => 'WPDO_Zone_Hot', 'TMDO_Zone_Hot' => 'WPDO_Zone_Hot',
'TMDO_Zone_Warm' => 'WPDO_Zone_Warm', 'TMDO_Zone_Warm' => 'WPDO_Zone_Warm',
'TMDO_Zone_Cold' => 'WPDO_Zone_Cold', 'TMDO_Zone_Cold' => 'WPDO_Zone_Cold',
'TMDO_Zone_Router' => 'WPDO_Zone_Router', 'TMDO_Zone_Router' => 'WPDO_Zone_Router',
'TMDO_Routing_Predicate' => 'WPDO_Routing_Predicate', 'TMDO_Routing_Predicate' => 'WPDO_Routing_Predicate',
'TMDO_Migration_Phase_Base' => 'WPDO_Migration_Phase_Base', 'TMDO_Migration_Phase_Base' => 'WPDO_Migration_Phase_Base',
'TMDO_Phase_Diagnose' => 'WPDO_Phase_Diagnose', 'TMDO_Phase_Diagnose' => 'WPDO_Phase_Diagnose',
'TMDO_Phase_Backup' => 'WPDO_Phase_Backup', 'TMDO_Phase_Backup' => 'WPDO_Phase_Backup',
'TMDO_Phase_Demote' => 'WPDO_Phase_Demote', 'TMDO_Phase_Demote' => 'WPDO_Phase_Demote',
'TMDO_Phase_Install_Schema' => 'WPDO_Phase_Install_Schema', 'TMDO_Phase_Install_Schema' => 'WPDO_Phase_Install_Schema',
'TMDO_Phase_Backfill_Bulk' => 'WPDO_Phase_Backfill_Bulk', 'TMDO_Phase_Backfill_Bulk' => 'WPDO_Phase_Backfill_Bulk',
'TMDO_Phase_Backfill_Unserialize' => 'WPDO_Phase_Backfill_Unserialize', 'TMDO_Phase_Backfill_Unserialize' => 'WPDO_Phase_Backfill_Unserialize',
'TMDO_Phase_Promote_Shadow' => 'WPDO_Phase_Promote_Shadow', 'TMDO_Phase_Promote_Shadow' => 'WPDO_Phase_Promote_Shadow',
'TMDO_Phase_Verify_Sample' => 'WPDO_Phase_Verify_Sample', 'TMDO_Phase_Verify_Sample' => 'WPDO_Phase_Verify_Sample',
'TMDO_Phase_Promote_Aeav' => 'WPDO_Phase_Promote_Aeav', 'TMDO_Phase_Promote_Aeav' => 'WPDO_Phase_Promote_Aeav',
'TMDO_Phase_Cleanup' => 'WPDO_Phase_Cleanup', 'TMDO_Phase_Cleanup' => 'WPDO_Phase_Cleanup',
'TMDO_Phase_Completed' => 'WPDO_Phase_Completed', 'TMDO_Phase_Completed' => 'WPDO_Phase_Completed',
'TMDO_Zone_Archive' => 'WPDO_Zone_Archive', 'TMDO_Zone_Archive' => 'WPDO_Zone_Archive',
'TMDO_Interceptor_Base' => 'WPDO_Interceptor_Base', 'TMDO_Interceptor_Base' => 'WPDO_Interceptor_Base',
'TMDO_Standard_Post_Interceptor' => 'WPDO_Standard_Post_Interceptor', 'TMDO_Standard_Post_Interceptor' => 'WPDO_Standard_Post_Interceptor',
'TMDO_Query_Interceptor_Base' => 'WPDO_Query_Interceptor_Base', 'TMDO_Query_Interceptor_Base' => 'WPDO_Query_Interceptor_Base',
'TMDO_Abstract_Notifier' => 'WPDO_Abstract_Notifier', 'TMDO_Abstract_Notifier' => 'WPDO_Abstract_Notifier',
); );
foreach ( $tmdo_class_aliases as $tmdo_class => $wpdo_alias ) { foreach ( $tmdo_class_aliases as $tmdo_class => $wpdo_alias ) {
includes/class-tmdo-comment-stress-tester.php
+4 -3
View File
@@ -1,7 +1,4 @@
<?php <?php
declare(strict_types=1);
// phpcs:ignore WPDO.AntiEAV -- platform stress tester: intentional raw meta SQL for baseline comparison
/** /**
* TMDO_Comment_Stress_Tester — Async stress fixture generator for comment entity (v2.13.1). * TMDO_Comment_Stress_Tester — Async stress fixture generator for comment entity (v2.13.1).
* *
@@ -23,6 +20,10 @@ declare(strict_types=1);
* @since 2.13.1 * @since 2.13.1
*/ */
// phpcs:ignore WPDO.AntiEAV -- platform stress tester: intentional raw meta SQL for baseline comparison
declare(strict_types=1);
if ( ! defined( 'ABSPATH' ) ) { if ( ! defined( 'ABSPATH' ) ) {
exit; exit;
} }
includes/class-tmdo-post-shadow-verifier.php
+4 -3
View File
@@ -1,7 +1,4 @@
<?php <?php
declare(strict_types=1);
// phpcs:ignore WPDO.AntiEAV -- platform shadow verifier: must read raw meta to verify zone correctness
/** /**
* TMDO_Post_Shadow_Verifier — Sample-and-compare flat vs wp_postmeta (v2.10.3). * TMDO_Post_Shadow_Verifier — Sample-and-compare flat vs wp_postmeta (v2.10.3).
* *
@@ -24,6 +21,10 @@ declare(strict_types=1);
* @since 2.10.3 * @since 2.10.3
*/ */
// phpcs:ignore WPDO.AntiEAV -- platform shadow verifier: must read raw meta to verify zone correctness
declare(strict_types=1);
if ( ! defined( 'ABSPATH' ) ) { if ( ! defined( 'ABSPATH' ) ) {
exit; exit;
} }
includes/class-tmdo-post-stress-tester.php
+4 -3
View File
@@ -1,7 +1,4 @@
<?php <?php
declare(strict_types=1);
// phpcs:ignore WPDO.AntiEAV -- platform stress tester: intentional raw meta SQL for baseline comparison
/** /**
* TMDO_Post_Stress_Tester — Bulk fixture generator for post entity migration (v2.9.4). * TMDO_Post_Stress_Tester — Bulk fixture generator for post entity migration (v2.9.4).
* *
@@ -28,6 +25,10 @@ declare(strict_types=1);
* @since 2.9.4 * @since 2.9.4
*/ */
// phpcs:ignore WPDO.AntiEAV -- platform stress tester: intentional raw meta SQL for baseline comparison
declare(strict_types=1);
if ( ! defined( 'ABSPATH' ) ) { if ( ! defined( 'ABSPATH' ) ) {
exit; exit;
} }
includes/class-tmdo-term-stress-tester.php
+4 -3
View File
@@ -1,7 +1,4 @@
<?php <?php
declare(strict_types=1);
// phpcs:ignore WPDO.AntiEAV -- platform stress tester: intentional raw meta SQL for baseline comparison
/** /**
* TMDO_Term_Stress_Tester — Async stress fixture generator for term entity (v2.13.0). * TMDO_Term_Stress_Tester — Async stress fixture generator for term entity (v2.13.0).
* *
@@ -24,6 +21,10 @@ declare(strict_types=1);
* @since 2.13.0 * @since 2.13.0
*/ */
// phpcs:ignore WPDO.AntiEAV -- platform stress tester: intentional raw meta SQL for baseline comparison
declare(strict_types=1);
if ( ! defined( 'ABSPATH' ) ) { if ( ! defined( 'ABSPATH' ) ) {
exit; exit;
} }
includes/class-tmdo-user-stress-tester.php
+4 -3
View File
@@ -1,7 +1,4 @@
<?php <?php
declare(strict_types=1);
// phpcs:ignore WPDO.AntiEAV -- platform stress tester: intentional raw meta SQL for baseline comparison
/** /**
* TMDO_User_Stress_Tester — User entity 壓力測試 / Benchmark 工具 * TMDO_User_Stress_Tester — User entity 壓力測試 / Benchmark 工具
* *
@@ -18,6 +15,10 @@ declare(strict_types=1);
* @since 2.6.7 * @since 2.6.7
*/ */
// phpcs:ignore WPDO.AntiEAV -- platform stress tester: intentional raw meta SQL for baseline comparison
declare(strict_types=1);
// phpcs:disable Squiz.Commenting,Generic.Commenting,WordPress.DB.PreparedSQL.NotPrepared,WordPress.DB.PreparedSQL.InterpolatedNotPrepared,WordPress.DB.PreparedSQLPlaceholders.ReplacementsWrongNumber,WordPress.DB.PreparedSQLPlaceholders.UnfinishedPrepare,Generic.CodeAnalysis.UnusedFunctionParameter,WordPress.WP.I18n.MissingTranslatorsComment,WordPress.PHP.NoSilencedErrors,WordPress.PHP.YodaConditions,WordPress.WP.AlternativeFunctions.rand_mt_rand,WordPress.PHP.DiscouragedPHPFunctions.serialize_serialize -- 測試工具：mt_rand 用於杜撰測試資料；serialize() 為 WP capabilities 標準格式 // phpcs:disable Squiz.Commenting,Generic.Commenting,WordPress.DB.PreparedSQL.NotPrepared,WordPress.DB.PreparedSQL.InterpolatedNotPrepared,WordPress.DB.PreparedSQLPlaceholders.ReplacementsWrongNumber,WordPress.DB.PreparedSQLPlaceholders.UnfinishedPrepare,Generic.CodeAnalysis.UnusedFunctionParameter,WordPress.WP.I18n.MissingTranslatorsComment,WordPress.PHP.NoSilencedErrors,WordPress.PHP.YodaConditions,WordPress.WP.AlternativeFunctions.rand_mt_rand,WordPress.PHP.DiscouragedPHPFunctions.serialize_serialize -- 測試工具：mt_rand 用於杜撰測試資料；serialize() 為 WP capabilities 標準格式
defined( 'ABSPATH' ) || exit; defined( 'ABSPATH' ) || exit;
includes/diagnostic/class-tmdo-site-health.php
+4 -3
View File
@@ -1,7 +1,4 @@
<?php <?php
declare(strict_types=1);
// phpcs:ignore WPDO.AntiEAV -- platform diagnostic: raw meta inspection for site health
/** /**
* TMDO_Site_Health — WordPress Site Health integration (v2.2.0 M3). * TMDO_Site_Health — WordPress Site Health integration (v2.2.0 M3).
* *
@@ -19,6 +16,10 @@ declare(strict_types=1);
* @package WP_Data_Optimizer * @package WP_Data_Optimizer
*/ */
// phpcs:ignore WPDO.AntiEAV -- platform diagnostic: raw meta inspection for site health
declare(strict_types=1);
if ( ! defined( 'ABSPATH' ) ) { if ( ! defined( 'ABSPATH' ) ) {
exit; exit;
} }
includes/migration/class-tmdo-post-migration.php
+4 -3
View File
@@ -1,7 +1,4 @@
<?php <?php
declare(strict_types=1);
// phpcs:ignore WPDO.AntiEAV -- platform migration tool: WPDO v1->v2 legacy post meta migration
/** /**
* TMDO_Post_Migration — Post entity migration core (v2.9.3). * TMDO_Post_Migration — Post entity migration core (v2.9.3).
* *
@@ -35,6 +32,10 @@ declare(strict_types=1);
* @since 2.9.3 * @since 2.9.3
*/ */
// phpcs:ignore WPDO.AntiEAV -- platform migration tool: WPDO v1->v2 legacy post meta migration
declare(strict_types=1);
if ( ! defined( 'ABSPATH' ) ) { if ( ! defined( 'ABSPATH' ) ) {
exit; exit;
} }
includes/trait-tmdo-anti-eav-aware.php
+175 -175
View File
@@ -31,183 +31,183 @@ if ( ! defined( 'ABSPATH' ) ) {
// the same trait body in memory. // the same trait body in memory.
if ( ! trait_exists( 'TMDO_Anti_EAV_Aware' ) ) { if ( ! trait_exists( 'TMDO_Anti_EAV_Aware' ) ) {
trait TMDO_Anti_EAV_Aware { trait TMDO_Anti_EAV_Aware {
/** /**
* Plugin slug used as provider identifier when registering fields/tables. * Plugin slug used as provider identifier when registering fields/tables.
* *
* Partner plugins SHOULD override this with their canonical slug * Partner plugins SHOULD override this with their canonical slug
* (e.g. 'tmos-core', 'tmos-events'). Default returns lowercased class name * (e.g. 'tmos-core', 'tmos-events'). Default returns lowercased class name
* for backward compatibility with older partner plugins that didn't define * for backward compatibility with older partner plugins that didn't define
* a slug. * a slug.
*/ */
protected function plugin_slug(): string { protected function plugin_slug(): string {
return strtolower( static::class ); return strtolower( static::class );
} }
/** /**
* Attach the three `wpdo_register_*` hooks to the corresponding * Attach the three `wpdo_register_*` hooks to the corresponding
* `on_register_*` methods. Call once during plugin boot. * `on_register_*` methods. Call once during plugin boot.
* *
* Idempotent — safe to call multiple times because WP de-dupes * Idempotent — safe to call multiple times because WP de-dupes
* identical (action, callback) pairs. * identical (action, callback) pairs.
*/ */
protected function bind_anti_eav_hooks(): void { protected function bind_anti_eav_hooks(): void {
add_action( 'wpdo_register_fields', array( $this, 'on_register_fields' ), 10, 1 ); add_action( 'wpdo_register_fields', array( $this, 'on_register_fields' ), 10, 1 );
add_action( 'wpdo_register_custom_tables', array( $this, 'on_register_custom_tables' ), 10, 1 ); add_action( 'wpdo_register_custom_tables', array( $this, 'on_register_custom_tables' ), 10, 1 );
add_action( 'wpdo_register_entity_fields', array( $this, 'on_register_entity_fields' ), 10, 0 ); add_action( 'wpdo_register_entity_fields', array( $this, 'on_register_entity_fields' ), 10, 0 );
} }
// ── Hook handlers (override in subclass) ───────────────────────────────── // ── Hook handlers (override in subclass) ─────────────────────────────────
/** /**
* Register hot/warm/cold/archive zone field mappings. * Register hot/warm/cold/archive zone field mappings.
* *
* Override in subclass and call `$this->register_field( $registry, [...] )` * Override in subclass and call `$this->register_field( $registry, [...] )`
* for each post-meta key the plugin manages. * for each post-meta key the plugin manages.
* *
* @param TMDO_Schema_Registry $registry The shared field registry. * @param TMDO_Schema_Registry $registry The shared field registry.
*/ */
public function on_register_fields( TMDO_Schema_Registry $registry ): void { public function on_register_fields( TMDO_Schema_Registry $registry ): void {
// Default no-op. Override in subclass. // Default no-op. Override in subclass.
} }
/** /**
* Register custom tables owned by this plugin. * Register custom tables owned by this plugin.
* *
* Override in subclass and call `$this->register_custom_table( $r, [...] )` * Override in subclass and call `$this->register_custom_table( $r, [...] )`
* for each table. * for each table.
* *
* @param TMDO_Custom_Table_Registry $r The shared custom-table registry. * @param TMDO_Custom_Table_Registry $r The shared custom-table registry.
*/ */
public function on_register_custom_tables( TMDO_Custom_Table_Registry $r ): void { public function on_register_custom_tables( TMDO_Custom_Table_Registry $r ): void {
// Default no-op. Override in subclass. // Default no-op. Override in subclass.
} }
/** /**
* Register entity field groups (user / term / comment / post metadata). * Register entity field groups (user / term / comment / post metadata).
* *
* Override in subclass and call `$this->register_entity_fields( $type, $group, [...] )` * Override in subclass and call `$this->register_entity_fields( $type, $group, [...] )`
* for each logical field group the plugin contributes. * for each logical field group the plugin contributes.
*/ */
public function on_register_entity_fields(): void { public function on_register_entity_fields(): void {
// Default no-op. Override in subclass. // Default no-op. Override in subclass.
} }
// ── Sugar wrappers around WPDO public API ──────────────────────────────── // ── Sugar wrappers around WPDO public API ────────────────────────────────
/** /**
* Register a single zone field via TMDO_Schema_Registry. * Register a single zone field via TMDO_Schema_Registry.
* *
* @param TMDO_Schema_Registry $registry Provided by the `wpdo_register_fields` hook. * @param TMDO_Schema_Registry $registry Provided by the `wpdo_register_fields` hook.
* @param array<string,mixed> $field_def Field definition (post_type, meta_key, zone, ...). * @param array<string,mixed> $field_def Field definition (post_type, meta_key, zone, ...).
*/ */
protected function register_field( TMDO_Schema_Registry $registry, array $field_def ): void { protected function register_field( TMDO_Schema_Registry $registry, array $field_def ): void {
$registry->register( $this->plugin_slug(), $field_def ); $registry->register( $this->plugin_slug(), $field_def );
} }
/** /**
* Register a custom table via TMDO_Custom_Table_Registry. * Register a custom table via TMDO_Custom_Table_Registry.
* *
* @param TMDO_Custom_Table_Registry $r Provided by the `wpdo_register_custom_tables` hook. * @param TMDO_Custom_Table_Registry $r Provided by the `wpdo_register_custom_tables` hook.
* @param array<string,mixed> $table_def Table definition (table_name, primary_key, expected_columns, indexes, ...). * @param array<string,mixed> $table_def Table definition (table_name, primary_key, expected_columns, indexes, ...).
*/ */
protected function register_custom_table( TMDO_Custom_Table_Registry $r, array $table_def ): void { protected function register_custom_table( TMDO_Custom_Table_Registry $r, array $table_def ): void {
$r->register( $this->plugin_slug(), $table_def ); $r->register( $this->plugin_slug(), $table_def );
} }
/** /**
* Register an entity field group via TMDO_Entity_Registry. * Register an entity field group via TMDO_Entity_Registry.
* *
* @param string $entity_type 'post' | 'user' | 'term' | 'comment'. * @param string $entity_type 'post' | 'user' | 'term' | 'comment'.
* @param string $group_name Logical group name (e.g. 'tmos_vendor', 'tmos_audience'). * @param string $group_name Logical group name (e.g. 'tmos_vendor', 'tmos_audience').
* @param array<int,array<string,mixed>> $fields Field definitions. * @param array<int,array<string,mixed>> $fields Field definitions.
*/ */
protected function register_entity_fields( string $entity_type, string $group_name, array $fields ): bool { protected function register_entity_fields( string $entity_type, string $group_name, array $fields ): bool {
if ( ! class_exists( 'TMDO_Entity_Registry' ) ) { if ( ! class_exists( 'TMDO_Entity_Registry' ) ) {
return false; return false;
}
return TMDO_Entity_Registry::register_group( $entity_type, $group_name, $fields );
}
// ── Read/write convenience wrappers ──────────────────────────────────────
/**
* Read an entity field via the TMDO_API facade.
*
* @param string $entity_type 'post' | 'user' | 'term' | 'comment'.
* @param int $entity_id Entity primary id.
* @param string $key Meta key.
* @param bool $single Return single value (default true).
*/
protected function get_field( string $entity_type, int $entity_id, string $key, bool $single = true ): mixed {
return TMDO_API::get_entity( $entity_type, $entity_id, $key, $single );
}
/**
* Write an entity field via the TMDO_API facade.
*
* @param string $entity_type 'post' | 'user' | 'term' | 'comment'.
* @param int $entity_id Entity primary id.
* @param string $key Meta key.
* @param mixed $value Meta value.
*
* @return bool|int False on failure, otherwise the meta id (add) or true (update).
*/
protected function set_field( string $entity_type, int $entity_id, string $key, mixed $value ): bool|int {
return TMDO_API::set_entity( $entity_type, $entity_id, $key, $value );
}
/**
* Subscribe to write events on a specific meta key.
*
* Convenience wrapper around `add_action('wpdo_after_write', ...)` that
* filters callbacks to the plugin's own keys via prefix match.
*
* @param string $key_prefix Meta-key prefix to react on (e.g. 'tmos_vendor_').
* @param callable $callback `function(string $entity_type, int $entity_id, string $key, mixed $value, bool $ok, string $op, mixed $before)`.
* @param int $priority WordPress action priority (default 10).
*/
protected function on_after_write( string $key_prefix, callable $callback, int $priority = 10 ): void {
add_action(
'wpdo_after_write',
static function ( $entity_type, $entity_id, $meta_key, $meta_value, $ok, $op, $before ) use ( $key_prefix, $callback ): void {
if ( is_string( $meta_key ) && str_starts_with( $meta_key, $key_prefix ) ) {
$callback( $entity_type, $entity_id, $meta_key, $meta_value, $ok, $op, $before );
}
},
$priority,
7
);
}
// ── Backward-compat (legacy 2meet-* mu-plugin trait surface) ─────────────
// The pre-v2.17.0 mu-plugin trait stub exposed two abstract static methods
// (`register_wpdo_fields`, `register_custom_tables`). Older partner plugins
// (e.g. 2meet-inquiries) implemented those static methods. The promoted
// trait keeps the names with non-abstract no-op defaults so existing
// classes continue to work without modification.
/**
* Legacy entry point for plugins that registered fields via a static method
* before v2.17.0. New partner plugins should override `on_register_fields()`
* (instance method) instead.
*
* @deprecated 2.17.0 Use instance method `on_register_fields()` + `bind_anti_eav_hooks()` instead.
*/
public static function register_wpdo_fields(): void {
// No-op default. Legacy classes overrode this and called the registry directly.
}
/**
* Legacy entry point for plugins that registered custom tables via a static
* method before v2.17.0.
*
* @deprecated 2.17.0 Use instance method `on_register_custom_tables()` + `bind_anti_eav_hooks()` instead.
*/
public static function register_custom_tables(): void {
// No-op default.
} }
return TMDO_Entity_Registry::register_group( $entity_type, $group_name, $fields );
} }
// ── Read/write convenience wrappers ──────────────────────────────────────
/**
* Read an entity field via the TMDO_API facade.
*
* @param string $entity_type 'post' | 'user' | 'term' | 'comment'.
* @param int $entity_id Entity primary id.
* @param string $key Meta key.
* @param bool $single Return single value (default true).
*/
protected function get_field( string $entity_type, int $entity_id, string $key, bool $single = true ): mixed {
return TMDO_API::get_entity( $entity_type, $entity_id, $key, $single );
}
/**
* Write an entity field via the TMDO_API facade.
*
* @param string $entity_type 'post' | 'user' | 'term' | 'comment'.
* @param int $entity_id Entity primary id.
* @param string $key Meta key.
* @param mixed $value Meta value.
*
* @return bool|int False on failure, otherwise the meta id (add) or true (update).
*/
protected function set_field( string $entity_type, int $entity_id, string $key, mixed $value ): bool|int {
return TMDO_API::set_entity( $entity_type, $entity_id, $key, $value );
}
/**
* Subscribe to write events on a specific meta key.
*
* Convenience wrapper around `add_action('wpdo_after_write', ...)` that
* filters callbacks to the plugin's own keys via prefix match.
*
* @param string $key_prefix Meta-key prefix to react on (e.g. 'tmos_vendor_').
* @param callable $callback `function(string $entity_type, int $entity_id, string $key, mixed $value, bool $ok, string $op, mixed $before)`.
* @param int $priority WordPress action priority (default 10).
*/
protected function on_after_write( string $key_prefix, callable $callback, int $priority = 10 ): void {
add_action(
'wpdo_after_write',
static function ( $entity_type, $entity_id, $meta_key, $meta_value, $ok, $op, $before ) use ( $key_prefix, $callback ): void {
if ( is_string( $meta_key ) && str_starts_with( $meta_key, $key_prefix ) ) {
$callback( $entity_type, $entity_id, $meta_key, $meta_value, $ok, $op, $before );
}
},
$priority,
7
);
}
// ── Backward-compat (legacy 2meet-* mu-plugin trait surface) ─────────────
// The pre-v2.17.0 mu-plugin trait stub exposed two abstract static methods
// (`register_wpdo_fields`, `register_custom_tables`). Older partner plugins
// (e.g. 2meet-inquiries) implemented those static methods. The promoted
// trait keeps the names with non-abstract no-op defaults so existing
// classes continue to work without modification.
/**
* Legacy entry point for plugins that registered fields via a static method
* before v2.17.0. New partner plugins should override `on_register_fields()`
* (instance method) instead.
*
* @deprecated 2.17.0 Use instance method `on_register_fields()` + `bind_anti_eav_hooks()` instead.
*/
public static function register_wpdo_fields(): void {
// No-op default. Legacy classes overrode this and called the registry directly.
}
/**
* Legacy entry point for plugins that registered custom tables via a static
* method before v2.17.0.
*
* @deprecated 2.17.0 Use instance method `on_register_custom_tables()` + `bind_anti_eav_hooks()` instead.
*/
public static function register_custom_tables(): void {
// No-op default.
}
}
} // end if ( ! trait_exists ) } // end if ( ! trait_exists )
phpcs.xml
+245
View File
@@ -0,0 +1,245 @@
<?xml version="1.0"?>
<ruleset name="2meet Data Optimizer">
<description>WPCS ruleset for WP Data Optimizer plugin.</description>
<!-- Scan these files/directories -->
<file>.</file>
<!-- Exclude vendor and test directories -->
<exclude-pattern>*/vendor/*</exclude-pattern>
<exclude-pattern>*/tests/*</exclude-pattern>
<exclude-pattern>*/back-compat/*</exclude-pattern>
<exclude-pattern>*/node_modules/*</exclude-pattern>
<!-- v2.13.4: JS files are out of PHPCS scope (use ESLint instead) -->
<exclude-pattern>*/admin/assets/*.js</exclude-pattern>
<!-- Only lint PHP files -->
<arg name="extensions" value="php"/>
<!--
UAE-ported files: includes/adapters/ and includes/engine/ were ported wholesale
from UAE in PR-1. File-level phpcs:disable comments have been replaced with these
sniff-level directory exclusions. Auto-fixable violations (7) were fixed with phpcbf.
Rules already globally excluded (NotPrepared, NoSilencedErrors, file_get_contents,
UnusedFunctionParameter) are not repeated here.
-->
<!-- Doc-comment style sniffs: FunctionComment, ClassComment, InlineComment, etc. -->
<rule ref="Squiz.Commenting.FunctionComment">
<exclude-pattern>*/includes/adapters/*</exclude-pattern>
<exclude-pattern>*/includes/engine/*</exclude-pattern>
</rule>
<rule ref="Squiz.Commenting.ClassComment">
<exclude-pattern>*/includes/adapters/*</exclude-pattern>
<exclude-pattern>*/includes/engine/*</exclude-pattern>
</rule>
<rule ref="Squiz.Commenting.FileComment">
<exclude-pattern>*/includes/adapters/*</exclude-pattern>
<exclude-pattern>*/includes/engine/*</exclude-pattern>
</rule>
<rule ref="Squiz.Commenting.InlineComment">
<exclude-pattern>*/includes/adapters/*</exclude-pattern>
<exclude-pattern>*/includes/engine/*</exclude-pattern>
<!-- Comments in this codebase are predominantly Chinese; the sniff only
accepts . ! ? as terminators, so 。 always trips it. -->
<exclude name="Squiz.Commenting.InlineComment.InvalidEndChar"/>
</rule>
<!-- interface-entity-adapter.php declares the WPDO_ alias interface next to
the real one on purpose, so `instanceof WPDO_Entity_Adapter_Interface`
works for classes implementing the TMDO_ name. -->
<rule ref="Generic.Files.OneObjectStructurePerFile">
<exclude-pattern>*/includes/adapters/interface-entity-adapter.php</exclude-pattern>
<exclude-pattern>*/includes/back-compat/*</exclude-pattern>
</rule>
<rule ref="Squiz.Commenting.VariableComment">
<exclude-pattern>*/includes/adapters/*</exclude-pattern>
<exclude-pattern>*/includes/engine/*</exclude-pattern>
</rule>
<rule ref="Generic.Commenting.DocComment">
<exclude-pattern>*/includes/adapters/*</exclude-pattern>
<exclude-pattern>*/includes/engine/*</exclude-pattern>
</rule>
<!-- PHP style / structure sniffs -->
<rule ref="Squiz.PHP.DisallowMultipleAssignments">
<exclude-pattern>*/includes/adapters/*</exclude-pattern>
<exclude-pattern>*/includes/engine/*</exclude-pattern>
</rule>
<rule ref="Squiz.PHP.DisallowSizeFunctionsInLoops">
<exclude-pattern>*/includes/adapters/*</exclude-pattern>
<exclude-pattern>*/includes/engine/*</exclude-pattern>
</rule>
<rule ref="Squiz.PHP.CommentedOutCode">
<exclude-pattern>*/includes/adapters/*</exclude-pattern>
<exclude-pattern>*/includes/engine/*</exclude-pattern>
</rule>
<!-- WordPress-specific sniffs -->
<rule ref="WordPress.DB.PreparedSQL.InterpolatedNotPrepared">
<exclude-pattern>*/includes/adapters/*</exclude-pattern>
<exclude-pattern>*/includes/engine/*</exclude-pattern>
</rule>
<rule ref="WordPress.DB.PreparedSQLPlaceholders.ReplacementsWrongNumber">
<exclude-pattern>*/includes/adapters/*</exclude-pattern>
<exclude-pattern>*/includes/engine/*</exclude-pattern>
</rule>
<rule ref="WordPress.PHP.YodaConditions">
<exclude-pattern>*/includes/adapters/*</exclude-pattern>
<exclude-pattern>*/includes/engine/*</exclude-pattern>
</rule>
<rule ref="WordPress.WP.I18n.MissingTranslatorsComment">
<exclude-pattern>*/includes/adapters/*</exclude-pattern>
<exclude-pattern>*/includes/engine/*</exclude-pattern>
</rule>
<!-- Universal naming: avoids PHP reserved words as param names -->
<rule ref="Universal.NamingConventions.NoReservedKeywordParameterNames">
<exclude-pattern>*/includes/adapters/*</exclude-pattern>
<exclude-pattern>*/includes/engine/*</exclude-pattern>
</rule>
<!--
Migration phase objects: throw new \RuntimeException(...) is never echoed to
the browser — it is caught by WPDO_Migration_Orchestrator and turned into a
structured array. EscapeOutput fires on the raw string inside the throw expression.
-->
<rule ref="WordPress.Security.EscapeOutput">
<exclude-pattern>*/migration/phases/*</exclude-pattern>
</rule>
<!--
Migration phase SQL: table names come from WPDO_DB::table() / $wpdb core
properties and are sanitized by Schema_Manager::sanitize_column_name().
User-controlled values always go through $wpdb->prepare() placeholders.
-->
<rule ref="WordPress.DB.PreparedSQL.InterpolatedNotPrepared">
<exclude-pattern>*/migration/phases/*</exclude-pattern>
</rule>
<!--
WP-CLI callbacks must accept ($args, $assoc_args) by framework contract.
MissingParamTag fires when only one of the two is used.
ShortNotCapital fires on WP-CLI-style imperative command descriptions.
-->
<rule ref="Squiz.Commenting.FunctionComment.MissingParamTag">
<exclude-pattern>*/cli/*</exclude-pattern>
</rule>
<rule ref="Generic.Commenting.DocComment.ShortNotCapital">
<exclude-pattern>*/cli/*</exclude-pattern>
</rule>
<!-- Use WordPress Coding Standards -->
<rule ref="WordPress">
<!--
This plugin IS the database optimization layer.
Direct DB queries are intentional and by design.
-->
<exclude name="WordPress.DB.DirectDatabaseQuery.DirectQuery" />
<exclude name="WordPress.DB.DirectDatabaseQuery.NoCaching" />
<exclude name="WordPress.DB.DirectDatabaseQuery.SchemaChange" />
<!--
Slow DB queries (meta_key / meta_value) are intentional —
the plugin migrates data AWAY from these patterns.
-->
<exclude name="WordPress.DB.SlowDBQuery.slow_db_query_meta_key" />
<exclude name="WordPress.DB.SlowDBQuery.slow_db_query_meta_value" />
<!--
error_log() usage is intentional in WPDO_Logger for dev environments.
The production build suppresses it via feature flag.
-->
<exclude name="WordPress.PHP.DevelopmentFunctions.error_log_error_log" />
<!--
base64_encode/decode used for gzip archive compression in Zone D.
This is data storage, not obfuscation.
-->
<exclude name="WordPress.PHP.DiscouragedPHPFunctions.obfuscation_base64_encode" />
<exclude name="WordPress.PHP.DiscouragedPHPFunctions.obfuscation_base64_decode" />
<!-- rand() → wp_rand() not applicable for benchmark timing -->
<exclude name="WordPress.WP.AlternativeFunctions.rand_rand" />
<!--
Slash-separated hook names (wpdo/health_alert_critical, wpdo/fsm_guard/bypass, etc.)
are intentional — they follow the WP Core convention for scoped action namespaces
(e.g. 'customize_save_{$id}', 'heartbeat_received', 'rest_api_init').
Partner plugins subscribe to these hooks; renaming would be a breaking API change.
-->
<exclude name="WordPress.NamingConventions.ValidHookName.UseUnderscores" />
<!--
File system operations (fopen/fwrite/fclose/file_put_contents/file_get_contents/unlink)
are intentional in snapshot/backup code and CLI benchmark/export handlers.
WP_Filesystem is not available outside wp-admin context and introduces state
that complicates CLI and cron use-cases. The backup directory is created with
wp_mkdir_p and access-controlled via .htaccess / direct_filesystem fallback.
-->
<exclude name="WordPress.WP.AlternativeFunctions.file_system_operations_fopen" />
<exclude name="WordPress.WP.AlternativeFunctions.file_system_operations_fwrite" />
<exclude name="WordPress.WP.AlternativeFunctions.file_system_operations_fclose" />
<exclude name="WordPress.WP.AlternativeFunctions.file_system_operations_file_put_contents" />
<exclude name="WordPress.WP.AlternativeFunctions.file_get_contents_file_get_contents" />
<exclude name="WordPress.WP.AlternativeFunctions.unlink_unlink" />
<exclude name="WordPress.WP.AlternativeFunctions.file_system_operations_is_writable" />
<!--
manage_woocommerce is a standard WooCommerce capability, not a custom one.
WPCS cannot know third-party capabilities; this is a known false-positive.
-->
<exclude name="WordPress.WP.Capabilities.Unknown" />
<!--
REST API callbacks must accept WP_REST_Request $request even when not used
(e.g. /status endpoints). Removing the param breaks WP REST contract.
-->
<exclude name="Generic.CodeAnalysis.UnusedFunctionParameter.Found" />
<exclude name="Generic.CodeAnalysis.UnusedFunctionParameter.FoundAfterLastUsed" />
<!--
Snapshot / migration backup paths use @chmod on freshly-created files
inside admin-only context. Failure-to-chmod is non-fatal (we still
have .htaccess deny + dir-level guards) and surfacing the notice
would mask other diagnostics. Documented in
class-wpdo-migration-orchestrator.php / class-wpdo-snapshot-*.
-->
<exclude name="WordPress.PHP.NoSilencedErrors.Discouraged" />
<!--
chmod() / mkdir() / rename() / fseek() / etc are intentional in
snapshot/backup write paths. WP_Filesystem is unavailable outside
wp-admin context (we run in CLI + cron + admin) and introduces
unwanted state. The fopen/fwrite/file_put_contents/unlink rules
are already excluded above; chmod / mkdir need their own excludes.
-->
<exclude name="WordPress.WP.AlternativeFunctions.file_system_operations_chmod" />
<exclude name="WordPress.WP.AlternativeFunctions.file_system_operations_mkdir" />
<exclude name="WordPress.WP.AlternativeFunctions.rename_rename" />
<!--
Dynamic SQL with $wpdb->prepare() flagged "Replacement variables found,
but no valid placeholders found" when placeholders live in interpolated
sub-strings (e.g. table names from sanitize_key, IN-list expansion).
Each call site has phpcs:ignore comments documenting why; project-wide
silence avoids cluttering every call.
-->
<exclude name="WordPress.DB.PreparedSQL.NotPrepared" />
<exclude name="WordPress.DB.PreparedSQLPlaceholders.UnfinishedPrepare" />
</rule>
<!--
Slash-separated hook name delimiter (wpdo/zone/event pattern).
Redundant with the UseUnderscores exclude above, but belt-and-suspenders.
-->
<rule ref="WordPress.NamingConventions.ValidHookName">
<properties>
<property name="additionalWordDelimiters" value="/"/>
</properties>
</rule>
<!-- Allow short ternary (?:) — used extensively in this codebase -->
<rule ref="Universal.Operators.DisallowShortTernary">
<severity>0</severity>
</rule>
<!-- PHP minimum version -->
<config name="minimum_supported_wp_version" value="6.0" />
<config name="testVersion" value="8.1-" />
</ruleset>
phpstan-baseline.neon
+3691
View File
File diff suppressed because it is too large Load Diff
phpstan.neon
+29
View File
@@ -0,0 +1,29 @@
includes:
- vendor/szepeviktor/phpstan-wordpress/extension.neon
# Baseline: existing type-completeness debt (mostly missing iterable value
# types + WP template-scope variables). New code is checked clean at L6.
# Burn down incrementally; regenerate with `composer stan:baseline`.
- phpstan-baseline.neon
parameters:
level: 6
paths:
- includes
- admin
- cli
- modules
- 2meet-data-optimizer.php
- uninstall.php
bootstrapFiles:
# Plugin constants (define()'d at runtime; PHPStan can't see them).
- .phpstan/stubs.php
scanFiles:
# WP-CLI classes/functions (runtime-injected by wp-cli; use official stubs).
- vendor/php-stubs/wp-cli-stubs/wp-cli-stubs.php
excludePaths:
- vendor
- tests
- .phpstan
# interface wrappers: PHPStan sees WPDO_X extends TMDO_X as circular
- includes/back-compat
reportUnmatchedIgnoredErrors: false
treatPhpDocTypesAsCertain: false