idn_to_ascii
(PHP 5 >= 5.3.0, PHP 7, PECL intl >= 1.0.2, PECL idn >= 0.1)
idn_to_ascii — ドメイン名をIDNAのASCII形式に変換する
説明
手続き型
idn_to_ascii
( string $domain
[, int $options = IDNA_DEFAULT
[, int $variant = INTL_IDNA_VARIANT_UTS46
[, array &$idna_info
]]] ) : string|false
Unicode のドメイン名を、IDNAが定めたASCII形式に変換します。
パラメータ
domain- 変換するドメイン名。UTF-8 にエンコードされている必要があります。
options- 変換オプション - IDNA_ ではじまる定数 (IDNA_ERROR_* 定数を除く) の組み合わせです。
variant- IDNA 2003 の場合は
INTL_IDNA_VARIANT_2003(PHP 7.2.0 以降は非推奨)、あるいは UTS #46 の場合はINTL_IDNA_VARIANT_UTS46(ICU 4.6 以降のみ利用可能)。 idna_info- このパラメータを使うのは、
variantがINTL_IDNA_VARIANT_UTS46の場合だけです。 このとき、このパラメータには'result'、'isTransitionalDifferent'、そして'errors'の三つのキーを含む配列が入ります。'result'にはおそらく不正だと考えられる変換結果、'isTransitionalDifferent'には UTS #46 の非移行的な機能を使って結果を変更したかどうかをあらわす boolean 値、そして'errors'はエラー定数 IDNA_ERROR_* のビットセットを表します。
返り値
IDNA のASCII形式でエンコードされたドメイン名。失敗した場合に false を返します
変更履歴
| バージョン | 説明 |
|---|---|
| 7.4.0 | variant のデフォルト値が
|
| 7.2.0 | INTL_IDNA_VARIANT_2003 は非推奨です。代わりに
|
例
例1 idn_to_ascii() の例
<?phpecho idn_to_ascii('tast.de'); ?>
上の例の出力は以下となります。
xn--tst-qla.de
