IDN_TO_ASCII(3) 1 IDN_TO_ASCII(3)
idn_to_ascii - Convert domain name to IDNA ASCII form.
Procedural style
SYNOPSIS
string idn_to_ascii (string $domain, [int $options], [int $variant = INTL_IDNA_VARIANT_2003], [array &$idna_info])
DESCRIPTION
This function converts Unicode domain name to IDNA ASCII-compatible format.
PARAMETERS
o $domain
- Domain to convert. In PHP 5 must be UTF-8 encoded.
o $options
- Conversion options - combination of IDNA_* constants (except IDNA_ERROR_* constants).
o $variant
- Either INTL_IDNA_VARIANT_2003 for IDNA 2003 or INTL_IDNA_VARIANT_UTS46 for UTS #46.
o $idna_info
- This parameter can be used only if INTL_IDNA_VARIANT_UTS46 was used for $variant. In that case, it will be filled with an array
with the keys 'result', the possibly illegal result of the transformation, 'isTransitionalDifferent', a boolean indicating whether
the usage of the transitional mechanisms of UTS #46 either has or would have changed the result and 'errors', which is an int rep-
resenting a bitset of the error constants IDNA_ERROR_*.
RETURN VALUES
Domain name encoded in ASCII-compatible form. or FALSE on failure
CHANGELOG
+-------------------+---------------------------------------------------+
| Version | |
| | |
| | Description |
| | |
+-------------------+---------------------------------------------------+
|5.4.0/PECL 2.0.0b1 | |
| | |
| | Added the parameters $variant and $idna_info; |
| | UTS #46 support. |
| | |
+-------------------+---------------------------------------------------+
EXAMPLES
Example #1
idn_to_ascii(3) example
<?php
echo idn_to_ascii('tast.de');
?>
The above example will output:
xn--tst-qla.de
SEE ALSO
idn_to_unicode(3).
PHP Documentation Group IDN_TO_ASCII(3)