php 8.6新增locale::getdisplaykeyword()和locale::getdisplaykeywordvalue(),可以分别将icu区域设置中的关键字名称和取值显示为指定语言。管理页要把calendar、currency显示成可理解的中文选项时,可先用getkeywords()读取关键字,再调用这两个方法;它们只生成显示文字,不负责切换应用货币或格式化金额。

区域设置关键字显示方法与日期骨架、数量区间是不同接口。
确认intl及方法版本
php -v php --ri intl
示例使用服务端预设的ICU locale字符串,不把未验证的请求参数直接当作任意配置。关键字语法采用@calendar=...;currency=...,与展示语言zh_CN分开传入。
<?php
if (PHP_VERSION_ID < 80600 || !extension_loaded('intl')
|| !method_exists('Locale', 'getDisplayKeywordValue')) {
throw new RuntimeException('需要PHP 8.6和intl');
}
$locale = 'de_DE@calendar=gregorian;currency=EUR';
$keywords = Locale::getKeywords($locale);
if ($keywords === false) throw new RuntimeException('区域设置解析失败');
$displayLocale = 'zh_CN';
$escape = static fn(string $v): string => htmlspecialchars(
$v, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
foreach ($keywords ?? [] as $key => $rawValue) {
$label = Locale::getDisplayKeyword($key, $displayLocale);
$value = Locale::getDisplayKeywordValue($locale, $key, $displayLocale);
$label = $label === false || $label === '' ? $key : $label;
$value = $value === false || $value === '' ? $rawValue : $value;
echo '<p>', $escape($label), ':', $escape($value), '</p>', PHP_EOL;
}保存为locale-options.php后运行php locale-options.php,查看生成的HTML。分别换成不带关键字的de_DE和另一种显示语言,确认无关键字时不生成伪造选项,语言改变时原始区域配置仍保持不变。getKeywords可能返回null,显示方法失败时返回false;上面为无法取得显示名称的情况保留原始值。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。

getDisplayKeywordValue需要完整locale和关键字,不能只传货币值。
让机器值与用户文案各司其职
表单提交和数据库继续保存受控的calendar、currency及其机器值,不把翻译后的中文名称当作唯一键。ICU数据版本可能改变译名或标点,测试应核对字段意义和安全输出,不应把某一译名写成所有版本恒定的断言。实际金额格式、时区和日期历法的应用仍要交给对应格式化器及业务配置处理。
立即学习“PHP免费学习笔记(深入)”;


















