常用函数-clean_url()

说明

查看并过滤URL。

URL中若干字符被删除。如果URL用于在文本中显示链接地址，URL中的&号也会被替换。clean_url对返回的已过滤URL进行再次过滤。

用法

<?php clean_url( $url, $protocols, $context ) ?>

参数

$url

（字符串）（必需）即将被过滤的URL

默认值：None

$protocols

（数组）（可选）由可接收协议组成的数组。如果不事先设置，默认值可以是’http’, ‘https’, ‘ftp’, ‘ftps’, ‘mailto’, ‘news’, ‘irc’, ‘gopher’, ‘nntp’, ‘feed’, ‘telnet’中任一个。

默认值：null

$context

（字符串）（可选）URL的用途。

默认值：’display’

返回的值

（字符串）

应用’cleaned_url’过滤器后的$url。

示例

注释

• 用法：如果在$protocols中进行设置，wp_kses_bad_protocol() 函数只允许协议字符，而如果在函数中进行设置，wp_kses_bad_protocol()可允许通用字符。

修改记录

自1.2.0版本后

源文件

clean_url()位于 wp-includes/formatting.php.中。

分类：中文手册