(PHP 4, PHP 5, PHP 7, PHP 8)
get_html_translation_table — Retorna a tabela de tradução usada por htmlspecialchars() e htmlentities()
$table
= HTML_SPECIALCHARS
, int $flags
= ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401, string $encoding
= "UTF-8"): arrayget_html_translation_table() retorna a tabela de tradução usada internamente para htmlspecialchars() e htmlentities().
Nota:
Caracteres especiais podem ser codificados de diversas maneiras. Por exemplo,
"
pode ser codificado como"
,"
ou"
. get_html_translation_table() retorna apenas a forma usada por htmlspecialchars() e htmlentities().
table
Informa que tabela deve ser retornada. Pode ser HTML_ENTITIES
ou
HTML_SPECIALCHARS
.
flags
Uma máscara de bits de uma ou mais das opções abaixo, que especificam que tipo de aspas a
tabela conterá, assim como para que tipo de documento a tabela serve. O padrão é
ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401
.
Nome da Constante | Descrição |
---|---|
ENT_COMPAT |
A tabela conterá entidades para aspas duplas, mas não para aspas simples. |
ENT_QUOTES |
A tabela conterá entitades tanto para aspas duplas quanto para aspas simples. |
ENT_NOQUOTES |
A tabela não conterá entidades nem para aspas simples nem para aspas duplas. |
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 |
Tabela para HTML 4.01. |
ENT_XML1 |
Tabela para XML 1. |
ENT_XHTML |
Tabela para XHTML. |
ENT_HTML5 |
Tabela para HTML 5. |
encoding
A codificação a ser usada. Se omitida, o valor padrão para este argumento é UTF-8.
Os seguintes conjuntos de caracteres são suportados:
Conjunto de caracteres | Apelidos | Descrição |
---|---|---|
ISO-8859-1 | ISO8859-1 | Western European, Latin-1. |
ISO-8859-5 | ISO8859-5 | Conjunto de caracteres cirílicos pouco usado (Latim/Cirílico). |
ISO-8859-15 | ISO8859-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. | |
cp866 | ibm866, 866 | Conjunto de caracteres do DOS específico para o Russo. |
cp1251 | Windows-1251, win-1251, 1251 | Conjunto de caracteres do Windows específico para o Russo. |
cp1252 | Windows-1252, 1252 | Conjunto de caracteres do Windows específico para a Europa Ocidental. |
KOI8-R | koi8-ru, koi8r | Russo. |
BIG5 | 950 | Chinês Tradicional, usado principalmente em Taiwan. |
GB2312 | 936 | Chins Simplificado, conjunto de caracteres padrão nacional. |
BIG5-HKSCS | Big5 com extenções de Hong Kong, Chinês Tradicional. | |
Shift_JIS | SJIS, SJIS-win, cp932, 932 | Japonês |
EUC-JP | EUCJP, 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.
Retorna a tabela de tradução como um array, com os caracteres originais como chaves e as entidades como valores.
Versão | Descrição |
---|---|
8.1.0 |
flags mudou de ENT_COMPAT para ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401 .
|
Exemplo #1 Exemplo de Tabela de Tradução
<?php
var_dump(get_html_translation_table(HTML_ENTITIES, ENT_QUOTES | ENT_HTML5));
?>
O exemplo acima produzirá algo semelhante a:
array(1510) { [" "]=> string(9) "
" ["!"]=> string(6) "!" ["""]=> string(6) """ ["#"]=> string(5) "#" ["$"]=> string(8) "$" ["%"]=> string(8) "%" ["&"]=> string(5) "&" ["'"]=> string(6) "'" // ... }