(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 = "This is the Euro symbol '€'.";
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 : This is the Euro symbol '€'. TRANSLIT : This is the Euro symbol 'EUR'. IGNORE : This is the Euro symbol ''. 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.