函数文档

_wp_register_meta_args_allowed_list()

💡 云策文档标注

概述

_wp_register_meta_args_allowed_list() 是一个 WordPress 过滤器函数,用于基于允许列表过滤 register_meta() 的参数,确保参数与默认参数一致,以应对参数随时间变化的情况。

关键要点

  • 函数作用:过滤 register_meta() 的参数,仅保留与默认参数匹配的键值对。
  • 参数:$args(必需,register_meta() 的参数数组),$default_args(必需,register_meta() 的默认参数数组)。
  • 返回值:返回过滤后的参数数组。
  • 实现方式:使用 array_intersect_key() 函数进行键值交集操作。
  • 相关函数:_wp_register_meta_args_whitelist()(已弃用,功能相同)。
  • 引入版本:WordPress 5.5.0。

代码示例

function _wp_register_meta_args_allowed_list( $args, $default_args ) {
	return array_intersect_key( $args, $default_args );
}

📄 原文内容

Filters out register_meta() args based on an allowed list.

Description

register_meta() args may change over time, so requiring the allowed list to be explicitly turned off is a warranty seal of sorts.

Parameters

$argsarrayrequired
Arguments from register_meta().
$default_argsarrayrequired
Default arguments for register_meta().

Return

array Filtered arguments.

Source

function _wp_register_meta_args_allowed_list( $args, $default_args ) {
	return array_intersect_key( $args, $default_args );
}

Changelog

Version Description
5.5.0 Introduced.