PHPのhtmlspecialchars_decode()関数の使い方｜構文・パラメータ・使用例を解説

htmlspecialchars_decode() 関数は、特殊なHTMLエンティティを元の文字へと変換（デコード）するために使用します。htmlspecialchars() でエンコードした文字列を元に戻したい場合などに活用できる便利な関数です。

この関数でデコードされる主なHTMLエンティティは以下のとおりです。

• & → &（アンパサンド）

• " → "（ダブルクォート）

• ' → '（シングルクォート）

• < → <（小なり記号）

• > → >（大なり記号）

構文

htmlspecialchars_decode(str, flags)

パラメータ

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

• flags − クォートの扱い方や、使用するドキュメントタイプを指定します（省略可能）。

クォートに関するフラグ

• ENT_COMPAT − デフォルト。ダブルクォートのみをデコードします。

• ENT_QUOTES − ダブルクォートとシングルクォートの両方をデコードします。

• ENT_NOQUOTES − クォートを一切デコードしません。

ドキュメントタイプに関するフラグ

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

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

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

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

戻り値

デコード後の文字列を返します。

使用例

<?php
$s = "<p>this -&gt; &quot;keyword&quot; in programming language</p>";
echo htmlspecialchars_decode($s);
echo "\n";
echo htmlspecialchars_decode($s, ENT_NOQUOTES);
?>

実行結果は以下のとおりです。

出力

<p>this -> "keyword" in programming language</p>
<p>this -&gt; &quot;keyword&quot; in programming language</p>

1行目の出力では、すべてのエンティティがデコードされ、矢印記号やクォートが本来の形で表示されています。一方、ENT_NOQUOTES を指定した2行目では、クォート以外のエンティティのみがデコードされ、" がそのまま残っていることがわかります。

なお、逆に通常の文字をHTMLエンティティへ変換（エンコード）したい場合は、htmlspecialchars() 関数を使用します。両者はセットで覚えておくと、フォーム入力値の表示処理やXSS対策などの実装に役立ちます。