utf8_encode
Преобразовывает строку из кодировки ISO-8859-1 в кодировку UTF-8
&warn.deprecated.function-8-2-0;
&reftitle.description;
stringutf8_encode
stringstring
Функция преобразовывает строку string из кодировки
ISO-8859-1 в кодировку UTF-8.
Функция не пытается угадать текущую кодировку предоставленной строки, а предполагает,
что строку закодировали в кодировке ISO-8859-1 (которую также знают как Latin 1) и преобразовывает строку в кодировку UTF-8.
Поскольку каждая последовательность байтов — корректная строка в кодировке ISO-8859-1,
это никогда не приводит к ошибке, но не приведёт к получению полезной строки,
если предполагалась другая кодировка.
Многие веб-страницы, отмеченные как использующие кодировку
ISO-8859-1, на самом деле используют схожую кодировку
Windows-1252, и браузеры интерпретируют
страницы ISO-8859-1 как Windows-1252.
Однако кодировка Windows-1252 содержит дополнительные печатаемые
символы наподобие знака Евро (€) и фигурные кавычки
(“ ”) вместо управляющих кодов
ISO-8859-1. Эта функция не конвертирует такие
Windows-1252-символы корректно. Если требуется преобразование
из кодировки Windows-1252, пользуются другой функцией.
&reftitle.parameters;
string
Строка ISO-8859-1.
&reftitle.returnvalues;
Функция возвращает строку string, которую она преобразовала в кодировку в UTF-8.
&reftitle.changelog;
&Version;
&Description;
8.2.0
This function has been deprecated.
7.2.0
Функция перенесли из модуля XML в ядро PHP.
В предыдущих версиях функция была доступна только при установленном модуле XML.
&reftitle.examples;
Простой пример
]]>
&example.outputs;
&reftitle.notes;
Устаревание и альтернативы
С PHP 8.2.0 функция устарела и её удалят в будущей версии.
Требуется проверить и заменить вызовы этой функции в коде альтернативынми функциями.
Аналогичную функциональность даёт функция mb_convert_encoding,
которая поддерживает кодировку ISO-8859-1 и многие другие кодировки символов.
]]>
&example.outputs;
Другие опции, которые могут быть доступны в зависимости от установленных модулей:
UConverter::transcode и iconv.
Каждый следующий вариант даёт одинаковый результат:
]]>
&example.outputs;
&reftitle.seealso;
utf8_decode
mb_convert_encoding
UConverter::transcode
iconv