# idn_to_utf8

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

idn_to_utf8 — Convierte un nombre de dominio de IDNA ASCII a Unicode

### Descripción

Estilo por procedimientos

idn_to_utf8(
string `$domain`,
int `$options` = 0,
int `$variant` = INTL_IDNA_VARIANT_2003,
array `&$idna_info` = ?
): string

Esta función convierte un nombre de dominio Unicode de un formato compatible con IDNA ASCII a Unicode plano, codificado en UTF.8.

### Parámetros

`domain`

  Dominio a convertir en formato IDNA ASCII-compatible.

`options`

  Opciones de conversión - combinación de constantes IDNA_* (excepto las constantes IDNA_ERROR_*).

`variant`

  `INTL_IDNA_VARIANT_2003` para IDNA 2003 o `INTL_IDNA_VARIANT_UTS46` para UTS #46.

`idna_info`

  Este parámetro sólo se puede usar si `INTL_IDNA_VARIANT_UTS46` se utilizó para `variant`. En este caso, será llenado con un array con las claves `'result'`, la posibilidad de un resultado ilegal de la transformación, `'isTransitionalDifferent'`, un booleano indicando si el uso de los mecanismos de transición de UTS #46 ha cambiado o debería haber cambiado el resulado, y `'errors'`, que es de tipo int y representa un conjunto de bits de las constantes de error IDNA_ERROR_*.

### Valores devueltos

Un nombre de dominio en Uniconde, codificado en UTF-8. o `false` en caso de error

### Historial de cambios

Versión | Descripción
--- | ---
5.4.0/PECL 2.0.0b1 | Se añadieron los parámetros `variant` y `idna_info`; y el soporte para UTS #46.

### Ejemplos

Ejemplo #1 Ejemplo de idn_to_utf8()

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

El resultado del ejemplo sería:

    täst.de

### Ver también

- idn_to_unicode()