iconv

(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)

iconvConvertit une chaîne de caractères d'un encodage à un autre

Description

iconv(string $from_encoding, string $to_encoding, string $string): string|false

Convertit la chaîne string de from_encoding vers l'encodage to_encoding.

Liste de paramètres

from_encoding

L'encodage utilisé pour interpréter string.

to_encoding

L'encodage de sortie souhaité.

Si vous ajoutez la chaîne //TRANSLIT au paramètre to_encoding, la translittération est activée. Cela signifie que lorsqu'un caractère ne peut être représenté dans le jeu de caractères cible, il peut être représenté approximativement à partir d'un ou plusieurs caractères représentant le même caractère. Si vous ajoutez la chaîne //IGNORE, les caractères ne pouvant être représentés dans le jeu de caractères cible seront tout simplement ignorés. Sinon, une alerte de niveau E_NOTICE sera générée et la fonction retournera false.

Attention

Si et comment //TRANSLIT fonctionne exactement dépend de l'implémentation iconv() du système (cf. ICONV_IMPL). Certaines implémentation sont connues pour ignorer //TRANSLIT, donc la conversion de caractères illégaux échouera probablement pour to_encoding.

string

La chaîne de caractères à convertir.

Valeurs de retour

Retourne la chaîne de caractères convertie, ou false si une erreur survient.

Exemples

Exemple #1 Exemple avec iconv()

<?php
$text 
"Ceci est le symbole de l'Euro '€'.";

echo 
'Original : '$textPHP_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 
'Brut     : 'iconv("UTF-8""ISO-8859-1"$text), PHP_EOL;
?>

Résultat de l'exemple ci-dessus est similaire à :

Original : Ceci est le symbole de l'Euro '€'.
TRANSLIT : Ceci est le symbole de l'Euro 'EUR'.
IGNORE   : Ceci est le symbole de l'Euro ''.
Brut     : Ceci est le symbole de l'Euro '
Notice: iconv(): Detected an illegal character in input string in /Users/macbook/Desktop/- on line 8
Ceci est le symbole de l'Euro '

Notes

Note:

L'encodage de caractères et les options disponibles dépende de l'implémentation d'iconv. Si l'argument de from_encoding ou to_encoding n'est pas pris en charge sur le système actuel, false sera retourné.

Voir aussi