2meet-data-optimizer/includes/adapters/class-tmdo-adapter-user.php

<?php
/**
 * TMDO_Adapter_User - User 實體適配器
 *
 * @package WP_Data_Optimizer
 */

declare(strict_types=1);

// 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;

final class TMDO_Adapter_User implements TMDO_Entity_Adapter_Interface {

	public function get_entity_type(): string {
		return 'user';
	}

	public function get_native_meta_table(): string {
		global $wpdb;
		return $wpdb->usermeta;
	}

	public function get_entity_id_column(): string {
		return 'user_id';
	}

	public function get_primary_table(): string {
		global $wpdb;
		return $wpdb->users;
	}

	public function get_primary_id_column(): string {
		return 'ID';
	}

	public function get_cache_group(): string {
		return 'wpdo_user_profile';
	}

	public function get_delete_hook(): string {
		return 'delete_user';
	}

	public function extend_native_query( $query_object ): void {
		if ( ! ( $query_object instanceof WP_User_Query ) ) {
			return;
		}

		$wpdo_query = $query_object->get( 'wpdo_meta_query' );
		if ( empty( $wpdo_query ) || ! is_array( $wpdo_query ) ) {
			return;
		}

		TMDO_Query_Compiler::inject_into_user_query( $query_object, $wpdo_query );
	}

	public function get_entity_ids_after( int $after_id, int $limit ): array {
		global $wpdb;

		return array_map(
			'intval',
			$wpdb->get_col(
				$wpdb->prepare(
					"SELECT ID FROM `{$wpdb->users}` WHERE ID > %d ORDER BY ID ASC LIMIT %d",
					$after_id,
					$limit
				)
			) ?: array()
		);
	}
}

// 註冊 pre_user_query(unit test 下 add_action 未載入時跳過)
if ( function_exists( 'add_action' ) ) {
	add_action(
		'pre_user_query',
		function ( $query ) {
			$adapter = TMDO_Entity_Registry::get_adapter( 'user' );
			if ( $adapter ) {
				$adapter->extend_native_query( $query );
			}
		},
		10,
		1
	);
}