get_html_translation_table

(PHP 4, PHP 5)

get_html_translation_table — Возвращает таблицу преобразований, используемую функциями htmlspecialchars() и htmlentities()

Описание

array get_html_translation_table ([ int $table = HTML_SPECIALCHARS [, int $flags = ENT_COMPAT | ENT_HTML401 [, string $encoding = 'UTF-8' ]]] )

get_html_translation_table() возвращает таблицу преобразований, используемую функциями htmlspecialchars() и htmlentities().

Замечание:
Специальные символы могут быть закодированы разными способами. Например, " может быть закодирован как ", " или &#x22. get_html_translation_table() возвращает только формы, используемые функциями htmlspecialchars() и htmlentities().

Список параметров

table

Указывает, какую таблицу использовать для преобразований. Либо HTML_ENTITIES, либо HTML_SPECIALCHARS.

flags

Битовая маска, состоящая из одного или нескольких перечисленных ниже флагов, которые указывают какие кавычки будет содержать таблица, а также для какого документа таблица предназначена. Значение по умолчанию ENT_COMPAT | ENT_HTML401.

**Доступные константы в параметре `flags`**
Имя константы	Описание
`ENT_COMPAT`	Таблица будет содержать сущности для двойных кавычек, но не будет для одинарных.
`ENT_QUOTES`	Таблица будет содержать сущности как для двойных кавычек, так и для одинарных.
`ENT_NOQUOTES`	Таблица не будет содержать сущности ни для двойных кавычек, ни для одинарных.
`ENT_HTML401`	Таблица для HTML 4.01.
`ENT_XML1`	Таблица для XML 1.
`ENT_XHTML`	Таблица для XHTML.
`ENT_HTML5`	Таблица для HTML 5.

encoding

Используемая кодировка. Если не указана, то значением по умолчанию для этого аргумента является ISO-8859-1 в версиях PHP до 5.4.0 и UTF-8, начиная с версии 5.4.0 и далее.

Поддерживаются следующие кодировки:

**Поддерживаемые кодировки**
Кодировка	Псевдонимы	Описание
ISO-8859-1	ISO8859-1	Западно-европейская Latin-1.
ISO-8859-5	ISO8859-5	Редкоиспользуемая кириллическая кодировка (Latin/Cyrillic).
ISO-8859-15	ISO8859-15	Западно-европейская Latin-9. Добавляет знак евро, французские и финские буквы к кодировке Latin-1(ISO-8859-1).
UTF-8		8-битная Unicode, совместимая с ASCII.
cp866	ibm866, 866	Кириллическая кодировка, применяемая в DOS.
cp1251	Windows-1251, win-1251, 1251	Кириллическая кодировка, применяемая в Windows.
cp1252	Windows-1252, 1252	Западно-европейская кодировка, применяемая в Windows.
KOI8-R	koi8-ru, koi8r	Русская кодировка.
BIG5	950	Традиционный китайский, применяется в основном на Тайване.
GB2312	936	Упрощенный китайский, стандартная национальная кодировка.
BIG5-HKSCS		Расширенная Big5, применяемая в Гонг-Конге.
Shift_JIS	SJIS, SJIS-win, cp932, 932	Японская кодировка.
EUC-JP	EUCJP, eucJP-win	Японская кодировка.
MacRoman		Кодировка, используемая в Mac OS.
''		Пустая строка активирует режим определения кодировки из файла скрипта (Zend multibyte), default_charset и текущей локали (см. nl_langinfo() и setlocale()), в указанном порядке. Не рекомендуется к использованию.

Замечание: Остальные кодировки не поддерживаются, вместо них будет применена кодировка по умолчанию и сгенерировано предупреждение.

Возвращаемые значения

Возвращает таблицу преобразований в виде массива с оригинальными символами в качестве ключей и сущностями в качестве значений.

Список изменений

Версия	Описание
5.4.0	Значение по умолчанию для параметра `encoding` было изменено на UTF-8.
5.4.0	Были добавлены константы `ENT_HTML401`, `ENT_XML1`, `ENT_XHTML` и `ENT_HTML5`.
5.3.4	Добавлен параметр `encoding`.

Примеры

Пример #1 Пример таблицы преобразований


<?php
var_dump(get_html_translation_table(HTML_ENTITIES, ENT_QUOTES | ENT_HTML5));
?>

Результатом выполнения данного примера будет что-то подобное:

array(1510) {
  ["    "]=>
  string(5) "&Tab;"
  ["
"]=>
  string(9) "&NewLine;"
  ["!"]=>
  string(6) "&excl;"
  ["""]=>
  string(6) "&quot;"
  ["#"]=>
  string(5) "&num;"
  ["$"]=>
  string(8) "&dollar;"
  ["%"]=>
  string(8) "&percnt;"
  ["&"]=>
  string(5) "&amp;"
  ["'"]=>
  string(6) "&apos;"
  // ...
}

Смотрите также

htmlspecialchars() - Преобразует специальные символы в HTML-сущности
htmlentities() - Преобразует все возможные символы в соответствующие HTML-сущности
html_entity_decode() - Преобразует все HTML-сущности в соответствующие символы

Коментарии

Jun 19

Автор: dirk at hartmann dot net


get_html_translation_table

It works only with the first 256 Codepositions.

For Higher Positions, for Example &#1092;

(a kyrillic Letter) it shows the same.

2001-06-19 16:41:41

http://php5.kiev.ua/manual/ru/function.get-html-translation-table.html

Oct 28

Автор: kumar at chicagomodular.com


without heavy scientific analysis, this seems to work as a quick fix to making text originating from a Microsoft Word document display as HTML:



<?php

function DoHTMLEntities ($string)

    {

        $trans_tbl = get_html_translation_table (HTML_ENTITIES);

        

        // MS Word strangeness.. 

        // smart single/ double quotes:

        $trans_tbl[chr(145)] = '\''; 

        $trans_tbl[chr(146)] = '\''; 

        $trans_tbl[chr(147)] = '&quot;'; 

        $trans_tbl[chr(148)] = '&quot;'; 



                // Acute 'e'

        $trans_tbl[chr(142)] = '&eacute;';

        

        return strtr ($string, $trans_tbl);

    }

?>

2002-10-28 19:51:50

http://php5.kiev.ua/manual/ru/function.get-html-translation-table.html

Jan 03

Автор: kevin_bro at hostedstuff dot com


Alans version didn't seem to work right. If you're having the same problem consider using this slightly modified version instead:



function unhtmlentities ($string)  {

   $trans_tbl = get_html_translation_table (HTML_ENTITIES);

   $trans_tbl = array_flip ($trans_tbl);

   $ret = strtr ($string, $trans_tbl);

   return preg_replace('/&#(\d+);/me', 

      "chr('\\1')",$ret);

}

2003-01-03 08:06:58

http://php5.kiev.ua/manual/ru/function.get-html-translation-table.html

May 18

Автор: Alex Minkoff


If you want to display special HTML entities in a web browser, you can use the following code:



<?

$entities = get_html_translation_table(HTML_ENTITIES);

foreach ($entities as $entity) {

    $new_entities[$entity] = htmlspecialchars($entity);

}

echo "<pre>";

print_r($new_entities);

echo "</pre>";

?>



If you don't, the key name of each element will appear to be the same as the element content itself, making it look mighty stupid. ;)

2005-05-18 19:30:09

http://php5.kiev.ua/manual/ru/function.get-html-translation-table.html

May 29

Автор: Patrick nospam at nospam mesopia dot com


Not sure what's going on here but I've run into a problem that others might face as well...



<?php



$translations = array_flip(get_html_translation_table(HTML_ENTITIES,ENT_QUOTES));



?>



returns the single quote ' as being equal to &#39; while



<?php



$translatedString = htmlentities($string,ENT_QUOTES);



?>

returns it as being equal to &#039;



I've had to do a specific string replacement for the time being... Not sure if it's an issue with the function or the array manipulation.



-Pat

2005-05-29 22:00:57

http://php5.kiev.ua/manual/ru/function.get-html-translation-table.html

Dec 31

Автор: Jérôme Jaglale


htmlentities includes htmlspecialchars, so here's how to convert an UTF-8 string :

htmlentities($string, ENT_QUOTES, 'UTF-8');

2006-12-31 13:43:36

http://php5.kiev.ua/manual/ru/function.get-html-translation-table.html

Jul 20

Автор: Maurizio Siliani at trident dot it


If you have troubles (like me) getting data from ISO-8859-1 encoded forms where user copy and paste from word, this routine could be useful.

It adds to the standard get_html_translation_table the codes of the characters usually M$ Word replacs into typed text.

Otherwise those characters would never be displayed correctly in html output.



function get_html_translation_table_CP1252() {

    $trans = get_html_translation_table(HTML_ENTITIES);

    $trans[chr(130)] = '&sbquo;';    // Single Low-9 Quotation Mark

    $trans[chr(131)] = '&fnof;';    // Latin Small Letter F With Hook

    $trans[chr(132)] = '&bdquo;';    // Double Low-9 Quotation Mark

    $trans[chr(133)] = '&hellip;';    // Horizontal Ellipsis

    $trans[chr(134)] = '&dagger;';    // Dagger

    $trans[chr(135)] = '&Dagger;';    // Double Dagger

    $trans[chr(136)] = '&circ;';    // Modifier Letter Circumflex Accent

    $trans[chr(137)] = '&permil;';    // Per Mille Sign

    $trans[chr(138)] = '&Scaron;';    // Latin Capital Letter S With Caron

    $trans[chr(139)] = '&lsaquo;';    // Single Left-Pointing Angle Quotation Mark

    $trans[chr(140)] = '&OElig;    ';    // Latin Capital Ligature OE

    $trans[chr(145)] = '&lsquo;';    // Left Single Quotation Mark

    $trans[chr(146)] = '&rsquo;';    // Right Single Quotation Mark

    $trans[chr(147)] = '&ldquo;';    // Left Double Quotation Mark

    $trans[chr(148)] = '&rdquo;';    // Right Double Quotation Mark

    $trans[chr(149)] = '&bull;';    // Bullet

    $trans[chr(150)] = '&ndash;';    // En Dash

    $trans[chr(151)] = '&mdash;';    // Em Dash

    $trans[chr(152)] = '&tilde;';    // Small Tilde

    $trans[chr(153)] = '&trade;';    // Trade Mark Sign

    $trans[chr(154)] = '&scaron;';    // Latin Small Letter S With Caron

    $trans[chr(155)] = '&rsaquo;';    // Single Right-Pointing Angle Quotation Mark

    $trans[chr(156)] = '&oelig;';    // Latin Small Ligature OE

    $trans[chr(159)] = '&Yuml;';    // Latin Capital Letter Y With Diaeresis

    ksort($trans);

    return $trans;

}

2007-07-20 11:43:03

http://php5.kiev.ua/manual/ru/function.get-html-translation-table.html

Sep 07

Автор: iain (duh) workingsoftware.com.au


I wrote a quick little function for converting something like '&middot;' into '&#183;':



$to_convert = '&middot;'; 

$table = get_html_translation_table(HTML_ENTITIES);

$equiv = '&#'.ord(array_search($to_convert,$table)).';';

2007-09-07 05:06:11

http://php5.kiev.ua/manual/ru/function.get-html-translation-table.html

Sep 23

Автор: Kenneth Kin Lum


to display the mapping on a webpage no matter what the server encoding is, this can be used



  echo "<pre>\n";

  echo htmlentities(print_r((get_html_translation_table(HTML_SPECIALCHARS)), true));

  echo htmlentities(print_r((get_html_translation_table(HTML_ENTITIES)), true));



since get_html_translation_table() actually gives the special chars in iso-8859-1 (Latin-1) encoding, so to see the tables correctly using



  print_r(get_html_translation_table(HTML_ENTITIES));



your server needs to give a HTTP header as iso-8859-1, unless you use header() or manually set the browser's encoding setting to iso-8859-1.  And you need to view the source of the page to see the mapping.  (except English version of IE 7 outputs the page source as iso-8859-1 anyway).

2008-09-23 08:54:39

http://php5.kiev.ua/manual/ru/function.get-html-translation-table.html

Sep 15

Автор: kevin at cwsmailbox dot xom


Be careful using get_html_translation_table() in a loop, as it's very slow.

2010-09-15 12:55:30

http://php5.kiev.ua/manual/ru/function.get-html-translation-table.html

Dec 12

Автор: michael dot genesis at gmail dot com


The fact that MS-word and some other sources use CP-1252, and that it is so close to Latin1 ('ISO-8859-1') causes a lot of confusion. What confused me the most was finding that mySQL uses CP-1252 by default.



You may run into trouble if you find yourself tempted to do something like this:

<?php

    $trans[chr(149)] = '&bull;';    // Bullet

    $trans[chr(150)] = '&ndash;';    // En Dash

    $trans[chr(151)] = '&mdash;';    // Em Dash

    $trans[chr(152)] = '&tilde;';    // Small Tilde

    $trans[chr(153)] = '&trade;';    // Trade Mark Sign

?>



Don't do it. DON'T DO IT!



You can use:

<?php

    $translationTable = get_html_translation_table(HTML_ENTITIES, ENT_NOQUOTES, 'WINDOWS-1252');

?>



or just convert directly:

<?php

    $output = htmlentities($input, ENT_NOQUOTES, 'WINDOWS-1252');

?>



But your web page is probably encoded UTF-8, and you probably don't really want CP-1252 text flying around, so fix the character encoding first:

<?php

    $output = mb_convert_encoding($input, 'UTF-8', 'WINDOWS-1252');

    $ouput = htmlentities($output);

?>

2011-12-12 17:01:57

http://php5.kiev.ua/manual/ru/function.get-html-translation-table.html

PHP5

Для web разработчика

Nov 13
Функция get_html_translation_table() - Возвращает таблицу преобразований, используемую функциями htmlspecialchars и htmlentities

get_html_translation_table

Описание

Список параметров

Возвращаемые значения

Список изменений

Примеры

Смотрите также

Коментарии

PHP5

Для web разработчика

Nov 13Функция get_html_translation_table() - Возвращает таблицу преобразований, используемую функциями htmlspecialchars и htmlentities

get_html_translation_table

Описание

Список параметров

Возвращаемые значения

Список изменений

Примеры

Смотрите также

Коментарии

Nov 13
Функция get_html_translation_table() - Возвращает таблицу преобразований, используемую функциями htmlspecialchars и htmlentities