wp_version_check( array $extra_stats = array(), bool $force_check = false )

Description

Parameters

$extra_statsarrayoptional

Extra statistics to report to the WordPress.org API.Default: array()

$force_checkbooloptional

Whether to bypass the transient cache and force a fresh update check. Defaults to false, true if $extra_stats is set.Default: false

Hooks fired · 3

3 hooks fire while wp_version_check() runs, in this order:

1. 1
   apply_filters( core_version_check_locale )filterline 69 (+42 into the body)

   Filters the locale requested for WordPress core translations.

2. 2
   apply_filters( core_version_check_query_args )filterline 167 (+140 into the body)

   Filters the query arguments sent as part of the core version check.

3. 3
   do_action( wp_maybe_auto_update )actionline 295 (+268 into the body)

   Fires during wp_cron, starting the auto-update process.

Uses · 31

• wp_installing()Checks or sets whether WordPress is in "installation" mode.
• get_site_transient()Retrieves the value of a site transient.
• wp_get_installed_translations()Gets installed translations.
• wp_get_wp_version()Returns the current WordPress version.
• apply_filters()Calls the callback functions that have been added to a filter hook.
• get_locale()Retrieves the current locale.
• set_site_transient()Sets/updates the value of a site transient.
• is_multisite()Determines whether Multisite is enabled.
• get_blog_count()Gets the number of active sites on the installation.
• network_site_url()Retrieves the site URL for the current network.
• home_url()Retrieves the URL for the current site where the front end is accessible.
• get_user_count()Returns the number of active users in your installation.

Used by · 5

• Core_Upgrader::upgrade()Upgrades WordPress core.
• WP_Automatic_Updater::run()Kicks off the background update process, looping through all pending updates.
• WP_Debug_Data::check_for_updates()Calls all core functions to check for updates.
• WP_Upgrader::run()Runs an upgrade/installation.
• _maybe_update_core()Determines whether core should be updated.

Source

View on Trac ↗View on GitHub ↗

27function wp_version_check( $extra_stats = array(), $force_check = false ) {28	global $wpdb, $wp_local_package;29 30	if ( wp_installing() ) {31		return;32	}33 34	$php_version = PHP_VERSION;35 36	$current      = get_site_transient( 'update_core' );37	$translations = wp_get_installed_translations( 'core' );38 39	// Invalidate the transient when $wp_version changes.40	if ( is_object( $current ) && wp_get_wp_version() !== $current->version_checked ) {41		$current = false;42	}43 44	if ( ! is_object( $current ) ) {45		$current                  = new stdClass();46		$current->updates         = array();47		$current->version_checked = wp_get_wp_version();48	}49 50	if ( ! empty( $extra_stats ) ) {51		$force_check = true;52	}53 54	// Wait 1 minute between multiple version check requests.55	$timeout          = MINUTE_IN_SECONDS;56	$time_not_changed = isset( $current->last_checked ) && $timeout > ( time() - $current->last_checked );57 58	if ( ! $force_check && $time_not_changed ) {59		return;60	}61 62	/**63	 * Filters the locale requested for WordPress core translations.64	 *65	 * @since 2.8.066	 *67	 * @param string $locale Current locale.68	 */69	$locale = apply_filters( 'core_version_check_locale', get_locale() );70 71	// Update last_checked for current to prevent multiple blocking requests if request hangs.72	$current->last_checked = time();73	set_site_transient( 'update_core', $current );74 75	if ( method_exists( $wpdb, 'db_server_info' ) ) {76		$mysql_version = $wpdb->db_server_info();77	} elseif ( method_exists( $wpdb, 'db_version' ) ) {78		$mysql_version = preg_replace( '/[^0-9.].*/', '', $wpdb->db_version() );79	} else {80		$mysql_version = 'N/A';81	}82 83	if ( is_multisite() ) {84		$num_blogs         = get_blog_count();85		$wp_install        = network_site_url();86		$multisite_enabled = 1;87	} else {88		$multisite_enabled = 0;89		$num_blogs         = 1;90		$wp_install        = home_url( '/' );91	}92 93	$extensions = get_loaded_extensions();94	sort( $extensions, SORT_STRING | SORT_FLAG_CASE );95	$query = array(96		'version'            => wp_get_wp_version(),97		'php'                => $php_version,98		'locale'             => $locale,99		'mysql'              => $mysql_version,100		'local_package'      => isset( $wp_local_package ) ? $wp_local_package : '',101		'blogs'              => $num_blogs,102		'users'              => get_user_count(),103		'multisite_enabled'  => $multisite_enabled,104		'initial_db_version' => get_site_option( 'initial_db_version' ),105		'extensions'         => array_combine( $extensions, array_map( 'phpversion', $extensions ) ),106		'platform_flags'     => array(

History

Introduced in 2.3.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.7.7 tag, from src/wp-includes/update.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.