W3cubDocs

/WordPress

wp_update_https_migration_required( mixed $old_url, mixed $new_url )

Updates the ‘https_migration_required’ option if needed when the given URL has been updated from HTTP to HTTPS.

Description

If this is a fresh site, a migration will not be required, so the option will be set as false.

This is hooked into the ‘update_option_home’ action.

Parameters

$old_urlmixedrequired
Previous value of the URL option.
$new_urlmixedrequired
New value of the URL option.

Source

function wp_update_https_migration_required( $old_url, $new_url ) {
	// Do nothing if WordPress is being installed.
	if ( wp_installing() ) {
		return;
	}

	// Delete/reset the option if the new URL is not the HTTPS version of the old URL.
	if ( untrailingslashit( (string) $old_url ) !== str_replace( 'https://', 'http://', untrailingslashit( (string) $new_url ) ) ) {
		delete_option( 'https_migration_required' );
		return;
	}

	// If this is a fresh site, there is no content to migrate, so do not require migration.
	$https_migration_required = get_option( 'fresh_site' ) ? false : true;

	update_option( 'https_migration_required', $https_migration_required );
}

Changelog

Version Description
5.7.0 Introduced.

© 2003–2024 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_update_https_migration_required