関数・クラス解説

htmlspecialchars_decode

version:PHP 5 >= 5.1.0, PHP 7 (公式)

HTMLエンティティに変換されている特殊文字を元に戻す(デコード)

フォーマット

string : htmlspecialchars_decode ( string $string [, int $flags = ENT_COMPAT | ENT_HTML401 ] )

パラメータ

string $string (必須)
デコードする文字列

int $flags = ENT_COMPAT | ENT_HTML401
デコードする特殊文字とドキュメント形式の組み合わせを指定する。デフォルトは ENT_COMPAT | ENT_HTML401。利用可能な定数は以下を参照してください。

使用可能な flags 定数
定数名説明
ENT_COMPATダブルクォートを変換し、シングルクォートはそのままにします。
ENT_QUOTESダブルクォート、シングルクォートの両方を変換します。
ENT_NOQUOTESダブルクォート、シングルクォートの両方をそのままにします。
ENT_HTML401コードを HTML 4.01 として処理します。
ENT_XML1コードを XML 1 として処理します。
ENT_XHTMLコードを XHTML として処理します。
ENT_HTML5コードを HTML 5 として処理します。


返値 string
元の文字にデコードされた文字列を返します

解説

エンコードされた特殊な文字をデコードして元の状態に戻します。この関数の逆の動きをするのがhtmlspecialchars()です。
変換対象のエンティティは以下となります。
&
" (ENT_NOQUOTES が設定されていない場合)
' (ENT_QUOTES が設定されている場合)
< および >

記述サンプル

//PHP 7.4.6で実行
$str='&lt;a href=&quot;aiueo&quot;&gt;あいうえお&lt;/a&gt;';

//実行
echo htmlspecialchars_decode($str);

//結果
//<a href="aiueo">あいうえお</a>

//ENT_NOQUOTES でクォートを除外する設定
echo htmlspecialchars_decode($str, ENT_NOQUOTES);

//結果 クォート以外は元に戻る
<a href=&quot;aiueo&quot;>あいうえお</a>

参考リンク

get_html_translation_table htmlspecialchars() および htmlentities() で用いられるエンティティの変換テーブルを配列で返す
html_entity_decode HTMLエンティティを元の文字にデコードする
htmlspecialchars 特殊な文字をHTMLエンティティに変換する

タグ

HTML エンティティ エンコード デコード 変換 特殊文字 String 文字列


公式リファレンス

書式

htmlspecialchars_decode ( string $string [, int $flags = ENT_COMPAT | ENT_HTML401 ] ) : string

説明

この関数は htmlspecialchars() の反対です。 特殊な HTML エンティティを文字に戻します。

変換されるエンティティは次のものです。&amp;、 &quot; (ENT_NOQUOTES が設定されていない場合)、 &#039; (ENT_QUOTES が設定されている場合)、 &lt; および &gt;。

パラメータ

string
デコードする文字列。
flags
以下のフラグのビットマスクによる組み合わせで、クォートの扱いやドキュメントの形式を指定します。 デフォルトは ENT_COMPAT | ENT_HTML401 です。
使用可能な flags 定数
定数名 説明
ENT_COMPAT ダブルクォートを変換し、シングルクォートはそのままにします。
ENT_QUOTES ダブルクォート、シングルクォートの両方を変換します。
ENT_NOQUOTES ダブルクォート、シングルクォートの両方をそのままにします。
ENT_HTML401 コードを HTML 4.01 として処理します。
ENT_XML1 コードを XML 1 として処理します。
ENT_XHTML コードを XHTML として処理します。
ENT_HTML5 コードを HTML 5 として処理します。

返値

デコードされた文字列を返します。

サンプル

例1 htmlspecialchars_decode() の例

$str = "

this -> "

\n"; echo htmlspecialchars_decode($str); // クォートが変換されないことに注意しましょう echo htmlspecialchars_decode($str, ENT_NOQUOTES);

上の例の出力は以下となります。

<p>this -> "</p> <p>this -> &quot;</p>

参考

  • htmlspecialchars() - 特殊文字を HTML エンティティに変換する
  • html_entity_decode() - HTML エンティティを対応する文字に変換する
  • get_html_translation_table() - htmlspecialchars および htmlentities で使用される変換テーブルを返す
  • ワード検索


    ※入力キーワードが、関数名・説明文・タグに含まれるものを検索

    関数名アルファベット別

    A B C D E F G H I J
    K L M N O P Q R S T
    U V W X Y Z _

    最終更新一覧

    stristr
     大文字小文字を区別せず文字列を検索し、ヒット箇所以降(あるいは以前)の文字列を返却

    stripslashes
     バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く

    stripos
     大文字小文字を区別せずに文字列が最初に現れる位置を取得する

    stripcslashes
     addcslashes() でクォートされた文字列をアンクォートする

    strip_tags
     文字列から HTML と PHP のタグを除去して返却

    strcspn
     指定した文字が最初に現れる位置を調べる

    strcoll
     ロケールに基づいて2つの文字列を比較し同じか(あるいは大小)を判定する

    strcmp
     2つの文字列を比較し同じか(あるいは大小)を判定する

    strchr
     strstr() のエイリアス

    strcasecmp
     2つの文字列を比較(大文字小文字を区別せず同じとみなす)

    カテゴリー一覧

    PHP の振る舞いの変更
    音声フォーマットの操作
    認証サービス
    コマンドライン関連
    圧縮およびアーカイブ
    暗号
    データベース関連
    日付および時刻関連
    ファイルシステム
    自然言語および文字エンコーディング
    画像処理および作成
    メール関連
    数学
    テキスト以外の MIME 型
    プロセス制御
    その他の基本モジュール
    その他のサービス
    検索エンジン用の拡張モジュール
    サーバー固有のモジュール
    セッション関連
    テキスト処理
    変数・データ型関連
    ウェブサービス
    Windows 用のモジュール
    XML 操作
    GUI用の拡張モジュール