функция
Устаревший since 1.2.0
clean_url()
Устаревшее.
Помечено устаревшим с версии 3.0.0.
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
clean_url( string $url, array $protocols = null, string $context = 'display' ): stringОписание
Из URL удаляется ряд символов. Если URL предназначен для отображения (поведение по умолчанию), то амперсанды также заменяются. К возвращаемому очищенному URL применяется фильтр 'clean_url'.
См. alsoesc_url()
Параметры
$url
string
обязательный
URL, который нужно очистить.
$protocols
array
необязательный
= null
Массив допустимых протоколов.
$context
string
необязательный
= 'display'
Как будет использоваться URL. Значение по умолчанию — 'display'.
Возвращаемое значение
string
'clean_url'
Исходный код
wp-includes/deprecated.php:2047
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 );
}История изменений
| Версия | Описание |
|---|---|
| 3.0.0 | Deprecated. Use esc_url() |
| 1.2.0 | Introduced. |
