clean_url

函数


clean_url ( $url, $protocols = null, $context = 'display' )
参数
  • (string)
    $url
    The URL to be cleaned.
    Required:
  • (array)
    $protocols
    Optional. An array of acceptable protocols.
    Required:
    Default: null
  • (string)
    $context
    Optional. How the URL will be used. Default is ‘display’.
    Required:
    Default: ‘display’
返回值
  • (string) The cleaned $url after the {@see ‘clean_url’} filter is applied.
相关
  • esc_url()
定义位置
  • wp-includes/deprecated.php
    , line 2042
引入
1.2.0
弃用
3.0.0

Checks and cleans a URL.

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

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