clean_url() - WordPress 函数参考中文文档

返回介绍

clean_url()

发布于 2017-09-10 字数1949 浏览 1026 评论 0

Warning: This function has been deprecated. Use esc_url() instead.

clean_url( string $url,  array $protocols = null,  string $context = 'display' )

Checks and cleans a URL.


描述

A number of characters are removed from the URL. If the URL is for displaying (the default behaviour) ampersands are also replaced. The ‘clean_url’ filter is applied to the returned cleaned URL.


参数

$url

(string)
(Required)
The URL to be cleaned.

$protocols

(array)
(Optional)
An array of acceptable protocols.

Default value: null

$context

(string)
(Optional)
How the URL will be used. Default is ‘display’.

Default value: ‘display’


返回值

(string) The cleaned $url after the ‘clean_url’ filter is applied.


源代码

File: wp-includes/deprecated.php

function clean_url( $url, $protocols = null, $context = 'display' ) {
	if ( $context == 'db' )
		_deprecated_function( 'clean_url( $context = \'db\' )', '3.0.0', 'esc_url_raw()' );
	else
		_deprecated_function( __FUNCTION__, '3.0.0', 'esc_url()' );
	return esc_url( $url, $protocols, $context );
}

更新日志

Version 描述
3.0.0 Use esc_url()
1.2.0 Introduced.

相关函数

Uses

  • wp-includes/formatting.php:
    esc_url()
  • wp-includes/functions.php:
    _deprecated_function()

User Contributed Notes

上一篇:clean_term_cache()

下一篇:clean_user_cache()

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!