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 = 0 [, int $variant = INTL_IDNA_VARIANT_2003 [, array &$idna_info ]]] ) : string

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

パラメータ

domain

変換するドメイン名。UTF-8 にエンコードされている必要があります。

options

変換オプション - IDNA_ ではじまる定数 (IDNA_ERROR_* 定数を除く) の組み合わせです。

variant

IDNA 2003 の場合は INTL_IDNA_VARIANT_2003、あるいは UTS #46 の場合は INTL_IDNA_VARIANT_UTS46

idna_info

このパラメータを使うのは、variantINTL_IDNA_VARIANT_UTS46 の場合だけです。 このとき、このパラメータには 'result''isTransitionalDifferent'、そして 'errors' の三つのキーを含む配列が入ります。 'result' にはおそらく不正だと考えられる変換結果、 'isTransitionalDifferent' には UTS #46 の非移行的な機能を使って結果を変更したかどうかをあらわす boolean 値、そして 'errors' はエラー定数 IDNA_ERROR_* のビットセットを表します。

返り値

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

変更履歴

バージョン 説明
7.2.0 INTL_IDNA_VARIANT_2003 は非推奨です。代わりに INTL_IDNA_VARIANT_UTS46 を使用してください。
5.4.0/PECL 2.0.0b1 パラメータ variantidna_info が追加され、UTS #46 をサポートするようになりました。

例1 idn_to_ascii() の例

<?php

echo idn_to_ascii('tast.de'); 

?>

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

xn--tst-qla.de

参考

  • idn_to_utf8() - IDNAのASCII方式でエンコードされたドメイン名をUnicodeに変換する