概述

wp_specialchars_decode() 函数用于将特定的 HTML 实体转换回其原始字符，主要处理 &、<、>、" 和 ' 等实体。它支持通过 $quote_style 参数控制引号的解码行为，并兼容旧版 _wp_specialchars() 的值。

关键要点

• 函数核心功能：解码 HTML 实体，包括 &、<、>、" 和 '。
• 参数 $quote_style：可选，控制引号解码方式，如 ENT_COMPAT（仅解码双引号）、ENT_QUOTES（解码单双引号）或 ENT_NOQUOTES（默认，不解码引号）。
• 兼容性：支持旧值 'single' 和 'double'，用于向后兼容 _wp_specialchars()。
• 返回值：返回解码后的字符串，若无实体则直接返回原文本。
• 注意事项：函数不处理所有 HTML 实体（如 –），建议使用 html_entity_decode() 处理更广泛实体。

代码示例

function wp_specialchars_decode( $text, $quote_style = ENT_NOQUOTES ) {
    $text = (string) $text;

    if ( 0 === strlen( $text ) ) {
        return '';
    }

    if ( ! str_contains( $text, '&' ) ) {
        return $text;
    }

    if ( empty( $quote_style ) ) {
        $quote_style = ENT_NOQUOTES;
    } elseif ( ! in_array( $quote_style, array( 0, 2, 3, 'single', 'double' ), true ) ) {
        $quote_style = ENT_QUOTES;
    }

    $single = array(
        ''' => "'",
        ''' => "'",
    );
    $single_preg = array(
        '/&#0*39;/'   => "'",
        '/&#x0*27;/i' => "'",
    );
    $double = array(
        '"' => '"',
        '"'  => '"',
        '"'   => '"',
    );
    $double_preg = array(
        '/&#0*34;/'   => '"',
        '/&#x0*22;/i' => '"',
    );
    $others = array(
        '<'   => '<',
        '>' => '>',
        '&'  => '&',
        '&' => '&',
        '&'  => '&',
    );
    $others_preg = array(
        '/&#0*60;/'   => '<',
        '/&#0*62;/'   => '>',
        '/&#0*38;/'   => '&',
        '/&#x0*26;/i' => '&',
    );

    if ( ENT_QUOTES === $quote_style ) {
        $translation      = array_merge( $single, $double, $others );
        $translation_preg = array_merge( $single_preg, $double_preg, $others_preg );
    } elseif ( ENT_COMPAT === $quote_style || 'double' === $quote_style ) {
        $translation      = array_merge( $double, $others );
        $translation_preg = array_merge( $double_preg, $others_preg );
    } elseif ( 'single' === $quote_style ) {
        $translation      = array_merge( $single, $others );
        $translation_preg = array_merge( $single_preg, $others_preg );
    } elseif ( ENT_NOQUOTES === $quote_style ) {
        $translation      = $others;
        $translation_preg = $others_preg;
    }

    $text = preg_replace( array_keys( $translation_preg ), array_values( $translation_preg ), $text );
    return strtr( $text, $translation );
}

注意事项

• 此函数不解码所有 HTML 实体，例如 – 不会被处理，需使用 html_entity_decode() 进行更全面的解码。
• 函数内部通过数组映射和正则表达式处理实体，确保高效解码。