워드프레스 HTML 블록 이스케이프 함수 esc_html

esc_html() 함수

esc_html() 함수는 워드프레스에서 HTML 블록을 이스케이프(Escape)하는 데 사용됩니다.

사용법 및 파라미터(매개변수)

사용법

<?php esc_html( $text ) ?>

파라미터

$text
(string) (필수) 이스케이프 처리할 텍스트
기본값: 없음

반환 값

HTML (string)

이스케이프 처리된 HTML 문자열

예제(용례)

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

이제 $html에는 다음 HTML 문자열이 저장됩니다:

&lt;a href=&quot;http://www.example.com/&quot;&gt;링크&lt;/a&gt;

HTML 문서에서는 다음과 같이 문자열 그대로 표시됩니다:

<a href="http://www.example.com/">링크</a>

참고로 일반적으로 <a href="http://www.example.com/">링크</a> 코드는 HTML에서는 다음과 같이 링크로 표시됩니다.

링크

Note

'esc_html' 필터를 사용합니다.

추가

위의 내용은 워드프레스 Codex 문서의 내용을 거의 그대로 한글로 옮긴 것입니다.

escape에 대한 개념은 MS 문서를 참고해보시기 바랍니다.

직접 이 함수를 실행시켜보면 쉽게 이해가 가능할 것입니다.

예를 들어,

<?php
$html1= esc_html( '<a href="http://www.example.com/">링크</a>' );
$html2 = '<a href="http://www.example.com/">링크</a>';
echo 'html = ' . $html  . '<br>';
echo 'html2 = '. $html2 . '<br>';
?>

위의 코드를 직접 실행시켜 보면 다음과 같이 출력됩니다.

html1 = <a href="http://www.example.com/">링크</a>
html2 = 링크

이스케이프 처리를 했을 때와 그렇지 않을 경우의 차이를 알 수가 있겠죠? 테스트는 가령 사용 중인 워드프레스 테마 함수 파일의 footer.php 파일이나 header.php 등 적당한 파일을 열고 위의 코드를 적당한 위치에 넣어보면 됩니다.

참고:

WPMU 함수 get current site