钩子文档

wp_signature_hosts

💡 云策文档标注

概述

wp_signature_hosts 是一个 WordPress 过滤器,用于修改需要尝试签名验证的主机列表。它允许开发者自定义哪些主机名应进行签名验证,通常用于安全相关功能。

关键要点

  • 这是一个过滤器 Hook,名称为 wp_signature_hosts,用于过滤主机名数组。
  • 默认主机名包括 'wordpress.org', 'downloads.wordpress.org', 's.w.org',可通过 apply_filters 修改。
  • 主要用于 download_url() 函数中,影响通过 WordPress HTTP API 下载文件时的签名验证行为。
  • 自 WordPress 5.2.0 版本引入。

代码示例

$signed_hostnames = apply_filters( 'wp_signature_hosts', array( 'wordpress.org', 'downloads.wordpress.org', 's.w.org' ) );

注意事项

使用此过滤器时,应确保添加的主机名是可信的,以避免安全风险。修改主机列表可能影响文件下载的验证流程。


📄 原文内容

Filters the list of hosts which should have Signature Verification attempted on.

Parameters

$hostnamesstring[]
List of hostnames.

Source

$signed_hostnames = apply_filters( 'wp_signature_hosts', array( 'wordpress.org', 'downloads.wordpress.org', 's.w.org' ) );

Changelog

Version Description
5.2.0 Introduced.