_wp_filter_build_unique_id( string $hook_name, callable $callback, int $priority ): string|null

Description

Parameters

$hook_namestring

Unused. The name of the filter to build ID for.

$callbackcallable

The callback to generate ID for. The callback may or may not exist.

$priorityint

Unused. The order in which the functions associated with a particular action are executed.

Return

string|null

Unique function ID for usage as array key, or null if it couldn't be determined.

Used by · 3

• WP_Hook::add_filter()Adds a callback function to a filter hook.
• WP_Hook::has_filter()Checks if a specific callback has been registered for this hook.
• WP_Hook::remove_filter()Removes a callback function from a filter hook.

Source

View on Trac ↗View on GitHub ↗

1002function _wp_filter_build_unique_id( $hook_name, $callback, $priority ): ?string {1003	if ( is_string( $callback ) ) {1004		return $callback;1005	}1006 1007	if ( is_object( $callback ) ) {1008		return (string) spl_object_id( $callback );1009	}1010 1011	if ( ! isset( $callback[1] ) || ! is_string( $callback[1] ) ) {1012		return null;1013	}1014 1015	if ( is_object( $callback[0] ) ) {1016		// Object class calling.1017		return ( (string) spl_object_id( $callback[0] ) ) . $callback[1];1018	} elseif ( is_string( $callback[0] ) ) {1019		// Static calling.1020		return $callback[0] . '::' . $callback[1];1021	}1022 1023	return null;1024}

History

Introduced in 2.2.3. 2 changes between 6.7.7 and 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-includes/plugin.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.