2024年07月01日

1.WPのエスケープ処理


ここではWordPressでデータをechoする場合の注意事項を下記で解説しています。

1.エスケープ処理の必要性

2.エスケープ処理の基本的な考え方

3.WordPressで用意されているエスケープ関数

 

1.エスケープ処理の必要性

WordPressは、PHPで記述されたプログラムをHMTLに変換してデバイスに送信します。

一方、デバイス側のブラウザは、このHTML言語を解釈し画面を生成して表示します。

この画面に入力欄があり、利用者がここに悪意を持って危険なスクリプトを入力し、WordPress側でこれを単純にechoすると、危険なスクリプトが動く脅威が発生します。

これを回避するのがエスケープ処理で、echoする前にこの処理を行う事で、この脅威を回避します。

 

更に、ターゲットは入力欄だけでなくチェックボックス等でも同じで、プログラムを使えば簡単にチェックボックスに危険なスクリプトを書くことができます。

またWordPressのDBのデータをechoする場合も、DBの中にこの様な危険なコードが書かれてない保証はありません。

 

そこでWordPressでは、echoコマンドを使う場合は適切な方法でデータをエスケープ処理(無害化)する事を求めており、幾つかの関数が用意されています。

 

2.エスケープ処理の基本的な考え方

WordPressのエスケープ処理は、出力文字の中にある下記の[記号]を[文字コード]に変換したり、削除する処理になります。

危険なコードとは下記の様なコードです。

記号 文字コード 読み方
< &lt; 小なり
> &gt; 大なり
' &#39; シングルクォーテーション
" &quot; ダブルクォーテーション
& &amp; アンパサンド

<> は、HTMLのタグを囲む記号です。

これを &lt;&gt; に変換してechoすると、これはHTMLタグではなく文字の <> として表示されます。

この様にブラウザから戻ってきたデータやDBの値を表示するデータにはHTMLタグが無い様に処理するのがエスケープ処理です。

 

3.WordPressで用意されているエスケープ関数

WordPressでは下記の様なエスケープ関数を用意しています。

関数 解説
esc_html() 一般的な文字列に利用するエスケープ処理(無害化)関数です。
esc_html_e() echo esc_html()の代わりとして使える翻訳関数です。
esc_url() URLをエスケープ処理(無害化)する関数です。
esc_attr() HTML要素の属性値のエスケープ処理(無害化)する関数です。

 

 


関数一覧
  • 1.WPのエスケープ処理
  • 2.WPプログラムの基本
  • 3.ヘッダ/フッタ/サイドバで使われる関数
  • 4.DBからの読込関数
  • 5.一般テンプレートの中で使われる関数
  • 6.その他のWP関数
  • add_shortcode()
  • bloginfo()
  • body_class()
  • date_i18n()
  • dynamic_sidebar()
  • edit_post_link()
  • esc_attr()
  • esc_html_e()
  • esc_html()
  • esc_url()
  • get_ancestors()
  • get_cat_ID()
  • get_cat_name()
  • get_category_link()
  • get_category_parents()
  • get_category()
  • get_footer()
  • get_header()
  • get_home_url()
  • get_post_format()
  • get_post_meta()
  • get_post_thumbnail_id()
  • get_query_var()
  • get_search_query()
  • get_sidebar()
  • get_site_url()
  • get_stylesheet_directory_uri()
  • get_stylesheet_uri()
  • get_template_directory_uri()
  • get_template_part()
  • get_the_category()
  • get_the_content()
  • get_the_date()
  • get_the_excerpt()
  • get_the_ID()
  • get_the_modified_date()
  • get_the_modified_time()
  • get_the_permalink()
  • get_the_post_thumbnail()
  • get_the_tags()
  • get_the_time()
  • get_the_title()
  • get_uploaded_header_images()
  • get_year_link()
  • has_category()
  • has_custom_logo()
  • has_header_image()
  • has_header_video()
  • has_nav_menu()
  • has_post_thumbnail()
  • has_tag()
  • header_image()
  • home_url()
  • is_admin()
  • is_category()
  • is_date()
  • is_front_page()
  • is_home()
  • is_main_query()
  • is_page()
  • is_search()
  • is_single()
  • language_attributes()
  • the_category()
  • the_content()
  • the_custom_header_markup()
  • the_custom_logo()
  • the_date()
  • the_excerpt()
  • the_ID()
  • the_modified_date()
  • the_modified_time()
  • the_permalink()
  • the_post_thumbnail()
  • the_search_query()
  • the_tags()
  • the_time()
  • the_title()
  • update_post_meta()
  • wp_get_attachment_image_src()
  • wp_nav_menu()
  • WP_Query()