wp_safe_redirect_fallback
云策文档标注
概述
wp_safe_redirect_fallback 是一个 WordPress 过滤器钩子,用于在提供的重定向 URL 不安全(非本地)时,自定义回退 URL。它允许开发者修改默认的回退 URL,通常用于安全重定向场景。
关键要点
- 这是一个过滤器钩子,用于处理不安全重定向时的回退 URL。
- 接受两个参数:$fallback_url(回退 URL 字符串)和 $status(HTTP 响应状态码)。
- 默认回退 URL 是 admin_url(),但可以通过此钩子进行自定义。
- 与 wp_safe_redirect() 函数相关,用于执行安全(本地)重定向。
- 在 WordPress 4.3.0 版本中引入。
代码示例
$fallback_url = apply_filters( 'wp_safe_redirect_fallback', admin_url(), $status );
原文内容
Filters the redirect fallback URL for when the provided redirect is not safe (local).
Parameters
$fallback_urlstring-
The fallback URL to use by default.
$statusint-
The HTTP response status code to use.
Source
$fallback_url = apply_filters( 'wp_safe_redirect_fallback', admin_url(), $status );
Changelog
| Version | Description |
|---|---|
| 4.3.0 | Introduced. |