# idn_to_utf8

(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.2, PECL idn >= 0.1)

idn_to_utf8 — Convertit le nom de domaine IDNA ASCII en Unicode

### Description

Style procédural

idn_to_utf8(
string `$domain`,
int `$flags` = `IDNA_DEFAULT`,
int `$variant` = `INTL_IDNA_VARIANT_UTS46`,
array `&$idna_info` = `null`
): string|false

Cette fonction convertit le nom de domaine au format IDNA ASCII-compatible en Unicode, encodé en UTF-8.

### Liste de paramètres

`domain`

  Domaine à convertir depuis le format IDNA ASCII-compatible.

`flags`

  Options de conversion - une combinaison des constantes IDNA_* (sauf les constantes IDNA_ERROR_*).

`variant`

  Soit `INTL_IDNA_VARIANT_2003` (obsolète à partir de PHP 7.2.0) pour IDNA 2003, soit `INTL_IDNA_VARIANT_UTS46` (seulement disponible à partir de ICU 4.6) pour UTS #46.

`idna_info`

  Ce paramètre ne peut être utilisé que si la constante `INTL_IDNA_VARIANT_UTS46` a été utilisée comme paramètre pour `variant`. Dans ce cas, ce paramètre sera rempli par un tableau dont la clé `'result'` contiendra le résultat de la transformation, la clé `'isTransitionalDifferent'` contiendra un booléen indiquant si l'utilisation du mécanisme transitionnel UTS #46 a altéré ou non le résultat, et la clé `'errors'` contiendra un int représentant un jeu de bits de constantes d'erreurs IDNA_ERROR_*.

### Valeurs de retour

Nom de domaine en Unicode, encodé UTF-8. ou `false` si une erreur survient

### Historique

Version | Description
--- | ---
7.4.0 | La valeur par défaut du paramètre `variant` est maintenant `INTL_IDNA_VARIANT_UTS46` à la place de la constante `INTL_IDNA_VARIANT_2003` déprécié.
7.2.0 | `INTL_IDNA_VARIANT_2003` a été déprécie; utiliser `INTL_IDNA_VARIANT_UTS46` à la place.

### Exemples

Exemple #1 Exemple avec idn_to_utf8()

`<?php
echo idn_to_utf8('xn--tst-qla.de');
?>`

L'exemple ci-dessus va afficher :

    täst.de

### Voir aussi

- idn_to_ascii() - Convertit un nom de domaine au format IDNA ASCII