PHP get_html_translation_table() 関数

htmlspecialchars 関数が使用する翻訳テーブルを出力します:

<?php
print_r (get_html_translation_table()); // HTML_SPECIALCHARS がデフォルト
?>

実行例

定義と用法

get_html_translation_table() 関数が返します htmlentities() および htmlspecialchars() 関数が使用する翻訳テーブル。

ヒント:一部の文字は複数の方法でエンコードできます。get_html_translation_table() 関数は最も一般的なエンコードを返します。

文法

get_html_translation_table(function,flags,character-set)
引数 説明
function

オプション。どの翻訳テーブルを返すかを指定します。

可能の値:

  • HTML_SPECIALCHARS - デフォルト。HTMLページで正しく表示されるようにURLエンコードが必要な文字を翻訳します。
  • HTML_ENTITIES - HTMLページで正しく表示されるようにURLエンコードが必要な全ての文字を翻訳します。
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オペレーティングシステムで使用される文字セット

注釈:PHP 5.4以前のバージョンでは、認識できない文字セットは無視され、ISO-8859-1で置き換わります。PHP 5.4からは、認識できない文字セットは無視され、UTF-8で置き換わります。

技術的詳細

返り値: 翻訳テーブルを配列形式で返します。オリジナルの文字がキー名、エンティティがキー値です。
PHP バージョン: 4+

更新ログ:

バージョン 説明
PHP 5 character-set デフォルトのパラメータの値が UTF-8 に変更されました。
PHP 5.4

翻訳テーブルが適用されるドキュメントの種類を定義するために追加のフラグが追加されました:

  • ENT_HTML401
  • ENT_HTML5
  • ENT_XML1
  • ENT_XHTML
PHP 5.3.4 追加されました character-set パラメータ。

さらに例

HTML_SPECIALCHARS の翻訳表:

<?php
print_r (get_html_translation_table(HTML_SPECIALCHARS));
?>

表示文字とエンティティの名前:

Array
(
  ["] => "
  [&] => &
  [<] => <
  [>] => >
)

例 2

HTML_ENTITIES の翻訳表:

<?php
print_r (get_html_translation_table(HTML_ENTITIES));
?>

表示文字とエンティティの名前:

Array
(
  ["] => "
  [&] => &
  [<] => <
  [>] => >
  [ ] =>  
  [?] => ¡
  [?] => ¢
  [?] => £
  [?] => ¤
  [?] => ¥
  [?] => ¦
  [?] => §
  [?] => ¨
  [?] => ©
  [?] => ª
  [?] => «
  [?] => ¬
  [?] => ­
  [?] => ®
  [?] => ¯
  [?] => °
  [?] => ±
  [?] => ²
  [?] => ³
  [?] => ´
  [?] => µ
  [?] => ¶
  [?] => ·
  [?] => ¸
  [?] => ¹
  [?] => º
  [?] => »
  [?] => ¼
  [?] => ½
  [?] => ¾
  [?] => ¿
  [?] => À
  [?] => Á
  [?] => Â
  [?] => Ã
  [?] => Ä
  [?] => Å
  [?] => Æ
  [?] => Ç
  [?] => È
  [?] => É
  [?] => Ê
  [?] => Ë
  [?] => Ì
  [?] => Í
  [?] => Î
  [?] => Ï
  [?] => Ð
  [?] => Ñ
  [?] => Ò
  [?] => Ó
  [?] => Ô
  [?] => Õ
  [?] => Ö
  [?] => ×
  [?] => Ø
  [?] => Ù
  [?] => Ú
  [?] => Û
  [?] => Ü
  [?] => Ý
  [?] => Þ
  [?] => ß
  [?] => à
  [?] => á
  [?] => â
  [?] => ã
  [?] => ä
  [?] => å
  [?] => æ
  [?] => ç
  [?] => è
  [?] => é
  [?] => ê
  [?] => ë
  [?] => ì
  [?] => í
  [?] => î
  [?] => ï
  [?] => ð
  [?] => ñ
  [?] => ò
  [?] => ó
  [?] => ô
  [?] => õ
  [?] => ö
  [?] => ÷
  [?] => ø
  [?] => ù
  [?] => ú
  [?] => û
  [?] => ü
  [?] => ý
  [?] => þ
  [?] => ÿ
  [?] => Œ
  [?] => œ
  [?] => Š
  [?] => š
  [?] => Ÿ
  [?] => ƒ
  [?] => Â
  [?] => ˜
  [Α] => Α
  [Β] => Β
  [Γ] => Γ
  [Δ] => Δ
  [Ε] => Ε
  [Ζ] => Ζ
  [Η] => Η
  [Θ] => Θ
  [Ι] => Ι
  [Κ] => Κ
  [Λ] => Λ
  [Μ] => Μ
  [Ν] => Ν
  [Ξ] => Ξ
  [Ο] => Ο
  [Π] => Π
  [Ρ] => Ρ
  [Σ] => Σ
  [Τ] => Τ
  [Υ] => Υ
  [Φ] => Φ
  [Χ] => Χ
  [Ψ] => Ψ
  [Ω] => Ω
  [α] => α
  [β] => β
  [γ] => γ
  [δ] => δ
  [ε] => ε
  [ζ] => ζ
  [η] => η
  [θ] => θ
  [ι] => ι
  [κ] => κ
  [λ] => λ
  [μ] => μ
  [ν] => ν
  [ξ] => ξ
  [ο] => ο
  [π] => π
  [ρ] => ρ
  [?] => ς
  [σ] => σ
  [τ] => τ
  [υ] => υ
  [φ] => φ
  [χ] => χ
  [ψ] => ψ
  [ω] => ω
  [?] => ϑ
  [?] => ϒ
  [?] => ϖ
  [?] =>  
  [?] =>
  [?] =>  
  [?] => ‌
  [?] => ‍
  [?] => ‎
  [?] => ‏
  [?] => –
  [?] => —
  [?] => ‘
  [?] => ’
  [?] => ‚
  [?] => “
  [?] => ”
  [?] => „
  [?] => †
  [?] => ‡
  [?] => •
  [?] => …
  [?] => ‰
  [′] => ′
  [″] => ″
  [?] => ‹
  [?] => ›
  [ ̄] => ‾
  [?] => ⁄
  [?] => €
  [?] => ℑ
  [?] => ℘
  [?] => ℜ
  [?] => ™
  [?] => ℵ
  [←] => ←
  [↑] => ↑
  [→] => →
  [↓] => ↓
  [?] => ↔
  [?] => ↵
  [?] => ⇐
  [?] => ⇑
  [?] => ⇒
  [?] => ⇓
  [?] => ⇔
  [?] => ∀
  [?] => ∂
  [?] => ∃
  [?] => ∅
  [?] => ∇
  [∈] => ∈
  [?] => ∉
  [?] => ∋
  [∏] => ∏
  [∑] => ∑
  [?] => −
  [?] => ∗
  [√] => √
  [∝] => ∝
  [∞] => ∞
  [∠] => ∠
  [∧] => ∧
  [∨] => ∨
  [∩] => ∩
  [∪] => ∪
  [∫] => ∫
  [∴] => ∴
  [~] => ∼
  [?] => ≅
  [≈] => ≈
  [≠] => ≠
  [≡] => ≡
  [≤] => ≤
  [≥] => ≥
  [?] => ⊂
  [?] => ⊃
  [?] => ⊄
  [?] => ⊆
  [?] => ⊇
  [⊕] => ⊕
  [?] => ⊗
  [⊥] => ⊥
  [?] => ⋅
  [?] => ⌈
  [?] => ⌉
  [?] => ⌊
  [?] => ⌋
  [?] => ⟨
  [?] => ⟩
  [?] => ◊
  [?] => ♠
  [?] => ♣
  [?] => ♥
  [?] => ♦
)