PHPのhtml_entity_decode()関数とは？使い方とパラメータを徹底解説

PHPのhtml_entity_decode()関数は、HTMLエンティティ（実体参照）を対応する本来の文字に変換するために使用される関数です。たとえば「&lt;」や「&amp;」のようなエンティティを、それぞれ「<」や「&」といった実際の文字へ戻すことができます。

基本構文

html_entity_decode(str, flags, character-set)

パラメータ

• str − デコード対象となる文字列を指定します。

• flags − 引用符（クォート）の扱い方やドキュメントタイプを指定します。

引用符のスタイル

• ENT_COMPAT − デフォルト。二重引用符のみをデコードします。

• ENT_QUOTES − 二重引用符と一重引用符の両方をデコードします。

• ENT_NOQUOTES − 引用符は一切デコードしません。

ドキュメントタイプ関連のフラグ

• ENT_HTML401 − デフォルト。コードを HTML 4.01 として処理します。

• ENT_HTML5 − コードを HTML 5 として処理します。

• ENT_XML1 − コードを XML 1 として処理します。

• ENT_XHTML − コードを XHTML として処理します。

• character-set − 使用する文字セットを指定する文字列です。

指定可能な文字セットの一覧

• UTF-8 − デフォルト。ASCII互換のマルチバイト8ビットUnicode。

• ISO-8859-1 − 西ヨーロッパ言語。

• ISO-8859-15 − 西ヨーロッパ言語（ISO-8859-1にユーロ記号やフランス語・フィンランド語の文字を追加したもの）。

• cp866 − DOS専用のキリル文字セット。

• cp1251 − Windows専用のキリル文字セット。

• cp1252 − Windows用の西ヨーロッパ文字セット。

• KOI8-R − ロシア語。

• BIG5 − 繁体字中国語（主に台湾で使用）。

• GB2312 − 簡体字中国語の国家標準文字セット。

• BIG5-HKSCS − Big5に香港拡張を加えたもの。

• Shift_JIS − 日本語。

• EUC-JP − 日本語。

• MacRoman − Mac OSで使用されていた文字セット。

戻り値

html_entity_decode()関数は、変換後の文字列を返します。

使用例

以下に具体的なコード例を示します。

<?php
$orig = "We've all the <b>books</b>!";
$one = htmlentities($orig);
$two = html_entity_decode($one);
echo $one;
echo $two;
?>

この例では、まずhtmlentities()関数で元の文字列をHTMLエンティティに変換し、その後html_entity_decode()で元に戻しています。

出力結果

We've all the <b>books</b>!We've all the books!

1行目はエンティティ化された文字列がそのまま表示され、2行目ではエンティティがデコードされ、「books」が太字として表示されていることがわかります。