esc_html( string $text )

Escaping for HTML blocks.


Description Description


Parameters Parameters

$text

(string) (Required)


Top ↑

Return Return

(string)


Top ↑

Source Source

File: wp-includes/formatting.php

function esc_html( $text ) {
	$safe_text = wp_check_invalid_utf8( $text );
	$safe_text = _wp_specialchars( $safe_text, ENT_QUOTES );
	/**
	 * Filters a string cleaned and escaped for output in HTML.
	 *
	 * Text passed to esc_html() is stripped of invalid or special characters
	 * before output.
	 *
	 * @since 2.8.0
	 *
	 * @param string $safe_text The text after it has been escaped.
	 * @param string $text      The text prior to being escaped.
	 */
	return apply_filters( 'esc_html', $safe_text, $text );
}

Top ↑

Changelog Changelog

Changelog
Version Description
2.8.0 Introduced.


Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    Contributed by Codex

    Examples

    $html = esc_html( '<a href="http://www.example.com/">A link</a>' );
    

    $html now contains this:

    &lt;a href=&quot;http://www.example.com/&quot;&gt;A link&lt;/a&gt;
    

    which would be displayed in an HTML document as:

    <a href="A" rel="nofollow">http://www.example.com/">A link</a>

    Instead of like this:

    A link

You must log in before being able to contribute a note or feedback.