rest_handle_deprecated_function

The timeline below displays how wordpress function rest_handle_deprecated_function has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 6.2

/**
 * Handles _deprecated_function() errors.
 *
 * @since 4.4.0
 *
 * @param string $function_name The function that was called.
 * @param string $replacement   The function that should have been called.
 * @param string $version       Version.
 */
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));
}

WordPress Version: 5.3

/**
 * Handles _deprecated_function() errors.
 *
 * @since 4.4.0
 *
 * @param string $function    The function that was called.
 * @param string $replacement The function that should have been called.
 * @param string $version     Version.
 */
function rest_handle_deprecated_function($function, $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, $version, $replacement);
    } else {
        /* translators: 1: Function name, 2: WordPress version number. */
        $string = sprintf(__('%1$s (since %2$s; no alternative available)'), $function, $version);
    }
    header(sprintf('X-WP-DeprecatedFunction: %s', $string));
}

WordPress Version: 4.8

/**
 * Handles _deprecated_function() errors.
 *
 * @since 4.4.0
 *
 * @param string $function    The function that was called.
 * @param string $replacement The function that should have been called.
 * @param string $version     Version.
 */
function rest_handle_deprecated_function($function, $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, $version, $replacement);
    } else {
        /* translators: 1: function name, 2: WordPress version number */
        $string = sprintf(__('%1$s (since %2$s; no alternative available)'), $function, $version);
    }
    header(sprintf('X-WP-DeprecatedFunction: %s', $string));
}

WordPress Version: 4.5

/**
 * Handles _deprecated_function() errors.
 *
 * @since 4.4.0
 *
 * @param string $function    The function that was called.
 * @param string $replacement The function that should have been called.
 * @param string $version     Version.
 */
function rest_handle_deprecated_function($function, $replacement, $version)
{
    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, $version, $replacement);
    } else {
        /* translators: 1: function name, 2: WordPress version number */
        $string = sprintf(__('%1$s (since %2$s; no alternative available)'), $function, $version);
    }
    header(sprintf('X-WP-DeprecatedFunction: %s', $string));
}

WordPress Version: 4.4

/**
 * Handles _deprecated_function() errors.
 *
 * @since 4.4.0
 *
 * @param string $function    Function name.
 * @param string $replacement Replacement function name.
 * @param string $version     Version.
 */
function rest_handle_deprecated_function($function, $replacement, $version)
{
    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, $version, $replacement);
    } else {
        /* translators: 1: function name, 2: WordPress version number */
        $string = sprintf(__('%1$s (since %2$s; no alternative available)'), $function, $version);
    }
    header(sprintf('X-WP-DeprecatedFunction: %s', $string));
}