idn_to_utf8

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

idn_to_utf8 — 將域名從 IDNA ASCII 轉(zhuǎn)換為 Unicode

說明

過程化風(fēng)格

idn_to_utf8(
    string $domain,
    int $options = IDNA_DEFAULT,
    int $variant = INTL_IDNA_VARIANT_UTS46,
    array &$idna_info = ?
): string|false

該函數(shù)將 Unicode 域名從 IDNA ASCII 兼容格式轉(zhuǎn)換為 純 Unicode（UTF-8 編碼）。

參數(shù)

domain

要轉(zhuǎn)換的 IDNA ASCII 兼容格式的域名。

options

轉(zhuǎn)換選項(xiàng) — IDNA_* 開頭的常量（除 IDNA_ERROR_* 開頭的常量）。

variant

對(duì)于 IDNA 2003 是 INTL_IDNA_VARIANT_2003 (自 PHP 7.2.0 起已棄用)， 對(duì)于 UTS #46 是 INTL_IDNA_VARIANT_UTS46 (僅 ICU 4.6 起可用)。

idna_info

僅當(dāng) INTL_IDNA_VARIANT_UTS46 用于 variant 時(shí)，才可以使用該參數(shù)。 在這種情況下，它將用這些鍵組成的數(shù)組來填充： 'result' 鍵，轉(zhuǎn)換結(jié)果（有可能是一個(gè)非法結(jié)果）； 'isTransitionalDifferent' 鍵，布爾值，指示使用 UTS #46 的過濾機(jī)制是否會(huì)改變結(jié)果； 'errors' 鍵，是 IDNA_ERROR_* 常量集里一個(gè)常量對(duì)應(yīng)的 int 。

返回值

UTF-8 編碼的 Unicode 域名， 或者在失敗時(shí)返回 false

更新日志

版本 說明
7.4.0 現(xiàn)在 variant 的默認(rèn)值為 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'); 

?>

以上例程會(huì)輸出：

t?st.de

參見