钩子文档

wp_internal_hosts

💡 云策文档标注

概述

wp_internal_hosts 是一个 WordPress 过滤器,用于修改被视为内部 URL 的主机名数组。它允许开发者自定义哪些主机被视为内部主机,常用于链接处理或安全相关功能。

关键要点

  • 这是一个过滤器,用于过滤内部 URL 主机数组。
  • 参数 $internal_hosts 是一个字符串数组,包含内部 URL 主机名。
  • 默认情况下,数组包含 home_url() 解析出的主机名。
  • 通过 apply_filters('wp_internal_hosts', $internal_hosts) 调用。
  • 在 WordPress 6.2.0 版本中引入。

代码示例

$internal_hosts = apply_filters(
    'wp_internal_hosts',
    array(
        wp_parse_url( home_url(), PHP_URL_HOST ),
    )
);

📄 原文内容

Filters the array of URL hosts which are considered internal.

Parameters

$internal_hostsstring[]
An array of internal URL hostnames.

Source

$internal_hosts = apply_filters(
	'wp_internal_hosts',
	array(
		wp_parse_url( home_url(), PHP_URL_HOST ),
	)
);

Changelog

Version Description
6.2.0 Introduced.