WordPress HTMLブロックエスケープ関数esc_html

Last Updated: 2016 年 12 月 20 日 댓글

esc_html()関数

esc_html()関数は、 WordPressで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>

参考までに、リンクコードは通常、HTMLでは次のようにリンクとして表示されます。

リンク

Note

'esc_html'フィルタを使用します。

추가

上記の内容は、 WordPress 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 = 링크

エスケープ処理をしたときとそうでない場合の違いを知ることができでしょう? テストは例えば、使用中 WordPress テーマ関数ファイルの footer.php ファイルや header.phpの など適切なファイルを開いて、上記のコードを適切な場所に入れてみるとされます。

メモ:


コメントを残す

コメント