International PHP Conference Berlin 2025

    htmlspecialchars_decode

    (PHP 5 >= 5.1.0, PHP 7, PHP 8)

    htmlspecialchars_decode — Converte entidades especiais HTML de volta para caracteres

    Descrição

    htmlspecialchars_decode(string $string, int $flags = ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401): string

    Esta função é oposta a htmlspecialchars(). Ela converte de volta entidade especiais HTML em caracteres.

    As entidades convertidas são: &, " (quando ENT_NOQUOTES não estiver definida), ' (quando ENT_QUOTES estiver definida), < e >.

    Parâmetros

    string

    A string a ser decodificada.

    flags

    Uma máscara de bits de uma ou mais das opções a seguir, que especificam como lidar com aspas e que tipos de documentos são usados. O padrão é ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401.

    Constantes disponíveis para flags
    Nome da Constante Descrição
    ENT_COMPAT Converte aspas duplas e não converte aspas simples.
    ENT_QUOTES Converte tanto aspas duplas quanto simples.
    ENT_NOQUOTES Não converte aspas duplas ou simples.
    ENT_SUBSTITUTE Substitui sequências de unidade de código inválidas com um Caractere de Substituição Unicode U+FFFD (UTF-8) ou � ao invés de retornar uma string vazia.
    ENT_HTML401 Lida com o código como HTML 4.01.
    ENT_XML1 Lida com o código como XML 1.
    ENT_XHTML Lida com o código como XHTML.
    ENT_HTML5 Lida com o código como HTML 5.

    Valor Retornado

    Retorna a string decodificada.

    Registro de Alterações

    Versão Descrição
    8.1.0 O padrão de flags mudou de ENT_COMPAT para ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401.

    Exemplos

    Exemplo #1 Um exemplo de htmlspecialchars_decode()

    <?php
    $str     = "<p>this -&gt; &quot;</p>\n";

    echo     htmlspecialchars_decode($str);

    // observe que aqui as aspas não são convertidas
    echo htmlspecialchars_decode($str, ENT_NOQUOTES);
    ?>

    O exemplo acima produzirá:

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

    Veja Também

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicione uma nota

    Notas Enviadas por Usuários (em inglês) 3 notes

    up
    2
    thomas at xci[ignore_this]teit dot commm
    16 years ago
    The example for "htmlspecialchars_decode()" below sadly does not work for all PHP4 versions.

    Quote from the PHP manual:
    "get_html_translation_table() will return the translation table that is used internally for htmlspecialchars() and htmlentities()."

    But it does NOT! At least not for PHP version 4.4.2.
    This was already reported in a bug report (http://bugs.php.net/bug.php?id=25927), but it was marked as BOGUS.

    Proof:
    Code:
    --------------------
    <?php
    var_dump    (get_html_translation_table(HTML_SPECIALCHARS,ENT_QUOTES));
    var_dump(htmlspecialchars('\'',ENT_QUOTES));
    ?>
    --------------------

    Output:
    --------------------
    array
    '"' => '&quot;'
    ''' => '&#39;'
    '<' => '&lt;'
    '>' => '&gt;'
    '&' => '&amp;'

    '&#039;'
    --------------------

    This comment now is not to report this bug again (though I really believe it is one), but to complete the example and warn people of this pitfall.

    To make sure your htmlspecialchars_decode fake for PHP4 works, you should do something like this:

    <?php
    function htmlspecialchars_decode($string,$style=ENT_COMPAT)
    {
    $translation = array_flip(get_html_translation_table(HTML_SPECIALCHARS,$style));
    if(    $style === ENT_QUOTES){ $translation['&#039;'] = '\''; }
    return     strtr($string,$translation);
    }
    ?>

    Br, Thomas
    up
    0
    Anonymous
    18 years ago
    This should be the best way to do it.
    (Reposted because the other one seems a bit slower and because those who used the code under called it htmlspecialchars_decode_php4)

    <?php

    if ( !function_exists('htmlspecialchars_decode') )
    {
    function     htmlspecialchars_decode($text)
    {
    return     strtr($text, array_flip(get_html_translation_table(HTML_SPECIALCHARS)));
    }
    }

    ?>
    up
    -2
    or-k at or-k dot com
    19 years ago
    that works also with &auml; and &quot; and so on.
    get_html_translation_table(HTML_ENTITIES) => offers more characters than HTML_SPECIALCHARS

    function htmlspecialchars_decode_PHP4($uSTR)
    {
    return strtr($uSTR, array_flip(get_html_translation_table(HTML_ENTITIES, ENT_QUOTES)));
    }
    ＋adicione uma nota
    To Top