idn_to_ascii

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

idn_to_ascii — 將域名轉(zhuǎn)換為 IDNA ASCII 格式

說明

過程化風格

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

該函數(shù)可以將 Unicode 域名轉(zhuǎn)換為 IDNA ASCII 兼容格式。

參數(shù)

domain

要轉(zhuǎn)換的域，必須使用 UTF-8 編碼。

options

轉(zhuǎn)換選項 — 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

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

返回值

IDNA ASCII 兼容格式編碼的域名， 或者在失敗時返回 false

更新日志

版本 說明
7.4.0 現(xiàn)在 variant 的默認值為 INTL_IDNA_VARIANT_UTS46 ， 而不是已棄用的 INTL_IDNA_VARIANT_2003 。
7.2.0 INTL_IDNA_VARIANT_2003 已被棄用； 可以使用 INTL_IDNA_VARIANT_UTS46 代替。

范例

示例 #1 idn_to_ascii() 示例

<?php

echo idn_to_ascii('t?st.de'); 

?>

以上例程會輸出：

xn--tst-qla.de

參見

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