_wp_filter_build_unique_id()
Builds a unique string ID for a hook callback function.
Functions and static method callbacks are just returned as strings and shouldn't have any speed penalty.
Внутренняя функция — эта функция рассчитана на использование самим ядром. Не рекомендуется использовать эту функцию в своем коде.
Хуков нет.
Возвращает
Строку|null. Unique function ID for usage as array key. Null if a valid $callback is not passed.
Использование
_wp_filter_build_unique_id( $hook_name, $callback, $priority );
- $hook_name(строка) (обязательный)
- Unused. The name of the filter to build ID for.
- $callback(callable|строка|массив) (обязательный)
- The callback to generate ID for. The callback may or may not exist.
- $priority(int) (обязательный)
- Unused. The order in which the functions associated with a particular action are executed.
Список изменений
| С версии 2.2.3 | Введена. |
| С версии 5.3.0 | Removed workarounds for spl_object_hash(). (hook_name) $priority are no longer used, and the function always returns a string. |
Код _wp_filter_build_unique_id() wp filter build unique id WP 6.9.4
function _wp_filter_build_unique_id( $hook_name, $callback, $priority ) {
if ( is_string( $callback ) ) {
return $callback;
}
if ( is_object( $callback ) ) {
// Closures are currently implemented as objects.
$callback = array( $callback, '' );
} else {
$callback = (array) $callback;
}
if ( is_object( $callback[0] ) ) {
// Object class calling.
return spl_object_hash( $callback[0] ) . $callback[1];
} elseif ( is_string( $callback[0] ) ) {
// Static calling.
return $callback[0] . '::' . $callback[1];
}
return null;
}