html_entity_decode

    (PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

    html_entity_decode — Convert HTML entities to their corresponding characters

    Descrição

    html_entity_decode(string$string, int$flags = ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401, ?string$encoding = null): 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.

    Parâmetros

    string

    The input string.

    flags

    A 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_QUOTES | ENT_SUBSTITUTE | ENT_HTML401.

    Available flags constants
    Constant NameDescription
    ENT_COMPATWill convert double-quotes and leave single-quotes alone.
    ENT_QUOTESWill convert both double and single quotes.
    ENT_NOQUOTESWill leave both double and single quotes unconverted.
    ENT_SUBSTITUTE Replace invalid code unit sequences with a Unicode Replacement Character U+FFFD (UTF-8) or � (otherwise) instead of returning an empty string.
    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.
    encoding

    Um argumento opcional que define a codificação usada na conversão de caracteres.

    Se omitido, encoding assume como padrão o valor da opção de configuração default_charset .

    Embora este argumento seja tecnicamente opcional, especificar o valor correto para o código é altamente recomendável se a opção de configuração default_charset puder ser definida incorretamente para a entrada fornecida.

    Os seguintes conjuntos de caracteres são suportados:

    Conjuntos de caracteres suportados
    Conjunto de caracteresApelidosDescrição
    ISO-8859-1ISO8859-1 Western European, Latin-1.
    ISO-8859-5ISO8859-5 Conjunto de caracteres cirílicos pouco usado (Latim/Cirílico).
    ISO-8859-15ISO8859-15 Western European, Latin-9. Adiciona o símbolo do Euro, letras Francesas e Filandesas faltando no Latin-1 (ISO-8859-1).
    UTF-8  Código de multi-byte 8-bit Unicode compatível com ASCII.
    cp866ibm866, 866 Conjunto de caracteres do DOS específico para o Russo.
    cp1251Windows-1251, win-1251, 1251 Conjunto de caracteres do Windows específico para o Russo.
    cp1252Windows-1252, 1252 Conjunto de caracteres do Windows específico para a Europa Ocidental.
    KOI8-Rkoi8-ru, koi8r Russo.
    BIG5950 Chinês Tradicional, usado principalmente em Taiwan.
    GB2312936 Chins Simplificado, conjunto de caracteres padrão nacional.
    BIG5-HKSCS  Big5 com extenções de Hong Kong, Chinês Tradicional.
    Shift_JISSJIS, SJIS-win, cp932, 932 Japonês
    EUC-JPEUCJP, eucJP-win Japonês
    MacRoman  Conjunto de caracteres que era usado pelo Mac OS.
    ''  Uma string vazia ativa a detecção a partir de codificação de script (multibyte Zend), conjunto padrão de caracteres e localidade atual (consulte nl_langinfo() e setlocale()), nesta ordem. Não recomendado.

    Nota: Nenhum outro conjunto de caracteres é reconhecido. A codificação padrão será usada no lugar e um alerta será emitido.

    Valor Retornado

    Returns the decoded string.

    Registro de Alterações

    VersãoDescrição
    8.1.0flags changed from ENT_COMPAT to ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401.
    8.0.0encoding is nullable now.

    Exemplos

    Exemplo #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 &quot;walk&quot; the &lt;b&gt;dog&lt;/b&gt; now

    echo $b; // I'll "walk" the <b>dog</b> now
    ?>

    Notas

    Nota:

    You might wonder why trim(html_entity_decode('&nbsp;')); doesn't reduce the string to an empty string, that's because the '&nbsp;' entity is not ASCII code 32 (which is stripped by trim()) but ASCII code 160 (0xa0) in the default ISO 8859-1 encoding.

    Veja Também

    To Top