国际化简单 PHP 网站的最佳方式

Question

我必须开发一个非常简单的 php 网站，所以我不需要框架。 但它必须支持多语言（EN/FR/CHINESE）。 我寻找了 php 内置系统，发现了两种方法：

• 来自 php5.3 的 intl 模块 ( http://php.net/manual/fr/book.intl.php)
• gettext (http://php.net/manual/fr/book.gettext.php）

我没有没有框架的 i18n 经验，所以关于什么是最简单的方法的任何建议强>支持多语言？

最后，我只需要一个将翻译搜索到文件中的功能（按语言一个文件）。 情商： trans('你好');

=> en.yaml（无论是否为 yaml，这只是一个示例）

hello: "Hello world!"

=> fr.yaml

hello: "Bonjour tout le monde !"

如果可能的话我更喜欢纯 PHP 实现

Answer 1

虽然 ext/gettext 和 ext/intl 都与 i18（国际化）相关，但 gettext 处理翻译，而 intl > 处理国际化事务，例如数字和日期显示、排序顺序和音译。因此，您实际上需要两者才能获得完整的 i18 解决方案。根据您的需求，您可能会想出一个依赖于上述扩展或使用某些框架提供的组件的自制解决方案：

• 翻译
  • Symfony 2 翻译组件：https://github.com/symfony/Translation
  • Zend 框架 Zend_Translate
• 国际化
  • Zend 框架 Zend_Locale

如果您只需要翻译并且站点足够简单，也许您的简单解决方案（将翻译配置文件读入 PHP 数组，使用简单的函数检索令牌）可能是最简单的。

我能想到的最简单的解决方案是：

$translation = array(
    'Hello world!' => array(
        'fr' => 'Bonjour tout le monde!',
        'de' => 'Hallo Welt!'
    )
);

if (!function_exists('gettext')) {
    function _($token, $lang = null) {
        global $translation;
        if (   empty($lang)
            || !array_key_exists($token, $translation)
            || !array_key_exists($lang, $translation[$token])
        ) {
            return $token;
        } else {
            return $translation[$token][$lang];
        }
    }
}

echo _('Hello World!');

Answer 2

我知道这是一个老问题，但我觉得答案从头到尾都缺乏更实际的方法。这就是我使用 PHP 的 gettext 库 和 Poedit，无需在 Debian 服务器上使用任何其他 PHP 库：

准备步骤 1：安装 gettext 和语言环境在服务器上

我不确定对于其他操作系统，这是如何完成的，但对于 Debian，您可以这样做：

sudo apt-get install gettext
sudo dpkg-reconfigure locales

编辑：我假设 Ubuntu 与 Debian 相同，但显然它略有不同。有关在 Ubuntu 上安装区域设置的说明，请参阅此页面。

确保选择所有您想要使用的区域设置。然后您应该看到类似以下内容：

Generating locales (this might take a while)...
  en_US.UTF-8... done
  es_MX.UTF-8... done
  fr_FR.UTF-8... done
  zh_CN.UTF-8... done
Generation complete.

注意：确保为每种语言选择正确的变体和字符编码（最有可能是 UTF-8） 。如果您安装 es_MX.UTF-8 并尝试使用 es_ES.UTF-8 或 es_MX.ISO-8859-1 则不会工作。
准备步骤 2：在翻译人员的计算机上安装 Poedit

可从适用于大多数 Linux 操作系统的软件存储库中获取 Poedit。对于基于 Debian 的系统，只需执行：

sudo apt-get install poedit

对于 Windows 和 Mac，请访问：https://poedit.net/download

---

开始编码：

好的，现在您已经准备好开始编码了。我编写了以下 gettext() 包装函数来翻译单数和复数：

function __($text, $plural=null, $number=null) {
    if (!isset($plural)) {
        return _($text);
    }
    return ngettext($text, $plural, $number);
}

示例用法：

// Singular
echo __('Hello world');

// Plural
$exp = 3;
printf(
    __(
        'Your account will expire in %d day',
        'Your account will expire in %d days',
        $exp
    ),
    $exp
);

这适用于所有语言，而不仅仅是复数为 n != 1n != 1 的语言。 code> - 这包括具有多种复数类型的语言。

您还可以像这样添加译者注释：

/** NOTE: The name Coconut Hotel is a brand name and shouldn't be 
 translated.
*/
echo __('Welcome to Coconut Hotel');

您可以将文本从 NOTE 更改为您想要的任何内容，但您必须在下面的 shell 脚本中更改它。 重要：译者注释必须是 紧接在 __() 函数之前行的注释的一部分，否则不会被选中当我们扫描 PHP 文件中的可翻译字符串时。

// Warning! THIS WILL NOT WORK!
/* NOTE: This translator's note will not be picked up because it is
not immediately preceding the __() function. */
printf(
    __(
        'Your account will expire in %d day',
        'Your account will expire in %d days',
        $exp
    ),
    $exp
);
// Warning! THIS WILL NOT WORK!

准备好将字符串发送给翻译器后，将以下内容保存为应用程序根目录中的 shell 脚本（例如 update.sh）：

#!/bin/sh
find . -iname "*.php" | xargs xgettext --add-comments=NOTE --keyword=__:1,2 --keyword=__ --from-code=UTF-8 -o i18n.pot
find . -name '*.po' | xargs -I{} msgmerge -U {} i18n.pot

要执行它，只需执行以下操作：

cd /path/to/script && sh update.sh

这将递归扫描该目录中的所有 PHP 文件并创建一个 .pot 文件（我将其命名为 i18n.pot，但您可以随意命名它）并更新任何现有的 .po > 它找到的包含新字符串的文件。

然后，我们需要创建存储所有区域设置文件的目录，每个区域设置一个目录。它们的格式必须为 ./locale/{locale}/LC_MESSAGES。例如：

cd /path/to/your/project
mkdir -p ./locale/en_US.UTF-8/LC_MESSAGES
mkdir -p ./locale/es_MX.UTF-8/LC_MESSAGES
# ...etc.

您需要决定要使用的文本域。这可以是您想要的任何内容，但脚本将在该语言的 LC_MESSAGES 文件夹中查找名为 {yourTextDomain}.mo 的文件。将以下内容放入您的 PHP 脚本中：

define('TEXT_DOMAIN', 'yourdomain');
bindtextdomain(TEXT_DOMAIN, __DIR__.'/locale');
textdomain(TEXT_DOMAIN);
bind_textdomain_codeset(TEXT_DOMAIN, 'UTF-8');

然后要实际切换到另一个语言环境，请执行以下操作：

$lang = 'es_MX.UTF-8'; // Change this to the language you want to use
if (setlocale(LC_ALL, $lang) === false) {
    throw new Exception("Server error: The $lang locale is not installed. Please update the server's localisations.");
}
putenv('LC_ALL='.$lang);        

首先，将上述脚本生成的 .pot 文件发送给翻译人员。然后他们打开 Poedit 并单击 File >来自 POT/PO 文件的新内容。保存时，需要将其保存为 {yourTextDomain}.po。 {yourTextDomain} 需要与 PHP 脚本中的文本域完全相同。当他们保存它时，它将自动创建 .po 文件和 .mo 文件。翻译完成后，这两个文件都需要保存在该语言的 LC_MESSAGES 目录中。

现在，当您更新 PHP 文件中的字符串时，只需重新执行 shell 脚本并将新更新的 .po 文件发送给翻译人员即可。然后，他们翻译字符串，并且 .po 和 .mo 文件都需要重新上传。

就是这样。设置起来可能有点困难，但是一旦设置并运行，它就非常容易了。

Answer 3

Gettext 似乎就是你所需要的。
有一个按语言分类的文件（原始文件除外），并且非常易于使用：

echo _('Bonjour, ça va ?');

将打印 Hello , how are you ？用英语。

有 一些带有 gettext 的工具可以扫描您的php 文件并搜索可翻译字符串（实际上 _() 或 gettext() 中的所有字符串）。因此，您不必担心不同的语言文件。您只需使用原始语言对您的网站进行编码，语言文件稍后将自动创建。

尽管如此，gettext 更多的是一种翻译工具，而 intl 实际上是一种 i18n 工具（例如数字格式化）

Answer 4

尽管您不需要框架，但您可以使用框架。 Zend Framework 中的国际化功能非常好，您可以只使用其中的一部分，而不用使用所有部分（包括 MVC）