(PHP 4 >= 4.3.0, PHP 5, PHP 7)
html_entity_decode — Convert HTML entities to their corresponding characters
$string
[, int $flags = ENT_COMPAT | ENT_HTML401
[, string $encoding = ini_get("default_charset")
]] ) : string
html_entity_decode() is the opposite of
htmlentities() in that it converts HTML entities
in the string to their corresponding characters.
More precisely, this function decodes all the entities (including all numeric entities) that a) are necessarily valid for the chosen document type — i.e., for XML, this function does not decode named entities that might be defined in some DTD — and b) whose character or characters are in the coded character set associated with the chosen encoding and are permitted in the chosen document type. All other entities are left as is.
stringThe input string.
flagsA bitmask of one or more of the following flags, which specify how to handle quotes and which document type to use. The default is ENT_COMPAT | ENT_HTML401.
| Constant Name | Description |
|---|---|
ENT_COMPAT |
Will convert double-quotes and leave single-quotes alone. |
ENT_QUOTES |
Will convert both double and single quotes. |
ENT_NOQUOTES |
Will leave both double and single quotes unconverted. |
ENT_HTML401 |
Handle code as HTML 4.01. |
ENT_XML1 |
Handle code as XML 1. |
ENT_XHTML |
Handle code as XHTML. |
ENT_HTML5 |
Handle code as HTML 5. |
encodingAn optional argument defining the encoding used when converting characters.
If omitted, the default value of the encoding varies
depending on the PHP version in use. In PHP 5.6 and later, the
default_charset configuration
option is used as the default value. PHP 5.4 and 5.5 will use
UTF-8 as the default. Earlier versions of PHP use
ISO-8859-1.
Although this argument is technically optional, you are highly encouraged to specify the correct value for your code if you are using PHP 5.5 or earlier, or if your default_charset configuration option may be set incorrectly for the given input.
支锟斤拷锟斤拷锟斤拷锟街凤拷锟斤拷锟斤拷
| 锟街凤拷锟斤拷 | 锟斤拷锟斤拷 | 锟斤拷锟斤拷 |
|---|---|---|
| ISO-8859-1 | ISO8859-1 | 锟斤拷欧锟斤拷Latin-1 |
| ISO-8859-5 | ISO8859-5 | Little used cyrillic charset (Latin/Cyrillic). |
| ISO-8859-15 | ISO8859-15 | 锟斤拷欧锟斤拷Latin-9锟斤拷锟斤拷锟斤拷欧元锟斤拷锟脚ｏ拷锟斤拷锟斤拷头锟斤拷锟斤拷锟斤拷锟侥革拷锟� Latin-1(ISO-8859-1) 锟斤拷缺失锟斤拷 |
| UTF-8 | ASCII 锟斤拷锟捷的讹拷锟街斤拷 8 位 Unicode锟斤拷 | |
| cp866 | ibm866, 866 | DOS 锟斤拷锟叫碉拷锟斤拷锟斤拷锟斤拷锟斤拷搿ｏ拷锟斤拷址锟斤拷锟斤拷锟� 4.3.2 锟芥本锟叫得碉拷支锟街★拷 |
| cp1251 | Windows-1251, win-1251, 1251 | Windows 锟斤拷锟叫碉拷锟斤拷锟斤拷锟斤拷锟斤拷搿ｏ拷锟斤拷址锟斤拷锟斤拷锟� 4.3.2 锟芥本锟叫得碉拷支锟街★拷 |
| cp1252 | Windows-1252, 1252 | Windows 锟斤拷锟叫碉拷锟斤拷欧锟斤拷锟诫。 |
| KOI8-R | koi8-ru, koi8r | 锟斤拷锟斤。锟斤拷锟街凤拷锟斤拷锟斤拷 4.3.2 锟芥本锟叫得碉拷支锟街★拷 |
| BIG5 | 950 | 锟斤拷锟斤拷锟斤拷锟侥ｏ拷锟斤拷要锟斤拷锟斤拷锟叫癸拷台锟斤拷省锟斤拷 |
| GB2312 | 936 | 锟斤拷锟斤拷锟斤拷锟侥ｏ拷锟叫癸拷锟斤拷锟揭憋拷准锟街凤拷锟斤拷锟斤拷 |
| BIG5-HKSCS | 锟斤拷锟斤拷锟斤拷锟侥ｏ拷锟斤拷锟斤拷锟斤拷锟斤拷锟秸癸拷锟� Big5 锟街凤拷锟斤拷锟斤拷 | |
| Shift_JIS | SJIS, 932 | 锟斤拷锟斤拷 |
| EUC-JP | EUCJP | 锟斤拷锟斤拷 |
| MacRoman | Mac OS 使锟矫碉拷锟街凤拷锟斤拷锟斤拷 | |
| '' | An empty string activates detection from script encoding (Zend multibyte), default_charset and current locale (see nl_langinfo() and setlocale()), in this order. Not recommended. |
Note: 锟斤拷锟斤拷锟街凤拷锟斤拷没锟斤拷锟较可★拷锟斤拷锟斤拷使锟斤拷默锟较憋拷锟诫并锟阶筹拷锟届常锟斤拷
Returns the decoded string.
| 锟芥本 | 说锟斤拷 |
|---|---|
| 5.6.0 |
The default value for the encoding parameter was
changed to be the value of the
default_charset configuration
option.
|
| 5.4.0 | Default encoding changed from ISO-8859-1 to UTF-8. |
| 5.4.0 |
The constants ENT_HTML401, ENT_XML1,
ENT_XHTML and ENT_HTML5 were added.
|
Example #1 Decoding HTML entities
<?php
$orig = "I'll \"walk\" the <b>dog</b> now";
$a = htmlentities($orig);
$b = html_entity_decode($a);
echo $a; // I'll "walk" the <b>dog</b> now
echo $b; // I'll "walk" the <b>dog</b> now
?>
Note:
You might wonder why trim(html_entity_decode(' ')); doesn't reduce the string to an empty string, that's because the ' ' entity is not ASCII code 32 (which is stripped by trim()) but ASCII code 160 (0xa0) in the default ISO 8859-1 encoding.