On this page
clean_url( string $url, array $protocols = null, string $context = 'display' ): string
This function has been deprecated. Use esc_url() instead.
Checks and cleans a URL.
Description
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.
See also
Parameters
$urlstring Required-
The URL to be cleaned.
$protocolsarray Optional-
An array of acceptable protocols.
Default:
null $contextstring Optional-
How the URL will be used. Default is
'display'.Default:
'display'
Return
string The cleaned $url after the 'clean_url' filter is applied.
Source
File: wp-includes/deprecated.php. View all references
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 );
}
Related
Uses
| Uses | Description |
|---|---|
| esc_url() wp-includes/formatting.php | Checks and cleans a URL. |
| _deprecated_function() wp-includes/functions.php | Marks a function as deprecated and inform when it has been used. |
Changelog
© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/clean_url