Yii2框架多语言设置教程

配置Yii2国际化需在config/main.php中设置i18n组件，指定basePath、sourceLanguage及fileMap；创建对应语言的PHP翻译文件；使用Yii::t()函数在代码中实现文本翻译；通过修改Yii::$app->language动态切换语言；支持占位符替换和复数形式翻译；测试时更改语言设置并验证翻译结果。

Yii2框架的国际化多语言，简单来说，就是让你的应用能够根据用户的语言设置，自动显示不同语言的内容。核心在于配置、翻译文件和视图中的应用。

配置Yii2的国际化组件，创建翻译文件，并在视图中使用Yii::t()函数。

如何配置Yii2的国际化组件？

Yii2的国际化配置主要在config/web.php或config/main.php中进行。你需要配置i18n组件，指定语言包的路径和默认语言。例如：

'components' => [
    'i18n' => [
        'translations' => [
            'app*' => [
                'class' => 'yii\i18n\PhpMessageSource',
                'basePath' => '@app/messages',
                'sourceLanguage' => 'en-US', // 默认语言
                'fileMap' => [
                    'app' => 'app.php',
                    'app/error' => 'error.php',
                ],
            ],
        ],
    ],
],
'language' => 'zh-CN', // 设置当前应用使用的语言

这里，basePath指定了翻译文件存放的目录，sourceLanguage指定了默认语言，fileMap定义了不同分类的翻译文件。language配置设置了应用当前使用的语言。

怎样创建和管理翻译文件？

翻译文件通常是PHP文件，以数组的形式存储翻译内容。例如，@app/messages/zh-CN/app.php：

return [
    'Hello' => '你好',
    'Welcome to Yii' => '欢迎使用Yii',
    'This is a test.' => '这是一个测试。',
];

文件的命名规则是语言代码/分类.php。分类可以自定义，比如app、error等。管理翻译文件可以使用专门的工具，也可以手动维护。手动维护的话，注意保持翻译的一致性和完整性。

如何在视图和代码中使用Yii::t()函数？

Yii::t()函数是Yii2国际化的核心。它用于根据当前语言，查找对应的翻译内容。例如：

echo Yii::t('app', 'Hello'); // 输出：你好
echo Yii::t('app', 'Welcome to Yii'); // 输出：欢迎使用Yii

在视图中，可以直接使用Yii::t()函数。在控制器或模型中，也可以使用。第一个参数是分类，第二个参数是需要翻译的文本。

如何动态切换语言？

动态切换语言可以通过修改Yii::$app->language来实现。例如，可以通过URL参数传递语言代码：

public function actionChangeLanguage($lang)
{
    Yii::$app->language = $lang;
    Yii::$app->session->set('language', $lang); // 可选：保存到Session
    return $this->redirect(Yii::$app->request->referrer);
}

然后，创建一个链接，例如：English。 这样，点击链接就可以切换到英文。

如何处理带有占位符的翻译？

有时候，我们需要在翻译文本中包含变量。可以使用占位符来实现：

// 翻译文件：
return [
    'Hello, {name}!' => '你好，{name}！',
];

// 代码：
echo Yii::t('app', 'Hello, {name}!', ['name' => '张三']); // 输出：你好，张三！

占位符用花括号 {} 包裹，Yii::t()函数的第三个参数是一个数组，用于替换占位符。

如何处理复数形式的翻译？

不同语言对复数的处理方式不同。Yii2提供了Yii::t()函数的复数形式支持。需要安装yiisoft/yii2-i18n扩展。

首先，安装扩展：composer require yiisoft/yii2-i18n

然后，在翻译文件中使用plural规则：

return [
    '{n, plural, =0{No items} =1{One item} other{# items}}' => '{n, 复数, =0{没有项目} =1{一个项目} other{# 个项目}}',
];

// 代码：
echo Yii::t('app', '{n, plural, =0{No items} =1{One item} other{# items}}', ['n' => 0]); // 输出：No items
echo Yii::t('app', '{n, plural, =0{No items} =1{One item} other{# items}}', ['n' => 1]); // 输出：One item
echo Yii::t('app', '{n, plural, =0{No items} =1{One item} other{# items}}', ['n' => 5]); // 输出：5 items

如何测试国际化是否生效？

测试国际化最简单的方法是修改Yii::$app->language，然后刷新页面，看是否显示对应的翻译内容。也可以通过动态切换语言的方式进行测试。确保所有需要翻译的文本都使用了Yii::t()函数，并且翻译文件完整。