(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
iconv — Converte uma string de uma codificação de caracteres para outra
Converte string de from_encoding
para to_encoding.
from_encoding
A codificação atual usada para interpretar string.
to_encodingA codificação desejada do resultado.
Se a string //TRANSLIT for anexada a
to_encoding, a transliteração será ativada. Isso
significa que, quando um caractere não pode ser representado no conjunto de caracteres de destino,
ele pode ser aproximado por meio de um ou vários caracteres de aparência
semelhante. Se a string //IGNORE for anexada,
os caracteres que não podem ser representados no charset de destino são
descartados silenciosamente. Caso contrário, E_NOTICE é gerado e
a função retornará false.
Como //TRANSLIT funciona exatamente depende da
implementação do iconv() do sistema (cf. ICONV_IMPL).
Algumas implementações são conhecidas por ignorar //TRANSLIT,
então a conversão provavelmente falhará para caracteres que são ilegais
para to_encoding.
stringA string a ser convertida
Retorna a string convertida, ou false em caso de falha.
Exemplo #1 Exemplo iconv()
<?php
$text = "Este é o símbolo do Euro '€'.";
echo 'Original : ', $text, PHP_EOL;
echo 'TRANSLIT : ', iconv("UTF-8", "ISO-8859-1//TRANSLIT", $text), PHP_EOL;
echo 'IGNORE : ', iconv("UTF-8", "ISO-8859-1//IGNORE", $text), PHP_EOL;
echo 'Plain : ', iconv("UTF-8", "ISO-8859-1", $text), PHP_EOL;
?>O exemplo acima produzirá algo semelhante a:
Original : Este é o símbolo do Euro '€'. TRANSLIT : Este é o símbolo do Euro 'EUR'. IGNORE : Este é o símbolo do Euro ''. Plain : Notice: iconv(): Detected an illegal character in input string in .\iconv-example.php on line 7
Nota:
As codificações de caracteres e as opções disponíveis dependem da implementação instalada do iconv. Se o argumento para
from_encodingouto_encodingnão for suportado no sistema atual,falseserá retornado.