php man page for idn_to_ascii

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)