php函数clean(),wordpress函数clean_url()用法示例

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