函数 wp_kses_split 是 WordPress 中的一个函数,用于将给定的字符串分割成一个标签数组和一个文本数组。

函数定义如下:

wp_kses_split( string $string, array|string $allowed_html, array $replace_tags = array() )

该函数接受三个参数:

- `$string`:要分割的字符串。
- `$allowed_html`:允许的 HTML 标签。可以是一个数组,也可以是一个字符串。
- `$replace_tags`:替代标签数组。可选参数。

该函数将字符串分割成两个数组:$tags 和 $text。

- `$tags` 数组包含有效的 HTML 标签。
- `$text` 数组包含不在允许列表中的文本。

下面是一个示例用法:

$allowed_html = array(
'a' => array(
'href' => array(),
'title' => array()
),
'br' => array(),
'em' => array(),
'strong' => array()
);

$string = 'This is a link.';

$split = wp_kses_split( $string, $allowed_html );

$tags = $split['tags']; // 包含有效的 HTML 标签
$text = $split['text']; // 包含不在允许列表中的文本

在上面的示例中,$allowed_html 数组定义了允许的 HTML 标签和它们的属性。变量 $string 是要分割的字符串。使用 wp_kses_split 函数将字符串分割成两个数组:$tags 和 $text。

$tags 数组将包含以下值:

array(
'',
'
'
)

$text 数组将包含以下值:

array(
'This is a link.'
)

通过这种方式,可以轻松地从给定的字符串中提取有效的 HTML 标签和文本内容。