esc_url_raw() WP 2.8.0

Очищает URL для безопасного использования в запросе к БД, при редиректах и HTTP запросах. Не очищает для безопасного вывода на экран.

Не используйте эту функцию, если УРЛ выводится в HTML коде (на экран), используйте esc_url() - она заменяет HTML сущности - это защитит от XSS атак.

Хуков нет.

Возвращает

Строку, очищенный URL. Вернет пустую строку, если в УРЛ указан неуказанный в $protocols протокол.

Использование

esc_url_raw( $url, $protocols );

$url(строка) (обязательный)

УРЛ, который нужно очистить.

$protocols(массив)

Массив допустимых протоколов. Если не установлено, то: http, https, ftp, ftps, mailto, news, irc, gopher, nntp, feed, telnet.
По умолчанию: null

Примеры

#1 Демонстрация работы

$url = 'http://site.org?foo=<script> / нечто не </script> ';

echo esc_url_raw( $url );
// http://site.org?foo=script/нечтоне/script

echo esc_url( $url );
// http://site.org?foo=script/нечтоне/script

#2 Очистка УРЛ перед использованием в запросе

$url = 'http://wordpress.org';
$response = wp_remote_get( esc_url_raw( $url ) ); // не нужно очищать сущности
if ( ! is_wp_error( $response ) ) {
	echo wp_remote_retrieve_body( $response );
}

#2 Неправильное использование

<!-- ОШИБКА! Нужно использовать esc_url! -->
<img src='<?php echo esc_url_raw( $url ); ?>' />
<a href='<?php echo esc_url_raw( $url ); ?>'>WordPress</a>

Код esc_url_raw: wp-includes/formatting.php ^{VER 5.0.1}

<?php
function esc_url_raw( $url, $protocols = null ) {
	return esc_url( $url, $protocols, 'db' );
}

Cвязанные функции

Из метки: esc_ (очистка валидация)

Еще из раздела: Очистка данных