idn_to_ascii

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

idn_to_ascii — ドメイン名をIDNAのASCII形式に変換する

手続き型

string idn_to_ascii ( string $domain [, int $options = 0 [, int $variant = INTL_IDNA_VARIANT_2003 [, array &$idna_info ]]] )

Unicode のドメイン名を、IDNAが定めたASCII形式に変換します。

domain: 変換するドメイン名 PHP5 では、UTF-8にエンコードされている必要があります。
options: 変換オプション - IDNA_ ではじまる定数 (IDNA_ERROR_* 定数を除く) の組み合わせです。
variant: IDNA 2003 の場合は INTL_IDNA_VARIANT_2003、あるいは UTS #46 の場合は INTL_IDNA_VARIANT_UTS46。
idna_info: このパラメータを使うのは、variant が INTL_IDNA_VARIANT_UTS46 の場合だけです。このとき、このパラメータには 'result'、 'isTransitionalDifferent'、そして 'errors' の三つのキーを含む配列が入ります。 'result' にはおそらく不正だと考えられる変換結果、 'isTransitionalDifferent' には UTS #46 の非移行的な機能を使って結果を変更したかどうかをあらわす boolean 値、そして 'errors' はエラー定数 IDNA_ERROR_* のビットセットを表します。

IDNA のASCII形式でエンコードされたドメイン名。失敗した場合に FALSE を返します

バージョン	説明
5.4.0/PECL 2.0.0b1	パラメータ `variant` と `idna_info` が追加され、UTS #46 をサポートするようになりました。

例1 idn_to_ascii() の例


<?php

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

?>

上の例の出力は以下となります。

xn--tst-qla.de