rest_handle_deprecated_function()WP 4.4.0

Handles _deprecated_function() errors.

No Hooks.

Return

null. Nothing (null).

Usage

rest_handle_deprecated_function( $function_name, $replacement, $version );
$function_name(string) (required)
The function that was called.
$replacement(string) (required)
The function that should have been called.
$version(string) (required)
Version.

Changelog

Since 4.4.0 Introduced.

rest_handle_deprecated_function() code WP 6.5.2

function rest_handle_deprecated_function( $function_name, $replacement, $version ) {
	if ( ! WP_DEBUG || headers_sent() ) {
		return;
	}
	if ( ! empty( $replacement ) ) {
		/* translators: 1: Function name, 2: WordPress version number, 3: New function name. */
		$string = sprintf( __( '%1$s (since %2$s; use %3$s instead)' ), $function_name, $version, $replacement );
	} else {
		/* translators: 1: Function name, 2: WordPress version number. */
		$string = sprintf( __( '%1$s (since %2$s; no alternative available)' ), $function_name, $version );
	}

	header( sprintf( 'X-WP-DeprecatedFunction: %s', $string ) );
}