idn_to_ascii

(PHP 5 >= 5.3.0, PECL intl >= 1.0.2, PECL idn >= 0.1)

idn_to_ascii — ドメイン名をIDNAのASCII形式に変換する

説明

手続き型

string idn_to_ascii ( string $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

参考

idn_to_unicode() - idn_to_utf8 のエイリアス

add a note User Contributed Notes idn_to_ascii

Eman 11-Nov-2010 04:57


With PHP 5.3 I started to recieve 



Fatal error: Only variables can be passed by reference 



when trying to call idn_to_ascii with second optional parameter (IDNA_DEFAULT). 

Moreover these IDNA_* constants are seem to be undefined in PHP 5.3. + PECL idn 0.0.2



When I tried to uninstall PECL idn and install PECL intl (1.1.1) i recieved this:



/tmp/pear/temp/intl/collator/collator_class.c:92: error: duplicate ‘static’

/tmp/pear/temp/intl/collator/collator_class.c:96: error: duplicate ‘static’

/tmp/pear/temp/intl/collator/collator_class.c:101: error: duplicate ‘static’

/tmp/pear/temp/intl/collator/collator_class.c:107: error: duplicate ‘static’

make: *** [collator/collator_class.lo] Error 1



So probably compiling PHP 5.3. from sources with --enable-intl will help, but it only means that PHP 5.3. intl version differs from the one available at PECL, which isn't good, I think.



I've made my code working again by giving second idn_to_ascii parameter as simple integer variable (with value 0), but something bad is going on here and i will not be surprised if it'll break again after another PHP update...

add a note