WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

wp_update_https_detection_errors()

wp_update_https_detection_errors()

In this article

Back to top

This function has been deprecated. The wp_update_https_detection_errors() function is no longer used and has been replaced by wp_get_https_detection_errors(). Previously the function was called by a regular Cron hook to update the https_detection_errors option, but this is no longer necessary as the errors are retrieved directly in Site Health and no longer used outside of Site Health instead.

This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.

Runs a remote HTTPS request to detect whether HTTPS supported, and stores potential errors.

Description

This internal function is called by a regular Cron hook to ensure HTTPS support is detected and maintained.

Source

function wp_update_https_detection_errors() {
	_deprecated_function( __FUNCTION__, '6.4.0' );

	/**
	 * Short-circuits the process of detecting errors related to HTTPS support.
	 *
	 * Returning a `WP_Error` from the filter will effectively short-circuit the default logic of trying a remote
	 * request to the site over HTTPS, storing the errors array from the returned `WP_Error` instead.
	 *
	 * @since 5.7.0
	 * @deprecated 6.4.0 The `wp_update_https_detection_errors` filter is no longer used and has been replaced by `pre_wp_get_https_detection_errors`.
	 *
	 * @param null|WP_Error $pre Error object to short-circuit detection,
	 *                           or null to continue with the default behavior.
	 */
	$support_errors = apply_filters( 'pre_wp_update_https_detection_errors', null );
	if ( is_wp_error( $support_errors ) ) {
		update_option( 'https_detection_errors', $support_errors->errors, false );
		return;
	}

	$support_errors = wp_get_https_detection_errors();

	update_option( 'https_detection_errors', $support_errors );
}

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘pre_wp_update_https_detection_errors’, null|WP_Error $pre )

Short-circuits the process of detecting errors related to HTTPS support.

UsesDescription
wp_get_https_detection_errors()wp-includes/https-detection.php

Runs a remote HTTPS request to detect whether HTTPS supported, and stores potential errors.

_deprecated_function()wp-includes/functions.php

Marks a function as deprecated and inform when it has been used.

apply_filters()wp-includes/plugin.php

Calls the callback functions that have been added to a filter hook.

update_option()wp-includes/option.php

Updates the value of an option that was already added.

is_wp_error()wp-includes/load.php

Checks whether the given variable is a WordPress Error.

Show 3 moreShow less
Used byDescription
wp_is_https_supported()wp-includes/https-detection.php

Checks whether HTTPS is supported for the server and domain.

Changelog

VersionDescription
6.4.0The wp_update_https_detection_errors() function is no longer used and has been replaced by wp_get_https_detection_errors(). Previously the function was called by a regular Cron hook to update the https_detection_errors option, but this is no longer necessary as the errors are retrieved directly in Site Health and no longer used outside of Site Health.
5.7.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.