iconv

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

iconv — Convertit une chaîne de caractères à partir d'un encodage vers un autre

Description

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

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

Liste de paramètres

from_encoding

L'encodage actuellement utilisé pour interpréter string.

to_encoding

L'encodage souhaité du résultat.

Si la chaîne //TRANSLIT est ajoutée au paramètre to_encoding, alors 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 approché par un ou plusieurs caractères d'apparence similaire. Si la chaîne //IGNORE est ajoutée, les caractères ne pouvant être représentés dans le jeu de caractères cible seront silencieusement ignorés. Sinon, une 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émentations 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 : ', $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 '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     :
Notice: iconv(): Detected an illegal character in input string in .\iconv-example.php on line 7

Notes

Note:

L'encodage de caractères et les options disponibles dépendent 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