WP_Automatic_Updater::run()

Compatibility

Present in every tracked release (6.7.7 to 7.1.0), and compiles on PHP 7.4 through 8.6-dev.

Performance profile

How much work a call to WP_Automatic_Updater::run() does, and what it touches: the algorithmic scaling, the Zend instruction count per call across PHP versions, the hooks it hands control to, and the core code that calls it. Measured from the compiled opcodes, not a stopwatch, so every number is identical on any machine running the same PHP version, and every function in core is ranked by cost.

Cost class

Expensive

Reaches an outbound HTTP request via wp_remote_post().

Scaling

Scales with input

The body loops, so the work grows with how much data it finds.

Instructions

7–149

Executed per call on PHP 8.5, depending on the branch taken. The body compiles to 215.

Plugin surface

2 hooks

Third-party callbacks on 'automatic_updates_send_debug_email', 'automatic_updates_complete' run inside this call, and their cost is not bounded by anything here.

Called by

0

Nothing in core calls this; the cost is only what you spend yourself.

What it touches

• transienttransientget_site_transient()called directly
• hookthird-party callbacksapply_filters()called directly
• sqldatabase query->update()called directly
• optionoption read or writeget_option()one call below WP_Automatic_Updater::run()
• httpoutbound HTTP requestwp_remote_post()one call below WP_Automatic_Updater::run()
• cacheobject cachewp_cache_get()one call below WP_Automatic_Updater::run()

Further down the call graph this can also reach serialize and query. Those are the worst case, several calls deep and usually down an error path, not what a normal call pays.

What one call costs · 141 distinct outcomes

One number would be a lie: the work depends on which branch runs. These are every distinct cost WP_Automatic_Updater::run() can have, taken from its control-flow graph on PHP 8.5.

This body has more branch combinations than are worth enumerating, so the table covers the outcomes found first rather than every one that exists.

Hooks and filters fired · 2

2 hooks fire while WP_Automatic_Updater::run() runs, in this order:

1. 1
   apply_filters( automatic_updates_send_debug_email )filterline 766 (+124 into the body)

   Filters whether to send a debugging email for each automatic background update.

2. 2
   do_action( automatic_updates_complete )actionline 783 (+141 into the body)

   Fires after all automatic updates have run.

Uses · 23

• is_main_network()Determines whether a network is the main network of the Multisite installation.
• is_main_site()Determines whether a site is the main site of the current network.
• remove_action()Removes a callback function from an action hook.
• wp_update_plugins()Checks for available updates to plugins based on the latest versions hosted on WordPress.org.
• get_site_transient()Retrieves the value of a site transient.
• wp_clean_plugins_cache()Clears the plugins cache used by get_plugins() and by default, the plugin updates cache.
• wp_update_themes()Checks for available updates to themes based on the latest versions hosted on WordPress.org.
• wp_clean_themes_cache()Clears the cache held by get_theme_roots() and WP_Theme.
• wp_version_check()Checks WordPress version against the newest version.
• find_core_auto_update()Gets the best available (and enabled) Auto-Update for WordPress core.
• wp_get_translation_updates()Retrieves a list of all language updates available.
• wp_clean_update_cache()Clears existing update caches for plugins, themes, and core.

Source code

View on Trac ↗View on GitHub ↗

642	public function run() {643		if ( $this->is_disabled() ) {644			return;645		}646 647		if ( ! is_main_network() || ! is_main_site() ) {648			return;649		}650 651		if ( ! WP_Upgrader::create_lock( 'auto_updater' ) ) {652			return;653		}654 655		$is_debug = WP_DEBUG && WP_DEBUG_LOG;656 657		if ( $is_debug ) {658			error_log( 'Automatic updates starting...' );659		}660 661		// Don't automatically run these things, as we'll handle it ourselves.662		remove_action( 'upgrader_process_complete', array( 'Language_Pack_Upgrader', 'async_upgrade' ), 20 );663		remove_action( 'upgrader_process_complete', 'wp_version_check' );664		remove_action( 'upgrader_process_complete', 'wp_update_plugins' );665		remove_action( 'upgrader_process_complete', 'wp_update_themes' );666 667		// Next, plugins.668		wp_update_plugins(); // Check for plugin updates.669		$plugin_updates = get_site_transient( 'update_plugins' );670		if ( $plugin_updates && ! empty( $plugin_updates->response ) ) {671			if ( $is_debug ) {672				error_log( '  Automatic plugin updates starting...' );673			}674 675			foreach ( $plugin_updates->response as $plugin ) {676				$this->update( 'plugin', $plugin );677			}678 679			// Force refresh of plugin update information.680			wp_clean_plugins_cache();681 682			if ( $is_debug ) {683				error_log( '  Automatic plugin updates complete.' );684			}685		}686 687		// Next, those themes we all love.688		wp_update_themes();  // Check for theme updates.689		$theme_updates = get_site_transient( 'update_themes' );690		if ( $theme_updates && ! empty( $theme_updates->response ) ) {691			if ( $is_debug ) {692				error_log( '  Automatic theme updates starting...' );693			}694 695			foreach ( $theme_updates->response as $theme ) {696				$this->update( 'theme', (object) $theme );697			}698			// Force refresh of theme update information.699			wp_clean_themes_cache();700 701			if ( $is_debug ) {702				error_log( '  Automatic theme updates complete.' );703			}704		}705 706		if ( $is_debug ) {707			error_log( 'Automatic updates complete.' );708		}709 710		// Next, process any core update.711		wp_version_check(); // Check for core updates.712		$core_update = find_core_auto_update();713 714		if ( $core_update ) {715			$this->update( 'core', $core_update );716		}717 718		/*719		 * Clean up, and check for any pending translations.720		 * (Core_Upgrader checks for core updates.)721		 */

Changelog

Introduced in 3.7.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.9.7 tag, from src/wp-admin/includes/class-wp-automatic-updater.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.