wordpress函数apply_filters_deprecated()用法示例

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

Fires functions attached to a deprecated filter hook.

描述

When a filter hook is deprecated, the apply_filters() call is replaced with apply_filters_deprecated(), which triggers a deprecation notice and then fires the original filter hook.

参数

$tag

(string)
(Required)
The name of the filter hook.

$args

(array)
(Required)
Array of additional function arguments to be passed to apply_filters().

$version

(string)
(Required)
The version of WordPress that deprecated the hook.

$replacement

(string)
(Optional)
The hook that should have been used.

Default value: false

$message

(string)
(Optional)
A message regarding the change.

Default value: null

源代码

File: wp-includes/plugin.php

function apply_filters_deprecated( $tag, $args, $version, $replacement = false, $message = null ) {
	if ( ! has_filter( $tag ) ) {
		return $args[0];
	}

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

	return apply_filters_ref_array( $tag, $args );
}

更新日志

相关函数

Uses

• wp-includes/functions.php:
  _deprecated_hook()
• wp-includes/plugin.php:
  has_filter()
• wp-includes/plugin.php:
  apply_filters_ref_array()

Used By

• wp-includes/class-wp-site.php:
  WP_Site::get_details()
• wp-includes/rest-api/class-wp-rest-server.php:
  WP_REST_Server::serve_request()
• wp-includes/ms-blogs.php:
  get_blog_details()