PHP Locale 怎样把区域标识拆成语言脚本和地区

PHP 的 Locale 可以把一个区域标识拆成语言、文字体系和地区三个子标签。最直接的做法是分别调用 Locale::getPrimaryLanguage()、Locale::getScript() 和 Locale::getRegion()，不要自己按连字符或下划线切字符串。

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

这类数据经常来自请求参数、用户偏好或租户配置。安全边界要先划清：解析结果只代表区域配置，不能直接代表权限、数据范围或“该地区一定有翻译资源”。

先把区域标识当作受控配置

Locale 文档中的示例包括 en-US、zh-Hant-TW 等形式，也兼容传统的下划线标识。应用如果把它当成任意字符串直接落库，后续很难判断它来自哪个入口、是否属于产品支持范围。

建议把原始输入、规范化后的输入和解析结果分开保存。支持列表由产品资源决定，不能因为 ICU 能识别某个标签，就自动把它开放给所有用户。

使用 Locale 方法拆出三个字段

三个方法的职责很窄：getPrimaryLanguage 读取主要语言，getScript 读取脚本子标签，getRegion 读取地区子标签。脚本或地区不存在时，返回值可能是 null，所以不要把空值强行改成默认地区。

 $language,
    'script' => $script,
    'region' => $region,
];

var_export($parts);
?>

对这个示例，结构化结果应表达 zh、Hant 和 TW。如果输入只有 fr，脚本和地区就应保持缺失，而不是凭经验补成某个国家。

把输入攻击面和解析结果分开

这里的“攻击面”不一定是恶意代码，也包括超长输入、未登记的标签、错误来源和把区域偏好误用为业务条件。解析函数负责读字段，应用仍要负责限制入口。

 'zh-Hant-TW',
    'en_us' => 'en-US',
];

$option = $_GET['locale'] ?? '';
if (!is_string($option) || strlen($option) > 32) {
    throw new InvalidArgumentException('区域选项格式不受支持');
}

// 先按内部键查表，避免把任意请求值直接作为业务配置。
if (!isset($supported[$option])) {
    throw new InvalidArgumentException('区域选项未登记');
}

$value = $supported[$option];
$parts = [
    'language' => Locale::getPrimaryLanguage($value),
    'script' => Locale::getScript($value),
    'region' => Locale::getRegion($value),
];

// 审计时记录内部键和结果，不必保存完整请求对象。
error_log(json_encode(['option' => $option, 'parts' => $parts], JSON_UNESCAPED_UNICODE));
?>

这个例子把用户可选值映射到内部配置，再进行字段提取。实际项目还可以在保存时记录配置版本；不要把 region 当成租户筛选条件，也不要因为解析成功就放宽授权。

按风险分级处理缺失字段

最常见的三种情况应分开记录：

• 字段缺失：输入只有语言，getScript 或 getRegion 返回 null，这是可接受的配置状态。
• 选项未登记：请求值不在应用支持列表中，应在进入 Locale 解析前拒绝。
• 解析结果不符合业务：方法得到字符串，但产品没有对应资源或格式化策略，应该回退到业务定义的默认项。

不要用“非空”作为唯一成功条件，也不要把所有异常都改写成默认 en-US。默认值应来自产品配置，并在审计记录中可追踪。

交付前的审计与核对清单

发布这段能力前，至少确认输入来源、最大长度、内部选项键、默认回退、日志字段和权限边界都有明确负责人。代码调用层只消费结构化字段，权限层继续使用自己的授权数据。

1. 是否启用了 intl 扩展，并在部署说明中写明？
2. 是否用 Locale 方法取字段，而不是按分隔符手工拆分？
3. 是否允许缺失脚本或地区，并对 null 做了明确处理？
4. 是否先检查产品支持列表，再接受用户的区域选项？
5. 是否把区域偏好与租户、数据权限、计费地区等字段分开？
6. 审计日志是否只保留必要的内部键、配置版本和解析结果？

只有语言没有地区时需要补一个地区吗？

不需要。缺失就是缺失，只有业务确实要求地区时才按支持列表选择默认值。

返回了地区字段就说明该地区可用吗？

不说明。它只表示 Locale 方法提取到了子标签，资源是否存在要由应用自己的支持配置决定。

为什么不直接 explode 分隔符？

区域标识可能包含脚本、地区和变体等子标签，手工按位置拆分容易把格式变化误当成固定结构；使用 Locale 方法更容易表达字段职责。

参考资料：PHP 官方 Locale 类文档、Locale::getPrimaryLanguage()、Locale::getScript() 与 Locale::getRegion() 文档。