(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.2, PECL idn >= 0.1)
idn_to_utf8 — IDNAのASCII方式でエンコードされたドメイン名をUnicodeに変換する
手続き型
$domain
,$flags
= IDNA_DEFAULT
,$variant
= INTL_IDNA_VARIANT_UTS46
,&$idna_info
= null
IDNAのASCII方式でエンコードされたドメイン名をUTF-8でエンコードされたUnicodeに変換します。
domain
IDNAのASCII方式でエンコードされた、変換対象のドメイン名
flags
変換オプション - 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_* のビットセットを表します。
Unicodeのドメイン名。UTF-8 にエンコードされています。失敗した場合に false
を返します
バージョン | 説明 |
---|---|
7.4.0 | variant のデフォルト値が INTL_IDNA_VARIANT_UTS46 となり、 その代わりに INTL_IDNA_VARIANT_2003 は非推奨となりました。 |
7.2.0 | INTL_IDNA_VARIANT_2003 は非推奨です。代わりに INTL_IDNA_VARIANT_UTS46 を使用してください。 |
例1 idn_to_utf8() の例
<?php
echo idn_to_utf8('xn--tst-qla.de');
?>
上の例の出力は以下となります。
tast.de