esc_url()

检查并清除URL。

原型

esc_url( string $url, array $protocols = null, string $_context = 'display' )

描述

从URL中删除了许多字符。如果URL用于显示（默认行为），也会替换＆符号。 ‘clean_url’过滤器应用于返回的已清理URL。

参数

$url (string) (Required) 要清理的URL。

$protocols (array) (Optional)  一系列可接受的协议。默认返回wp_allowed_protocols（）的值

$_context (string) (Optional) 私人的。使用esc_url_raw（）进行数据库使用。

返回值

(string)  之后清理过的$ url

源文件

路径：wp-includes/formatting.php

<?php
...
function esc_url( $url, $protocols = null, $_context = 'display' ) {
	$original_url = $url;
	if ( '' == $url )
		return $url;
	$url = str_replace( ' ', '%20', $url );
	$url = preg_replace('|[^a-z0-9-~+_.?#=!&;,/:%@$|*'()[]\x80-\xff]|i', '', $url);
	if ( '' === $url ) {
		return $url;
	}
	if ( 0 !== stripos( $url, 'mailto:' ) ) {
		$strip = array('%0d', '%0a', '%0D', '%0A');
		$url = _deep_replace($strip, $url);
	}
	$url = str_replace(';//', '://', $url);
	/* If the URL doesn't appear to contain a scheme, we
	 * presume it needs http:// prepended (unless a relative
	 * link starting with /, # or ? or a php file).
	 */
	if ( strpos($url, ':') === false && ! in_array( $url[0], array( '/', '#', '?' ) ) &&
		! preg_match('/^[a-z0-9-]+?.php/i', $url) )
		$url = 'http://' . $url;
	// Replace ampersands and single quotes only when displaying.
	if ( 'display' == $_context ) {
		$url = wp_kses_normalize_entities( $url );
		$url = str_replace( '&amp;', '&#038;', $url );
		$url = str_replace( "'", '&#039;', $url );
	}
	if ( ( false !== strpos( $url, '[' ) ) || ( false !== strpos( $url, ']' ) ) ) {
		$parsed = wp_parse_url( $url );
		$front  = '';
		if ( isset( $parsed['scheme'] ) ) {
			$front .= $parsed['scheme'] . '://';
		} elseif ( '/' === $url[0] ) {
			$front .= '//';
		}
		if ( isset( $parsed['user'] ) ) {
			$front .= $parsed['user'];
		}
		if ( isset( $parsed['pass'] ) ) {
			$front .= ':' . $parsed['pass'];
		}
		if ( isset( $parsed['user'] ) || isset( $parsed['pass'] ) ) {
			$front .= '@';
		}
		if ( isset( $parsed['host'] ) ) {
			$front .= $parsed['host'];
		}
		if ( isset( $parsed['port'] ) ) {
			$front .= ':' . $parsed['port'];
		}
		$end_dirty = str_replace( $front, '', $url );
		$end_clean = str_replace( array( '[', ']' ), array( '%5B', '%5D' ), $end_dirty );
		$url       = str_replace( $end_dirty, $end_clean, $url );
	}
	if ( '/' === $url[0] ) {
		$good_protocol_url = $url;
	} else {
		if ( ! is_array( $protocols ) )
			$protocols = wp_allowed_protocols();
		$good_protocol_url = wp_kses_bad_protocol( $url, $protocols );
		if ( strtolower( $good_protocol_url ) != strtolower( $url ) )
			return '';
	}
	/**
	 * Filters a string cleaned and escaped for output as a URL.
	 *
	 * @since 2.3.0
	 *
	 * @param string $good_protocol_url The cleaned URL to be returned.
	 * @param string $original_url      The URL prior to cleaning.
	 * @param string $_context          If 'display', replace ampersands and single quotes only.
	 */
	return apply_filters( 'clean_url', $good_protocol_url, $original_url, $_context );
}
...
?>

其他

英文文档：https://developer.wordpress.org/reference/functions/esc_url/