class-settings-migrations.php

Settings migrations — one-time settings backfills extracted from the orchestrator.

Source includes/Settings/class-settings-migrations.php5 min readPart of Performance Optimisation

includes/Settings/class-settings-migrations.php

Settings migrations — one-time settings backfills extracted from the orchestrator.

Namespace: PerformanceOptimise\\Inc · Lines: 1091

Class Settings_Migrations

Class Settings_Migrations

Source: includes/Settings/class-settings-migrations.php, line 54

final class Settings_Migrations

Tags: @since 2.4.0 · @since NEXT Uses callable options and invalidation contracts (P3-016).

Properties

PropertyVisibilityTypeDefaultLine
$options_readerprivatecallable():array—62
$options_invalidatorprivatecallable():void—70

public __construct()

public function __construct(callable $options_reader, callable $options_invalidator)

Constructor.

ParameterTypeDefaultDescription
$options_readercallable—Returns current effective options.
$options_invalidatorcallable—Invalidates the owner snapshot.

Tags: @since 2.4.0 · @since NEXT Accepts callable settings contracts (P3-016).

Source: includes/Settings/class-settings-migrations.php, line 80

private read_options()

private function read_options(): array

Read the current effective options through the narrow contract.

Return: array — Effective options snapshot.

Tags: @since NEXT

Source: includes/Settings/class-settings-migrations.php, line 91

private invalidate_options()

private function invalidate_options(array $settings): void

Invalidate the owner snapshot after a persisted settings change.

ParameterTypeDefaultDescription
$settingsarray—Persisted migrated options to adopt.

Return: void.

Tags: @since NEXT

Source: includes/Settings/class-settings-migrations.php, line 103

public migrate_block_assets_setting()

public function migrate_block_assets_setting(bool $loads_separate_core_block_assets_on_demand): void

One-time upgrade core for the block-assets toggle on WP 6.9+.

ParameterTypeDefaultDescription
$loads_separate_core_block_assets_on_demandbool—Whether WP 6.9+ is active (core loads separate core block assets on demand).

Return: void.

Tags: @since 2.4.0 Relocated verbatim from Main::migrate_block_assets_setting() (ARCH-004).

Source: includes/Settings/class-settings-migrations.php, line 129

public migrate_ccss_max_size()

public function migrate_ccss_max_size(): void

One-time backfill for the CCSS inline size cap.

Return: void.

Tags: @since 2.0.0 · @since 2.4.0 Relocated verbatim from Main::maybe_migrate_ccss_max_size() (ARCH-004).

Source: includes/Settings/class-settings-migrations.php, line 175

public migrate_ccss_safelist()

public function migrate_ccss_safelist(): void

One-time backfill for the Critical CSS user safelist (issue #1038).

Return: void.

Tags: @since 2.0.0 · @since 2.4.0 Relocated verbatim from Main::maybe_migrate_ccss_safelist() (ARCH-004).

Source: includes/Settings/class-settings-migrations.php, line 218

public migrate_css_queue_defaults()

public function migrate_css_queue_defaults(): void

One-time backfill for the RUM-weighted CSS queue keys (issue #1164).

Return: void.

Tags: @since 2.2.0 Also backfills the 25s `ccssGenTimeout` generation budget. · @since 2.3.0 Also backfills the #1388 keys (`ccssInlineBudgetKb`, `ccssCommerceExclude`, `ccssChecksumRegen`). · @since 2.4.0 Relocated verbatim from Main::maybe_migrate_css_queue_defaults() (ARCH-004).

Source: includes/Settings/class-settings-migrations.php, line 265

public migrate_speculation_top_urls()

public function migrate_speculation_top_urls(): void

One-time backfill for the RUM-weighted top-URL prefetch cap (issue #1183).

Return: void.

Tags: @since 2.2.0 · @since 2.4.0 Relocated verbatim from Main::maybe_migrate_speculation_top_urls() (ARCH-004).

Source: includes/Settings/class-settings-migrations.php, line 325

public migrate_speculation_prerender_list()

public function migrate_speculation_prerender_list(): void

One-time backfill for the high-value prerender list toggle (issue #1237).

Return: void.

Tags: @since 2.2.0 · @since 2.4.0 Relocated verbatim from Main::maybe_migrate_speculation_prerender_list() (ARCH-004).

Source: includes/Settings/class-settings-migrations.php, line 369

public migrate_rum_sample_rate()

public function migrate_rum_sample_rate(): void

One-time backfill for the RUM beacon sample rate (issue #1214).

Return: void.

Tags: @since 2.2.0 · @since 2.4.0 Relocated verbatim from Main::maybe_migrate_rum_sample_rate() (ARCH-004).

Source: includes/Settings/class-settings-migrations.php, line 417

public migrate_image_alt_edge_defaults()

public function migrate_image_alt_edge_defaults(): void

One-time backfill for the missing-alt autofill toggle and the longest-edge downscale cap (issue #985).

Return: void.

Tags: @since 2.0.0 · @since 2.4.0 Relocated verbatim from Main::maybe_migrate_image_alt_edge_defaults() (ARCH-004).

Source: includes/Settings/class-settings-migrations.php, line 471

public migrate_safe_mode()

public function migrate_safe_mode(): void

One-time backfill for the unified safe-mode kill switch (issue #1098).

Return: void.

Tags: @since 2.2.0 · @since 2.4.0 Relocated verbatim from Main::maybe_migrate_safe_mode() (ARCH-004).

Source: includes/Settings/class-settings-migrations.php, line 525

public migrate_elementor_safe_mode()

public function migrate_elementor_safe_mode(): void

Backfill the additive elementorSafeMode key (issue #1259).

Return: void.

Tags: @since 2.2.0 · @since 2.4.0 Relocated verbatim from Main::maybe_migrate_elementor_safe_mode() (ARCH-004).

Source: includes/Settings/class-settings-migrations.php, line 560

public migrate_preload_auto_defaults()

public function migrate_preload_auto_defaults(): void

One-time backfill for automatic LCP hero preload + font discovery (issue #1216).

Return: void.

Tags: @since 2.2.0 · @since 2.4.0 Relocated verbatim from Main::maybe_migrate_preload_auto_defaults() (ARCH-004).

Source: includes/Settings/class-settings-migrations.php, line 595

public migrate_object_cache_outage_flag()

public function migrate_object_cache_outage_flag(): void

Backfill the additive Redis outage status flag (issue #1233).

Return: void.

Tags: @since 2.2.0 · @since 2.4.0 Relocated verbatim from Main::maybe_migrate_object_cache_outage_flag() (ARCH-004).

Source: includes/Settings/class-settings-migrations.php, line 645

public migrate_ai_speculation_autotune()

public function migrate_ai_speculation_autotune(): void

One-time backfill for RUM-segmented speculation auto-tune (issue #1425).

Return: void.

Tags: @since 2.3.0 · @since 2.4.0 Relocated verbatim from Main::maybe_migrate_ai_speculation_autotune() (ARCH-004).

Source: includes/Settings/class-settings-migrations.php, line 702

public migrate_ai_anomaly_v2()

public function migrate_ai_anomaly_v2(): void

One-time backfill for anomaly detector v2 keys (issue #1313).

Return: void.

Tags: @since 2.3.0 · @since 2.4.0 Relocated verbatim from Main::maybe_migrate_ai_anomaly_v2() (ARCH-004).

Source: includes/Settings/class-settings-migrations.php, line 776

public migrate_comment_image_hardening()

public function migrate_comment_image_hardening(): void

One-time backfill for comment-image hardening (issue #1271).

Return: void.

Tags: @since 2.2.0 · @since 2.4.0 Relocated verbatim from Main::maybe_migrate_comment_image_hardening() (ARCH-004).

Source: includes/Settings/class-settings-migrations.php, line 846

public migrate_builder_watcher()

public function migrate_builder_watcher(): void

Backfill the additive builder purge watcher keys (issue #1288).

Return: void.

Tags: @since 2.2.0 · @since 2.4.0 Relocated verbatim from Main::maybe_migrate_builder_watcher() (ARCH-004).

Source: includes/Settings/class-settings-migrations.php, line 934

public migrate_third_party_auto()

public function migrate_third_party_auto(): void

Backfill the additive auto third-party delay key (issue #1314).

Return: void.

Tags: @since 2.2.0 · @since 2.4.0 Relocated verbatim from Main::maybe_migrate_third_party_auto() (ARCH-004).

Source: includes/Settings/class-settings-migrations.php, line 1017