utf8_encode
Converte uma string ISO-8859-1 em UTF-8
&warn.deprecated.function-8-2-0;
&reftitle.description;
#[\Deprecated]
stringutf8_encode
stringstring
Esta função converte a string string da codificação
ISO-8859-1 para a UTF-8.
Esta função não tenta descobrir a codificação da string fornecida,
ela assume que esteja codificada como ISO-8859-1 (também conhecida como "Latin 1")
e converte-a para UTF-8. Como toda sequência de bytes é uma string ISO-8859-1
válida, isto nunca irá resultar em erro, mas não irá resultar em uma string útil
se uma codificação diferente era a intenção.
Muitas páginas da web que dizem usar a codificação ISO-8859-1
na verdade usam a codificação similar Windows-1252,
e os navegadores irão interpretar as páginas ISO-8859-1 como
Windows-1252. Windows-1252 apresenta
caracteres imprimíveis adicionais, como o símbolo do Euro
(€) e aspas inglesas (“
”), ao invés de certos caracteres de controle
ISO-8859-1. Esta função não converterá esses caracteres
Windows-1252 corretamente. Use uma função diferente
se a conversão de Windows-1252 for requerida.
&reftitle.parameters;
string
Uma string em ISO-8859-1.
&reftitle.returnvalues;
Retorna a conversão em UTF-8 da string.
&reftitle.changelog;
&Version;
&Description;
8.2.0
Esta função foi descontinuada.
7.2.0
Esta função foi movida de extensão XML para o núcleo do PHP.
Em versões anteriores, estava disponível somente se a extensão XML estivesse instalada.
&reftitle.examples;
Exemplo básico
]]>
&example.outputs;
&reftitle.notes;
Descontinuação e alternativas
Esta função foi descontinuada a partir do PHP 8.2.0,
e será removida em uma versão futura. Usos existentes devem ser verificados
e substituídos com alternativas apropriadas.
Funcionalidade similar pode ser obtida com mb_convert_encoding,
que suporta ISO-8859-1 e muitas outras codificações de caracteres.
]]>
&example.outputs;
Outros exemplos que podem estar disponíveis dependendo das extensões instaladas são
UConverter::transcode e iconv.
Todos os exemplos a seguir dão o mesmo resultado:
]]>
&example.outputs;
&reftitle.seealso;
utf8_decode
mb_convert_encoding
UConverter::transcode
iconv