Locale::lookup()函数—用法及示例

函数：Locale::lookup()

适用版本：PHP 5 >= 5.3.0, PHP 7, PHP 8

用法：Locale::lookup() 函数用于从一个或多个语言标记中查找最佳匹配的语言标记。它可以帮助你根据用户的首选语言标记来选择合适的语言环境。

语法：

public static string|false Locale::lookup(array $langtag, string $locale, bool $canonicalize = false, string $default = null)

参数：

• $langtag：一个包含一个或多个语言标记的数组。语言标记应该遵循 BCP 47 标准。数组中的语言标记按照优先级排序，最高优先级的语言标记应该位于数组的第一个元素。
• $locale：用于查找的语言环境。语言环境应该遵循 BCP 47 标准。
• $canonicalize（可选）：一个布尔值，指示是否将返回的语言标记规范化为 BCP 47 标准格式。默认为 false。
• $default（可选）：一个可选的默认语言标记，如果找不到匹配的语言标记时将被返回。

返回值：

• 如果找到匹配的语言标记，则返回最佳匹配的语言标记。
• 如果找不到匹配的语言标记，并且提供了默认语言标记，则返回默认语言标记。
• 如果找不到匹配的语言标记，并且没有提供默认语言标记，则返回 false。

示例：

// 定义一个语言标记数组
$langtags = ['en-US', 'fr-FR', 'de-DE'];

// 查找最佳匹配的语言标记
$bestMatch = Locale::lookup($langtags, 'fr-FR');
echo $bestMatch; // 输出：fr-FR

// 使用默认语言标记
$bestMatch = Locale::lookup($langtags, 'es-ES', false, 'en-US');
echo $bestMatch; // 输出：en-US

在上面的示例中，我们定义了一个包含英语、法语和德语的语言标记数组。然后，我们使用 Locale::lookup() 函数来查找最佳匹配的语言标记。在第一个示例中，由于我们提供的语言环境 'fr-FR' 与数组中的 'fr-FR' 语言标记完全匹配，所以它被返回作为最佳匹配的语言标记。在第二个示例中，由于我们提供的语言环境 'es-ES' 在数组中找不到匹配的语言标记，所以我们使用了默认语言标记 'en-US'。因此，'en-US' 被返回作为最佳匹配的语言标记。