WordPress開發(fā)函數(shù)apply_filters_deprecated()，觸發(fā)附加在廢棄過濾器鉤子上的函數(shù)。

用法：

apply_filters_deprecated( string $tag, array $args, string $version, string $replacement = '', string $message = '' )

描述

當(dāng)篩選器鉤子被棄用時，apply_filters()調(diào)用會被apply_filters_deprecated()替換，它會觸發(fā)棄用通知，然后觸發(fā)原始的篩選器鉤子。

注意:傳遞給原始apply_filters()調(diào)用的值和額外參數(shù)必須在這里以數(shù)組形式傳遞給$args。例如:

// Old filter.

return apply_filters( 'wpdocs_filter', $value, $extra_arg );

// Deprecated.

return apply_filters_deprecated( 'wpdocs_filter', array( $value, $extra_arg ), '4.9.0', 'wpdocs_new_filter' );

參見also

_deprecated_hook ()

參數(shù)：

$tag

(string) (必需) 過濾器鉤子的名稱。

$args

(array) (必需) 傳遞給apply_filters()的附加函數(shù)參數(shù)的數(shù)組。

$version

(string) (必需) 反對鉤子的wordpress版本。

$replacement

(string) (可選) 應(yīng)該用的鉤子。

默認(rèn)值: ''

$message

(string) (可選) 關(guān)于變更的消息

默認(rèn)值: ''

來源

文件: wp-includes/plugin.php

function apply_filters_deprecated( $tag, $args, $version, $replacement = '', $message = '' ) {

if ( ! has_filter( $tag ) ) {

return $args[0];

}

_deprecated_hook( $tag, $version, $replacement, $message );

return apply_filters_ref_array( $tag, $args );

}

更新日志：