PHP – idn_to_ascii()関数の使い方を徹底解説

PHPのidn_to_ascii()関数は、Unicodeで表記された国際化ドメイン名をIDNA ASCII形式（Punycode）に変換するための関数です。IDNAとは「Internationalizing Domain Names in Applications（アプリケーション内での国際化ドメイン名）」の略称で、ASCII以外の文字（日本語やウムラウト付き文字など）を含むドメイン名を扱うための仕組みです。DNSは元々ASCII文字しか扱えないため、この関数を使って「ä」などの非ASCII文字を含むドメインを「xn--」で始まるASCII互換の形式へ変換します。

構文

string idn_to_ascii(
   str $domain,
   integer $flags = IDNA_DEFAULT,
   integer $variant = INTL_IDNA_VARIANT_UTS46,
   arr &$idna_info = null
)

パラメータ

idn_to_ascii()関数は、以下の4つのパラメータを受け取ります。

• $domain − 変換対象となるドメイン名です。UTF-8でエンコードされている必要があります。

• $flags − IDNA_*系の定数を組み合わせて指定します。

• $variant − IDNA 2003規格を使用する場合はINTL_IDNA_VARIANT_2003、UTS#46を使用する場合はINTL_IDNA_VARIANT_UTS46を指定します。

• $idna_info − $variantパラメータにINTL_IDNA_VARIANT_UTS46が指定された場合にのみ使用されるパラメータで、変換処理の詳細情報が配列として格納されます。

戻り値

この関数は、ASCII互換形式（Punycode）にエンコードされたドメイン名を返します。変換に失敗した場合はfalseを返します。

例1：基本的な使い方

<?php
   // 文字列のドメイン名を変換
   print idn_to_ascii('täst.de', 0);
?>

出力結果

xn--tst-qla.de

ウムラウト付きの「täst.de」が、「xn--」プレフィックスを持つASCII互換形式に正しく変換されています。

例2：エンコード済み文字列の扱い

<?php
   // ISO-8859-2でエンコードされた文字列
   echo idn_to_ascii(utf8_encode('täst.de'));

   // "xn--"で始まるドメイン名は、非ASCII文字を
   // 含んでいても、すでにASCIIエンコード済みと
   // みなされるため変換されません
   $ascii = idn_to_ascii("xn--".chr(0xC3).chr(0xA4));
   print_r($ascii);
?>

出力結果

xn--tst-fea82a.de

この例では、utf8_encode()でエンコードした文字列を渡すケースと、「xn--」で始まるドメイン名の挙動を確認できます。すでに「xn--」プレフィックスを持つ文字列は、内部に非ASCIIバイトが含まれていても変換対象外となる点に注意してください。