php do action,wordpress函数do_action_deprecated()用法示例

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

Fires functions attached to a deprecated action hook.

描述

When an action hook is deprecated, the do_action() call is replaced with do_action_deprecated(), which triggers a deprecation notice and then fires the original hook.

参数

$tag

(string)

(Required)

The name of the action hook.

$args

(array)

(Required)

Array of additional function arguments to be passed to do_action().

$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 do_action_deprecated( $tag, $args, $version, $replacement = false, $message = null ) {

if ( ! has_action( $tag ) ) {

return;

}

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

do_action_ref_array( $tag, $args );

}

更新日志

Version

描述

4.6.0

Introduced.

相关函数

Uses

wp-includes/functions.php:

_deprecated_hook()

wp-includes/plugin.php:

has_action()

wp-includes/plugin.php:

do_action_ref_array()