esc_url()URL 过滤

目录

描述

主要用于 URL 过滤:

  1. 拒绝不是下面协议的 URL (defaulting to http, https, ftp, ftps, mailto, news, irc, gopher, nntp, feed, and telnet)
  2. 消除无效字符和删除危险字符。
  3. 将字符转换成 HTML 实体,并且将 & 和 单引号(') 转换成数字实体:&#038, &#039。

esc_url() 描述

用法

<?php esc_url$url$protocols$_context ); ?>

esc_url() 用法

参数

$url

(string) (必填) 将要被 理过 的 URL

默认值: None

$protocols

(array) (可选) 可 接受 议的数组,如果没有设 ,默 是:'http', 'https', 'ftp', 'ftps', 'mailto', 'news', 'irc', 'gopher', 'nntp', 'feed', 'telnet'。

默认值: null

$_context

(string) (可选) 如何返回 URL。

默认值: 'display'

esc_url() 参数

返回值

(string) 

The cleaned $url after the 'esc_url' filter is applied. An empty string is returned if $url specifies a protocol other than those in $protocols, or if $url contains an empty string.

已经 理过滤的 URL

esc_url() 返回值

示例

Adding a link to home

As featured in the Twenty Thirteen theme, although simplified for the sake of the example

esc_url() 示例

注意

  • 开发者可以 过 cleaned_url 这个 filter 接口对返  $url 进行再次过滤。
  • esc_url() 注意

    源文件

    esc_url() 函数的代码位于 wp-includes/formatting.php.

    esc_url() 源文件

    相关