多语言切换phpgettext复数ngettext写法-php教程-PHP中文网

`ngettext()` 在 PHP 中如何根据数量正确返回复数形式

php 的 ngettext() 函数通过检查传入的数量参数，自动从翻译文件中选择单数或复数形式的字符串。要正确使用它，需要调用 ngettext($singular, $plural, $number)，其中前两个参数分别对应单数和复数的原文模板，第三个参数是决定使用哪个形式的数值。该函数会查询当前语言环境（locale）下的 mo 文件，若找到匹配的单复数规则则返回对应译文，否则回退到默认的单数或复数字符串。

多语言切换phpgettext复数ngettext写法

不同语言环境下复数规则的差异与处理

虽然 ngettext() 能自动选择单复数，但不同语言对“复数”的定义差异巨大，例如俄语和波兰语存在双数形式，而中文通常不区分单复数。因此，翻译人员必须在 PO/MO 文件中为每种语言提供符合其语法习惯的所有变体，开发者只需确保传入正确的数量即可。如果翻译缺失，PHP 会根据 ISO 639-1 语言代码中的默认复数规则进行回退，这可能导致非英语语言出现语法错误。

多语言切换phpgettext复数ngettext写法

多语言产品描述批量生成SEO

为跨境电子商务生成多语言、SEO 优化的产品描述。支持英语、西班牙语、俄语和阿拉伯语，并针对不同搜索引擎（Google / Bing、Yandex、中东市场）进行专项 SEO 优化。适用于以下场景：用户需为国际市场创建符合 SEO 规范的产品文案、批量生成产品描述，或针对特定搜索引擎及区域用户偏好优化内容。

下载

当数量为 0 时 `ngettext()` 的行为表现

在大多数西方语言中，0 被视为复数，因此 ngettext('apple', 'apples', 0) 通常会返回复数形式的译文。然而，部分语言如阿拉伯语有复杂的复数规则，0 可能对应特定的零数形式而非普通复数。此外，中文等孤立语通常不区分单复数，无论数量为 0、1 还是多，返回的译文往往相同。开发者在处理数量为 0 的情况时，应特别注意目标语言的复数规则定义，避免在 UI 上显示不符合语言习惯的文本。

<?php // 设置语言环境
setlocale(LC_ALL, 'zh_CN.UTF-8');
bindtextdomain('messages', './lang');
textdomain('messages');

// 测试不同数量
$counts = [0, 1, 2, 5];
foreach ($counts as $count) {
    echo sprintf("%d: %s\n", $count, ngettext('There is %d item.', 'There are %d items.', $count));
}

// 预期输出 (假设 zh_CN 未区分单复数):
// 0: There are %d items.
// 1: There is %d item.
// 2: There are %d items.
// 5: There are %d items.