idn_to_ascii

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

idn_to_asciiConvertit un nom de domaine au format IDNA ASCII

Description

Style procédural

idn_to_ascii ( string $domain [, int $options = IDNA_DEFAULT [, int $variant = INTL_IDNA_VARIANT_UTS46 [, array &$idna_info ]]] ) : string

Cette fonction convertit un nom de domaine Unicode au format IDNA ASCII-compatible.

Liste de paramètres

domain

Le domaine à convertir, qui doit être encodé UTF-8.

options

Options de conversion - combinaison de 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 cosntante INTL_IDNA_VARIANT_UTS46 a été utilisée dans le paramètre variant. Dans ce cas, ce sera un tableau avec la clé 'result' contenant le résultat de la transformation, la clé 'isTransitionalDifferent' contenant un booléen indiquant l'utilisation du mécanisme transitionnel UTS #46 ayant altéré ou non le résultat, et la clé 'errors' contenant un int représentant un jeu de bits des constantes d'erreurs IDNA_ERROR_*.

Valeurs de retour

Le nom de domaine encodé au format ASCII-compatible. 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écié; utiliser INTL_IDNA_VARIANT_UTS46 à la place.
5.4.0/PECL 2.0.0b1 Ajout du paramètre variant et du paramètre idna_info ; Support de l'UTS #46 (nécessite ICU ≥ 4.6).

Exemples

Exemple #1 Exemple avec idn_to_ascii()

<?php

echo idn_to_ascii('täst.de'); 

?>

L'exemple ci-dessus va afficher :

xn--tst-qla.de

Voir aussi

  • idn_to_utf8() - Convertit le nom de domaine IDNA ASCII en Unicode