+
+
+
+
diff --git a/src/class-database.php b/src/class-database.php
new file mode 100644
index 0000000..16c5793
--- /dev/null
+++ b/src/class-database.php
@@ -0,0 +1,281 @@
+prefix . self::TABLE_NAME;
+ }
+
+ /**
+ * Create the custom table.
+ *
+ * @return void
+ */
+ public static function create_table() {
+ global $wpdb;
+
+ $table_name = self::get_table_name();
+ $charset_collate = $wpdb->get_charset_collate();
+
+ $sql = "CREATE TABLE {$table_name} (
+ option_name VARCHAR(191) NOT NULL,
+ access_count BIGINT UNSIGNED DEFAULT 1,
+ created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
+ PRIMARY KEY (option_name)
+ ) {$charset_collate};";
+
+ require_once ABSPATH . 'wp-admin/includes/upgrade.php';
+ \dbDelta( $sql );
+ }
+
+ /**
+ * Drop the custom table.
+ *
+ * @return void
+ */
+ public static function drop_table() {
+ global $wpdb;
+
+ $table_name = self::get_table_name();
+
+ // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.DirectDatabaseQuery.SchemaChange, WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- Table name is safe (from constant).
+ $wpdb->query( "DROP TABLE IF EXISTS {$table_name}" );
+ }
+
+ /**
+ * Check if the table exists.
+ *
+ * @return bool
+ */
+ public static function table_exists() {
+ global $wpdb;
+
+ $table_name = self::get_table_name();
+
+ // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching
+ return $wpdb->get_var( $wpdb->prepare( 'SHOW TABLES LIKE %s', $table_name ) ) === $table_name;
+ }
+
+ /**
+ * Number of options to migrate per request.
+ *
+ * @var int
+ */
+ const MIGRATION_CHUNK_SIZE = 1000;
+
+ /**
+ * Get migration status.
+ *
+ * @return array{needs_migration: bool, total: int, remaining: int}
+ */
+ public static function get_migration_status() {
+ $option_data = \get_option( 'option_optimizer' );
+
+ if ( ! \is_array( $option_data ) || empty( $option_data['used_options'] ) ) {
+ return [
+ 'needs_migration' => false,
+ 'total' => 0,
+ 'remaining' => 0,
+ ];
+ }
+
+ $remaining = \count( $option_data['used_options'] );
+
+ // Get total from transient or set it on first check.
+ $total = \get_transient( 'aaa_option_optimizer_migration_total' );
+ if ( false === $total ) {
+ $total = $remaining;
+ \set_transient( 'aaa_option_optimizer_migration_total', $total, HOUR_IN_SECONDS );
+ }
+
+ return [
+ 'needs_migration' => true,
+ 'total' => (int) $total,
+ 'remaining' => $remaining,
+ ];
+ }
+
+ /**
+ * Migrate a chunk of data from the old option format to the custom table.
+ *
+ * Processes in chunks to avoid timeouts on slow hosts with large datasets.
+ *
+ * @return array{success: bool, remaining: int, total: int}
+ */
+ public static function migrate_chunk() {
+ $option_data = \get_option( 'option_optimizer' );
+
+ // No data or already migrated.
+ if ( ! \is_array( $option_data ) || empty( $option_data['used_options'] ) ) {
+ \delete_transient( 'aaa_option_optimizer_migration_total' );
+ return [
+ 'success' => true,
+ 'remaining' => 0,
+ 'total' => 0,
+ ];
+ }
+
+ // Ensure table exists.
+ if ( ! self::table_exists() ) {
+ self::create_table();
+ }
+
+ // Get total for progress tracking.
+ $total = \get_transient( 'aaa_option_optimizer_migration_total' );
+ if ( false === $total ) {
+ $total = \count( $option_data['used_options'] );
+ \set_transient( 'aaa_option_optimizer_migration_total', $total, HOUR_IN_SECONDS );
+ }
+
+ // Take a chunk of options to migrate.
+ $chunk = \array_slice( $option_data['used_options'], 0, self::MIGRATION_CHUNK_SIZE, true );
+
+ // Batch insert chunk to custom table.
+ self::batch_insert( $chunk );
+
+ // Remove migrated options from the array.
+ $option_data['used_options'] = \array_slice( $option_data['used_options'], self::MIGRATION_CHUNK_SIZE, null, true );
+
+ \update_option( 'option_optimizer', $option_data, false );
+
+ $remaining = \count( $option_data['used_options'] );
+
+ // Clean up total transient when done.
+ if ( 0 === $remaining ) {
+ \delete_transient( 'aaa_option_optimizer_migration_total' );
+ }
+
+ return [
+ 'success' => true,
+ 'remaining' => $remaining,
+ 'total' => (int) $total,
+ ];
+ }
+
+ /**
+ * Batch insert or update option counts.
+ *
+ * Splits large datasets into chunks and wraps them in a transaction
+ * for optimal performance on slow hosts with large datasets.
+ *
+ * @param array $options Array of option_name => count.
+ * @param int $chunk_size Number of options per query. Default 500.
+ *
+ * @return void
+ */
+ public static function batch_insert( $options, $chunk_size = 500 ) {
+ global $wpdb;
+
+ if ( empty( $options ) ) {
+ return;
+ }
+
+ $table_name = self::get_table_name();
+
+ // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching
+ $wpdb->query( 'BEGIN' );
+
+ foreach ( array_chunk( $options, $chunk_size, true ) as $chunk ) {
+ $values = [];
+ $placeholders = [];
+
+ foreach ( $chunk as $option_name => $count ) {
+ $placeholders[] = '(%s, %d, NOW())';
+ $values[] = $option_name;
+ $values[] = (int) $count;
+ }
+
+ $sql = "INSERT INTO {$table_name} (option_name, access_count, created_at)
+ VALUES " . implode( ', ', $placeholders ) . '
+ ON DUPLICATE KEY UPDATE access_count = access_count + VALUES(access_count)';
+
+ // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.PreparedSQL.NotPrepared
+ $wpdb->query( $wpdb->prepare( $sql, ...$values ) );
+ }
+
+ // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching
+ $wpdb->query( 'COMMIT' );
+ }
+
+ /**
+ * Get all tracked options as an associative array.
+ *
+ * @return array Array of option_name => access_count.
+ */
+ public static function get_tracked_options() {
+ global $wpdb;
+
+ $table_name = self::get_table_name();
+
+ // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- Table name is safe (from constant).
+ $results = $wpdb->get_results( "SELECT option_name, access_count FROM {$table_name}", ARRAY_A );
+
+ if ( empty( $results ) ) {
+ return [];
+ }
+
+ $options = [];
+ foreach ( $results as $row ) {
+ $options[ $row['option_name'] ] = (int) $row['access_count'];
+ }
+
+ return $options;
+ }
+
+ /**
+ * Get tracked option names as a keyed array for efficient lookups.
+ *
+ * @return array Array of option_name => true.
+ */
+ public static function get_tracked_option_keys() {
+ global $wpdb;
+
+ $table_name = self::get_table_name();
+
+ // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- Table name is safe (from constant).
+ $option_names = $wpdb->get_col( "SELECT option_name FROM {$table_name}" );
+
+ if ( empty( $option_names ) ) {
+ return [];
+ }
+
+ return array_fill_keys( $option_names, true );
+ }
+
+ /**
+ * Clear all tracked options from the table.
+ *
+ * @return void
+ */
+ public static function clear_tracked_options() {
+ global $wpdb;
+
+ $table_name = self::get_table_name();
+
+ // phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- Table name is safe (from constant).
+ $wpdb->query( "TRUNCATE TABLE {$table_name}" );
+ }
+}
diff --git a/src/class-map-plugin-to-options.php b/src/class-map-plugin-to-options.php
index 2732f9a..799d8fe 100644
--- a/src/class-map-plugin-to-options.php
+++ b/src/class-map-plugin-to-options.php
@@ -2,15 +2,15 @@
/**
* Functionality to map options to plugins.
*
- * @package Emilia\OptionOptimizer
+ * @package Progress_Planner\OptionOptimizer
*/
-namespace Emilia\OptionOptimizer;
+namespace Progress_Planner\OptionOptimizer;
/**
* Class Map_Plugin_To_Options
*
- * @package Emilia\OptionOptimizer
+ * @package Progress_Planner\OptionOptimizer
*/
class Map_Plugin_To_Options {
/**
diff --git a/src/class-plugin.php b/src/class-plugin.php
index 0df3325..0caf091 100644
--- a/src/class-plugin.php
+++ b/src/class-plugin.php
@@ -2,10 +2,10 @@
/**
* Plugin functionality for AAA Option Optimizer.
*
- * @package Emilia\OptionOptimizer
+ * @package Progress_Planner\OptionOptimizer
*/
-namespace Emilia\OptionOptimizer;
+namespace Progress_Planner\OptionOptimizer;
/**
* Core functionality of AAA Option Optimizer.
@@ -19,9 +19,9 @@ class Plugin {
public static $instance;
/**
- * Holds the names of the options accessed during the request.
+ * Holds the options accessed during the request with their access counts.
*
- * @var string[]
+ * @var array
*/
protected $accessed_options = [];
@@ -60,8 +60,6 @@ public static function get_instance() {
* @return void
*/
public function register_hooks() {
- $this->accessed_options = \get_option( 'option_optimizer', [ 'used_options' => [] ] )['used_options'];
-
if ( Admin_Page::get_option_tracking() === 'pre_option' ) {
\add_filter( 'pre_option', [ $this, 'monitor_option_accesses_pre_option' ], PHP_INT_MAX, 2 );
} else {
@@ -144,7 +142,7 @@ protected function add_option_usage( $option_name ) {
}
/**
- * Update the 'option_optimizer' option with the list of used options at the end of the page load.
+ * Update the tracked options at the end of the page load.
*
* @return void
*/
@@ -153,19 +151,16 @@ public function update_tracked_options() {
if ( isset( $_GET['page'] ) && $_GET['page'] === 'aaa-option-optimizer' ) {
return;
}
- // Retrieve the existing option_optimizer data.
- $option_optimizer = get_option( 'option_optimizer', [ 'used_options' => [] ] );
-
- foreach ( $this->accessed_options as $option => $count ) {
- $option_optimizer['used_options'][ $option ] =
- ( $option_optimizer['used_options'][ $option ] ?? 0 ) + $count;
- }
+ // Handle reset.
if ( $this->should_reset ) {
- $option_optimizer['used_options'] = [];
+ Database::clear_tracked_options();
+ return;
}
- // Update the 'option_optimizer' option with the new list.
- update_option( 'option_optimizer', $option_optimizer, false );
+ // Write accessed options directly to the custom table.
+ if ( ! empty( $this->accessed_options ) ) {
+ Database::batch_insert( $this->accessed_options );
+ }
}
}
diff --git a/src/class-rest.php b/src/class-rest.php
index 5934a77..472eea4 100644
--- a/src/class-rest.php
+++ b/src/class-rest.php
@@ -2,10 +2,10 @@
/**
* REST functionality for AAA Option Optimizer.
*
- * @package Emilia\OptionOptimizer
+ * @package Progress_Planner\OptionOptimizer
*/
-namespace Emilia\OptionOptimizer;
+namespace Progress_Planner\OptionOptimizer;
use WP_Error;
use WP_REST_Request;
@@ -181,6 +181,18 @@ public function register_rest_routes() {
},
]
);
+
+ \register_rest_route(
+ 'aaa-option-optimizer/v1',
+ '/migrate',
+ [
+ 'methods' => 'POST',
+ 'callback' => [ $this, 'migrate_chunk' ],
+ 'permission_callback' => function () {
+ return current_user_can( 'manage_options' );
+ },
+ ]
+ );
}
/**
@@ -193,6 +205,16 @@ public function reset_stats() {
return new \WP_REST_Response( [ 'success' => true ], 200 );
}
+ /**
+ * Migrate a chunk of data from old format to custom table.
+ *
+ * @return \WP_REST_Response
+ */
+ public function migrate_chunk() {
+ $result = Database::migrate_chunk();
+ return new \WP_REST_Response( $result, 200 );
+ }
+
/**
* Update autoload status of an option.
*
@@ -229,9 +251,8 @@ public function get_unused_options() {
global $wpdb;
- // Load used options from option_optimizer.
- $option_optimizer = get_option( 'option_optimizer', [ 'used_options' => [] ] );
- $used_options = $option_optimizer['used_options'];
+ // Load used options from custom table.
+ $used_options = Database::get_tracked_option_keys();
$query = "
SELECT option_name
@@ -345,9 +366,8 @@ public function get_used_not_autoloaded_options() {
global $wpdb;
- // Load used options from option_optimizer.
- $option_optimizer = get_option( 'option_optimizer', [ 'used_options' => [] ] );
- $used_options = $option_optimizer['used_options'];
+ // Load used options from custom table (with counts).
+ $used_options = Database::get_tracked_options();
if ( empty( $used_options ) ) {
return new \WP_REST_Response(
@@ -481,9 +501,8 @@ public function get_options_that_do_not_exist() {
global $wpdb;
- // Load used options.
- $option_optimizer = get_option( 'option_optimizer', [ 'used_options' => [] ] );
- $used_options = $option_optimizer['used_options'];
+ // Load used options from custom table (with counts).
+ $used_options = Database::get_tracked_options();
if ( empty( $used_options ) ) {
return new \WP_REST_Response(
diff --git a/uninstall.php b/uninstall.php
index 4fa17e2..05bf9fe 100644
--- a/uninstall.php
+++ b/uninstall.php
@@ -2,9 +2,9 @@
/**
* Uninstall the plugin.
*
- * Delete the plugin option.
+ * Delete the plugin option and custom table.
*
- * @package Progress_Planner
+ * @package Progress_Planner\OptionOptimizer
*/
// If uninstall not called from WordPress, then exit.
@@ -12,5 +12,15 @@
exit;
}
+global $wpdb;
+
+// Drop the custom table.
+$aaa_option_optimizer_table = $wpdb->prefix . 'option_optimizer_tracked';
+// phpcs:ignore WordPress.DB.DirectDatabaseQuery.DirectQuery, WordPress.DB.DirectDatabaseQuery.NoCaching, WordPress.DB.DirectDatabaseQuery.SchemaChange, WordPress.DB.PreparedSQL.InterpolatedNotPrepared -- Table name is safe (from constant prefix).
+$wpdb->query( "DROP TABLE IF EXISTS {$aaa_option_optimizer_table}" );
+
+// Delete the batch transient.
+delete_transient( 'option_optimizer_batch' );
+
// Delete the plugin option.
delete_option( 'option_optimizer' );