do_core_upgrade( bool $reinstall = false )

Parameters

$reinstallbooloptional

Default: false

Uses · 12

• wp_nonce_url()Retrieves URL with nonce added to URL query.
• find_core_update()Finds the available update for WordPress core.
• _e()Displays translated text.
• request_filesystem_credentials()Displays a form to the user to request for their FTP/SSH details in order to connect to the filesystem.
• WP_Filesystem()Initializes and connects the WordPress Filesystem Abstraction classes.
• show_message()Displays the given administration message.
• add_filter()Adds a callback function to a filter hook.
• is_wp_error()Checks whether the given variable is a WordPress Error.
• __()Retrieves the translation of $text.
• esc_url()Checks and cleans a URL.
• self_admin_url()Retrieves the URL to the admin area for either the current site or the network depending on context.
• Core_Upgrader::__construct()

Source

View on Trac ↗View on GitHub ↗

845function do_core_upgrade( $reinstall = false ) {846	global $wp_filesystem;847 848	require_once ABSPATH . 'wp-admin/includes/class-wp-upgrader.php';849 850	if ( $reinstall ) {851		$url = 'update-core.php?action=do-core-reinstall';852	} else {853		$url = 'update-core.php?action=do-core-upgrade';854	}855	$url = wp_nonce_url( $url, 'upgrade-core' );856 857	$version = isset( $_POST['version'] ) ? $_POST['version'] : false;858	$locale  = isset( $_POST['locale'] ) ? $_POST['locale'] : 'en_US';859	$update  = find_core_update( $version, $locale );860	if ( ! $update ) {861		return;862	}863 864	/*865	 * Allow relaxed file ownership writes for User-initiated upgrades when the API specifies866	 * that it's safe to do so. This only happens when there are no new files to create.867	 */868	$allow_relaxed_file_ownership = ! $reinstall && isset( $update->new_files ) && ! $update->new_files;869 870	?>871	<div class="wrap">872	<h1><?php _e( 'Update WordPress' ); ?></h1>873	<?php874 875	$credentials = request_filesystem_credentials( $url, '', false, ABSPATH, array( 'version', 'locale' ), $allow_relaxed_file_ownership );876	if ( false === $credentials ) {877		echo '</div>';878		return;879	}880 881	if ( ! WP_Filesystem( $credentials, ABSPATH, $allow_relaxed_file_ownership ) ) {882		// Failed to connect. Error and request again.883		request_filesystem_credentials( $url, '', true, ABSPATH, array( 'version', 'locale' ), $allow_relaxed_file_ownership );884		echo '</div>';885		return;886	}887 888	if ( $wp_filesystem->errors->has_errors() ) {889		foreach ( $wp_filesystem->errors->get_error_messages() as $message ) {890			show_message( $message );891		}892		echo '</div>';893		return;894	}895 896	if ( $reinstall ) {897		$update->response = 'reinstall';898	}899 900	add_filter( 'update_feedback', 'show_message' );901 902	$upgrader = new Core_Upgrader();903	$result   = $upgrader->upgrade(904		$update,905		array(906			'allow_relaxed_file_ownership' => $allow_relaxed_file_ownership,907		)908	);909 910	if ( is_wp_error( $result ) ) {911		show_message( $result );912		if ( 'up_to_date' !== $result->get_error_code() && 'locked' !== $result->get_error_code() ) {913			show_message( __( 'Installation failed.' ) );914		}915		echo '</div>';916		return;917	}918 919	show_message( __( 'WordPress updated successfully.' ) );920	show_message(921		'<span class="hide-if-no-js">' . sprintf(922			/* translators: 1: WordPress version, 2: URL to About screen. */923			__( 'Welcome to WordPress %1$s. You will be redirected to the About WordPress screen. If not, click <a href="%2$s">here</a>.' ),924			$result,

History

Introduced in 2.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.7.7 tag, from src/wp-admin/update-core.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.