idn_to_ascii
(PHP 5 >= 5.3.0, PHP 7, PHP 8, PECL intl >= 1.0.2, PECL idn >= 0.1)
idn_to_ascii — 將域名轉換為 IDNA ASCII 格式
說明
過程化風格
idn_to_ascii(
string
int
int
array
): string|false
string
$domain,int
$options = IDNA_DEFAULT,int
$variant = INTL_IDNA_VARIANT_UTS46,array
&$idna_info = ?): string|false
該函式可以將 Unicode 域名轉換為 IDNA ASCII 相容格式。
參數
-
domain -
要轉換的域，必須使用 UTF-8 編碼。
-
options -
轉換選項 — 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時，才可以使用該參數。 在這種情況下，它將用這些鍵組成的陣列來填充：'result'鍵，轉換結果（有可能是一個非法結果）；'isTransitionalDifferent'鍵，布爾值，指示使用 UTS #46 的過濾機制是否會改變結果；'errors'鍵，是 IDNA_ERROR_* 常量集里一個常量對應的 int 。
返回值
IDNA ASCII 相容格式編碼的域名， 或者在失敗時返回 false
更新日誌
| 版本 | 說明 |
|---|---|
| 7.4.0 |
現在 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