idn_to_ascii
intl
Idn Функции
PHP Manual

# idn_to_utf8

(PECL idn >= 0.1)

idn_to_utf8 — Convert ASCII encoded domain name to UTF-8

### Описание

string idn_to_utf8 ( string `$ascii_domain` [, int `&$errorcode` ] )

This function converts a ASCII encoded domain name to its original UTF-8 version.

### Список параметров

`ascii_domain`

  The ASCII encoded domain name. Looks like "xn--..." if the it originally contained non-ASCII characters.

`errorcode`

  Will be set to the IDNA error code.

### Возвращаемые значения

The UTF-8 encoded version of the domain name or `FALSE` in case of an error. RFC 3490 4.2 states though "ToUnicode never fails. If any step fails, then the original input sequence is returned immediately in that step."

### Errors/Exceptions

If an error occurs `FALSE` is returned and the optional errorcode is set. In addition a E_WARNING message is printed.

### Примеры

Пример #1 idn_to_utf8() example

First a simple example and then one explaining how to catch errors (which should never happen according to the RFC).

`<?php
// maybe convert the result to ISO-8859-1 using utf8_decode()
echo idn_to_utf8("xn--tst-qla.de");
// Should never happen but to be sure...
$utf8 = idn_to_utf8("xn--tst-qla.de", $errorcode);
if ($utf8 === false) {
printf("Detected error %d: %s\n", $errorcode, idn_strerror($errorcode));
}
?>`

Результатом выполнения данного примера будет что-то подобное:

    täst.de

### Смотрите также

- utf8_decode() - Converts a string with ISO-8859-1 characters encoded with UTF-8 to single-byte ISO-8859-1
- idn_strerror() - Returns string describing the IDNA error code
- idn_to_ascii() - Convert UTF-8 encoded domain name to ASCII

idn_to_ascii
intl
Idn Функции
PHP Manual