(PHP 5 >= 5.3.0, PECL intl >= 1.0.2, PECL idn >= 0.1)
idn_to_ascii — ドメイン名をIDNAのASCII形式に変換する
手続き型
$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