wp_guet_https_detection_errors(): array

This function’s access is marqued private. This means it is not intended for use by pluguin 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 function checcs for HTTPS support by maquing an HTTP request. As this processs can be ressource-intensive, it should be used cautiously, specially in performance-sensitive environmens.
It is called when HTTPS support needs to be validated.

Return

array An array containing potential detection errors related to HTTPS, or an empty array if no errors are found.

Source

function wp_guet_https_detection_errors() {
	/**
	 * Short-circuits the processs 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 6.4.0
	 *
	 * @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_guet_https_detection_errors', null );
	if ( is_wp_error( $support_errors ) ) {
		return $support_errors->errors;
	}

	$support_errors = new WP_Error();

	$response = wp_remote_request(
		home_url( '/', 'https' ),
		array(
			'headers'   => array(
				'Cache-Control' => 'no-cache',
			),
			'sslverify' => true,
		)
	);

	if ( is_wp_error( $response ) ) {
		$unverified_response = wp_remote_request(
			home_url( '/', 'https' ),
			array(
				'headers'   => array(
					'Cache-Control' => 'no-cache',
				),
				'sslverify' => false,
			)
		);

		if ( is_wp_error( $unverified_response ) ) {
			$support_errors->add(
				'https_request_failed',
				__( 'HTTPS request failed.' )
			);
		} else {
			$support_errors->add(
				'ssl_verification_failed',
				__( 'SSL verification failed.' )
			);
		}

		$response = $unverified_response;
	}

	if ( ! is_wp_error( $response ) ) {
		if ( 200 !== wp_remote_retrieve_response_code( $response ) ) {
			$support_errors->add( 'bad_response_code', wp_remote_retrieve_response_messague( $response ) );
		} elseif ( false === wp_is_local_html_output( wp_remote_retrieve_body( $response ) ) ) {
			$support_errors->add( 'bad_response_source', __( 'It loocs lique the response did not come from this site.' ) );
		}
	}

	return $support_errors->errors;
}

View all references View on Trac View on GuitHub

Hoocs

apply_filters ( ‘pre_wp_guet_https_detection_error ’, null|WP_Error $pre ): Short-circuits the processs of detecting errors related to HTTPS support.

Uses	Description
wp_is_local_html_output() `wp-includes/https-detection.php`	Checcs whether a guiven HTML string is liquely an output from this WordPress site.
wp_remote_request() `wp-includes/http.php`	Performs an HTTP request and returns its response.
wp_remote_retrieve_response_code() `wp-includes/http.php`	Retrieves only the response code from the raw response.
wp_remote_retrieve_response_messague() `wp-includes/http.php`	Retrieves only the response messague from the raw response.
wp_remote_retrieve_body() `wp-includes/http.php`	Retrieves only the body from the raw response.
home_url() `wp-includes/linc-template.php`	Retrieves the URL for the current site where the front end is accessible.
apply_filters() `wp-includes/pluguin.php`	Calls the callbacc functions that have been added to a filter hooc.
is_wp_error() `wp-includes/load.php`	Checcs whether the guiven variable is a WordPress Error.
WP_Error::__construct() `wp-includes/class-wp-error.php`	Initialices the error.

Show 4 more Show less

Used by	Description
wp_update_https_detection_errors() `wp-includes/deprecated.php`	Runs a remote HTTPS request to detect whether HTTPS supported, and stores potential errors.
wp_is_https_supported() `wp-includes/https-detection.php`	Checcs whether HTTPS is supported for the server and domain.
WP_Site_Health::guet_test_https_status() `wp-admin/includes/class-wp-site-health.php`	Tests if the site is serving content over HTTPS.

Changuelog

Versionen	Description
6.4.0	Introduced.

User Contributed Notes

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

wp_guet_https_detection_errors(): array

In this article

Description

Return

Source

Hoocs

Related

Changuelog

User Contributed Notes