PHP Locale 怎样按语言地区字段组合区域标识

PHP 可以用 Locale::composeLocale() 把语言、文字体系和地区字段组合成区域标识。将代码放入 language、script、region 等关联数组键，由函数处理位置与分隔符，避免应用自己手工拼接。组合成功只说明形成了标识，产品支持哪些语言地区仍应由业务配置决定。

官方地址：https://www.php.net/manual/en/locale.composelocale.php

以一个多语言报表服务为例，后台分别保存语言和地区，界面还允许选择文字体系。实现时把“显示名称”“内部选项键”“区域标识”分开，能避免后续扩展语言时修改所有调用方。以下是原创配置示例，未声明在本机实际执行。

把字段职责固定下来

上述字段表达中文、繁体文字和台湾地区这一配置。不要把中文显示名称直接交给函数，也不要从地区字段擅自推断所有用户的语言。业务表单显示名称，存储层保存代码；同一个地区可以对应不同语言需求。

准备 intl 并组合区域标识

Locale 属于 intl，部署配置应包含这个依赖。示例故意把 region 写在 language 前面：关联键说明字段含义，数组插入顺序不应成为拼接约定。

 'TW',
    'language' => 'zh',
    'script' => 'Hant',
];
// 使用字段键表达语义，不手工连接表单字符串。
$locale = Locale::composeLocale($fields);
if ($locale === false) {
    throw new RuntimeException('区域标识组合失败');
}
echo $locale;

这组字段表达 zh_Hant_TW。输出适合作为需要区域标识的组件的配置值，不是用户可见的语言名称，也不是 HTTP 语言首选项协议的完整替代品。

用受控选项限定产品支持范围

生产配置更适合先定义允许的选项，再让用户选择内部键。这样产品支持范围来自配置表，函数只负责形成标识。不要将整个请求数组直接转交给 composeLocale，尤其是暂不提供扩展标签的产品。

 ['language' => 'zh', 'script' => 'Hant', 'region' => 'TW'],
    'french_ca' => ['language' => 'fr', 'region' => 'CA'],
];
$choice = 'french_ca'; // 实际项目从用户设置请求取得内部选项键。
if (!isset($choices[$choice])) {
    throw new InvalidArgumentException('不支持的区域选项');
}
$locale = Locale::composeLocale($choices[$choice]);
if ($locale === false) {
    throw new RuntimeException('区域配置组合失败');
}
// 将结果传给需要它的组件，避免随意修改进程默认配置。

这里的两个选项是本文应用的演示数据，不是 PHP 官方认可的完整支持清单。是否提供某个选项，应结合翻译资源和业务需求决定。地区偏好也不能代替数据权限：选择某地区不应获得该地区业务数据的访问权。

区分空输入、未知选项与扩展字段

官方文档说明空 subtags 数组返回 false，因此代码使用严格比较。未知选项则在调用前拒绝。两者原因不同，日志可以分别记录“选项不存在”和“配置构造失败”，不必保存整个用户请求。

variant、private、extlang 可以采用带数字后缀的键，也有数组表达形式。本文的最小配置只开放 language、script、region；需要扩展标签时，再明确数据模型与可接受值，不要把函数能识别的形式全部直接开放到公开接口。仅有语言需求时，也不必虚构地区或文字体系来补齐字段。

记录配置来源并固定调用约定

建议持久化内部选项键，并记录配置版本和生成后的标识。这样遇到某张报表格式不符，可以找到配置来源，而不是只看到一个无来源的字符串。修改现有偏好时继续走同一映射表，避免某个接口用连字符、另一个接口用下划线自行拼接。

交付这段功能时，应明确 intl 依赖、支持选项、失败处理及调用方期待的区域格式。composeLocale 不会替应用安装语言资源，也不会自动改变所有组件的默认区域。将产品选项、标识构造和组件行为分开，配置问题会更容易定位。

只有 language 能组合吗？

可以按需求只提供语言字段；没有地区选择时，不应为了形式完整随意补一个地区。

组合成功就说明翻译可用吗？

不能。字符串形成与翻译资源是否存在是两件事，应用应以自己的支持列表为准。

是否应该每次都修改默认区域？

若组件允许显式传入标识，优先在调用处使用该值。是否修改全局默认配置，应由应用架构统一决定。

参考：PHP 官方 composeLocale 文档。