PHP get_html_translation_table()Functions

PHP String 参考手册PHP String Reference Manual

Examples

Output the translation table used by the htmlspecialchars() function:

<?php
print_r (get_html_translation_table()); // HTML_SPECIALCHARS is default.
?>

Run example »

Definition and Usage

The get_html_translation_table() function returnshtmlentities()andhtmlspecialchars()the translation table used by the function.

Note:Some characters can be encoded in several ways. The get_html_translation_table() function returns the most common encoding.

Syntax

get_html_translation_table(function,flags,character-set)

Parameter Description
function Optional. Specifies which translation table to return.

Possible values:

  • HTML_SPECIALCHARS - Default. Translates certain characters that need URL encoding so that they are displayed correctly on an HTML page.
  • HTML_ENTITIES - Translates all characters that need URL encoding so that they are displayed correctly on an HTML page.
flags Optional. Specifies which quotes the translation table will contain and which document type the translation table is used for.

Available quote types:

  • ENT_COMPAT - Default. The translation table contains double-quote entities, not single-quote entities.
  • ENT_QUOTES - The translation table contains double-quote entities and single-quote entities.
  • ENT_NOQUOTES - The translation table contains neither double-quote entities nor single-quote entities.

Additional flags specifying the document type for which the translation table is applicable:

  • ENT_HTML401 - Default. Translation table for HTML 4.01.
  • ENT_HTML5 - Translation table for HTML 5.
  • ENT_XML1 - Translation table for XML 1.
  • ENT_XHTML - Translation table for XHTML.
character-set Optional. A string specifying the character set to use.

Allowed values:

  • UTF-8 - Default. ASCII compatible multibyte 8-bit Unicode
  • ISO-8859-1 - Western European
  • ISO-8859-15 - Western European (adds the Euro sign + French and Finnish letters missing in ISO-8859-1)
  • cp866 - DOS-specific Cyrillic character set
  • cp1251 - Windows-specific Cyrillic character set
  • cp1252 - Windows-specific Western European character set
  • KOI8-R - Russian
  • BIG5 - Traditional Chinese, mainly used in Taiwan
  • GB2312 - Simplified Chinese, national standard character set
  • BIG5-HKSCS - Big5 with Hong Kong extensions
  • Shift_JIS - Japanese
  • EUC-JP - Japanese
  • MacRoman - Character set used by Mac OS

Notes:In versions before PHP 5.4, unrecognized character sets were ignored and replaced by ISO-8859-1. Since PHP 5.4, unrecognized character sets are ignored and replaced by UTF-8.

Technical Details

Return value: Returns the translation table as an array, with original characters as keys and entities as values.
PHP Version: 4+
Changelog: In PHP 5,character-setthe default value of the parameter was changed to UTF-8.

In PHP 5.4, additional flags were added to specify the document type for which the translation table is applicable: ENT_HTML401, ENT_HTML5, ENT_XML1 and ENT_XHTML.

In PHP 5.3.4, thecharacter-setparameter was added.

More Examples

Example

Translation table for HTML_SPECIALCHARS:

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

Displaying character and entity name:

Array
(
["] => &quot;
[&] => &amp;
[<] => &lt;
[>] => &gt;
)


Example 2

Translation table for HTML_ENTITIES:

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

Display the characters and their corresponding entity names:

Array
(
  ["] => &quot;
  [&] => &amp;
  [<] => &lt;
  [>] => &gt;
  [ ] => &nbsp;
  [¡] => &iexcl;
  [¢] => &cent;
  [£] => &pound;
  [¤] => &curren;
  [¥] => &yen;
  [¦] => &brvbar;
  [§] => &sect;
  [¨] => &uml;
  [©] => &copy;
  [ª] => &ordf;
  [«] => &laquo;
  [¬] => &not;
  [­] => &shy;
  [®] => &reg;
  [¯] => &macr;
  [°] => &deg;
  [±] => &plusmn;
  [²] => &sup2;
  [³] => &sup3;
  [´] => &acute;
  [µ] => &micro;
  [¶] => &para;
  [·] => &middot;
  [¸] => &cedil;
  [¹] => &sup1;
  [º] => &ordm;
  [»] => &raquo;
  [¼] => &frac14;
  [½] => &frac12;
  [¾] => &frac34;
  [¿] => &iquest;
  [À] => &Agrave;
  [Á] => &Aacute;
  [Â] => &Acirc;
  [Ã] => &Atilde;
  [Ä] => &Auml;
  [Å] => &Aring;
  [Æ] => &AElig;
  [Ç] => &Ccedil;
  [È] => &Egrave;
  [É] => &Eacute;
  [Ê] => &Ecirc;
  [Ë] => &Euml;
  [Ì] => &Igrave;
  [Í] => &Iacute;
  [Î] => &Icirc;
  [Ï] => &Iuml;
  [Ð] => &ETH;
  [Ñ] => &Ntilde;
  [Ò] => &Ograve;
  [Ó] => &Oacute;
  [Ô] => &Ocirc;
  [Õ] => &Otilde;
  [Ö] => &Ouml;
  [×] => &times;
  [Ø] => &Oslash;
  [Ù] => &Ugrave;
  [Ú] => &Uacute;
  [Û] => &Ucirc;
  [Ü] => &Uuml;
  [Ý] => &Yacute;
  [Þ] => &THORN;
  [ß] => &szlig;
  [à] => &agrave;
  [á] => &aacute;
  [â] => &acirc;
  [ã] => &atilde;
  [ä] => &auml;
  [å] => &aring;
  [æ] => &aelig;
  [ç] => &ccedil;
  [è] => &egrave;
  [é] => &eacute;
  [ê] => &ecirc;
  [ë] => &euml;
  [ì] => &igrave;
  [í] => &iacute;
  [î] => &icirc;
  [ï] => &iuml;
  [ð] => &eth;
  [ñ] => &ntilde;
  [ò] => &ograve;
  [ó] => &oacute;
  [ô] => &ocirc;
  [õ] => &otilde;
  [ö] => &ouml;
  [÷] => &divide;
  [ø] => &oslash;
  [ù] => &ugrave;
  [ú] => &uacute;
  [û] => &ucirc;
  [ü] => &uuml;
  [ý] => &yacute;
  [þ] => &thorn;
  [ÿ] => &yuml;
  [Œ] => &OElig;
  [œ] => &oelig;
  [Š] => &Scaron;
  [š] => &scaron;
  [Ÿ] => &Yuml;
  [ƒ] => &fnof;
  [ˆ] => &circ;
  [˜] => &tilde;
  [Α] => &Alpha;
  [Β] => &Beta;
  [Γ] => &Gamma;
  [Δ] => &Delta;
  [Ε] => &Epsilon;
  [Ζ] => &Zeta;
  [Η] => &Eta;
  [Θ] => &Theta;
  [Ι] => &Iota;
  [Κ] => &Kappa;
  [Λ] => &Lambda;
  [Μ] => &Mu;
  [Ν] => &Nu;
  [Ξ] => &Xi;
  [Ο] => &Omicron;
  [Π] => &Pi;
  [Ρ] => &Rho;
  [Σ] => &Sigma;
  [Τ] => &Tau;
  [Υ] => &Upsilon;
  [Φ] => &Phi;
  [Χ] => &Chi;
  [Ψ] => &Psi;
  [Ω] => &Omega;
  [α] => &alpha;
  [β] => &beta;
  [γ] => &gamma;
  [δ] => &delta;
  [ε] => &epsilon;
  [ζ] => &zeta;
  [η] => &eta;
  [θ] => &theta;
  [ι] => &iota;
  [κ] => &kappa;
  [λ] => &lambda;
  [μ] => &mu;
  [ν] => &nu;
  [ξ] => &xi;
  [ο] => &omicron;
  [π] => &pi;
  [ρ] => &rho;
  [ς] => &sigmaf;
  [σ] => &sigma;
  [τ] => &tau;
  [υ] => &upsilon;
  [φ] => &phi;
  [χ] => &chi;
  [ψ] => &psi;
  [ω] => &omega;
  [ϑ] => &thetasym;
  [ϒ] => &upsih;
  [ϖ] => &piv;
  [ ] => &ensp;
  [ ] => &emsp;
  [ ] => &thinsp;
  [‌] => &zwnj;
  [‍] => &zwj;
  [‎] => &lrm;
  [‏] => &rlm;
  [–] => &ndash;
  [—] => &mdash;
  ['] => &lsquo;
  ['] => &rsquo;
  [‚] => &sbquo;
  ["] => &ldquo;
  ["] => &rdquo;
  [„] => &bdquo;
  [†] => &dagger;
  [‡] => &Dagger;
  [•] => &bull;
  […] => &hellip;
  [‰] => &permil;
  [′] => &prime;
  [″] => &Prime;
  [‹] => &lsaquo;
  [›] => &rsaquo;
  [‾] => &oline;
  [⁄] => &frasl;
  [€] => &euro;
  [ℑ] => &image;
  [℘] => &weierp;
  [ℜ] => &real;
  [™] => &trade;
  [ℵ] => &alefsym;
  [←] => &larr;
  [↑] => &uarr;
  [→] => &rarr;
  [↓] => &darr;
  [↔] => &harr;
  [↵] => &crarr;
  [⇐] => &lArr;
  [⇑] => &uArr;
  [⇒] => &rArr;
  [⇓] => &dArr;
  [⇔] => &hArr;
  [∀] => &forall;
  [∂] => &part;
  [∃] => &exist;
  [∅] => &empty;
  [∇] => &nabla;
  [∈] => &isin;
  [∉] => &notin;
  [∋] => &ni;
  [∏] => &prod;
  [∑] => &sum;
  [−] => &minus;
  [∗] => &lowast;
  [√] => &radic;
  [∝] => &prop;
  [∞] => &infin;
  [∠] => &ang;
  [∧] => &and;
  [∨] => &or;
  [∩] => &cap;
  [∪] => &cup;
  [∫] => &int;
  [∴] => &there4;
  [∼] => &sim;
  [≅] => &cong;
  [≈] => &asymp;
  [≠] => &ne;
  [≡] => &equiv;
  [≤] => &le;
  [≥] => &ge;
  [⊂] => &sub;
  [⊃] => &sup;
  [⊄] => &nsub;
  [⊆] => &sube;
  [⊇] => &supe;
  [⊕] => &oplus;
  [⊗] => &otimes;
  [⊥] => &perp;
  [⋅] => &sdot;
  [⌈] => &lceil;
  [⌉] => &rceil;
  [⌊] => &lfloor;
  [⌋] => &rfloor;
  [〈] => &lang;
  [〉] => &rang;
  [◊] => &loz;
  [♠] => &spades;
  [♣] => &clubs;
  [♥] => &hearts;
  [♦] => &diams;
)


PHP String 参考手册PHP String Reference Manual Other Extensions