README

yii2 应用程序的语言扩展。

安装

安装此扩展的最佳方式是通过 composer。

运行以下命令之一：

php composer.phar require  pkorniev/language-yii2 

或

"pkorniev/language-yii2": ">=1.0"

将以下内容添加到您的 composer.json 文件的 require 部分。

使用方法

扩展安装后，您需要在主配置文件中覆盖应用程序组件 "request" 和 "urlManager"，并添加组件 "translator"（它将存储翻译参数）。

...
'components' => [
        'request' => [
            'class' => 'pkorniev\language\PKRequest',
            // !!! insert a secret key in the following (if it is empty) - this is required by cookie validation
            'cookieValidationKey' => '<<YOUR_COOKIE_VALIDATION_KEY>>',
        ],
        'urlManager' => [
            'enablePrettyUrl' => true,
            'showScriptName' => false,
            'class' => 'pkorniev\language\PKUrlManager',
        ],
        'translator' => [
                    'class' => 'pkorniev\language\PKTranslator',
                    'supportedLanguages' => [
                        'ua' => 'uk-UA',
                        'en' => 'en-US',
                    ],
                    'defaultLanguage' =>'ua',
                    //'cookieRemember' => false,
                    //'expiredLangCookie' => 60*60*24*30,
                ],
...                

"supportedLanguages" 属性指定支持的区域列表。键包含需要传递到查询字符串中的用户键，以转到相应的区域。

例如，要切换到英语，您可以使用您喜欢的任何键："en"、"eng" 或其他任何键。您的网站链接切换到任何语言的链接将如下所示

https://site.com/en/ or https://site.com/eng/

"defaultLanguage" 属性指定将哪个区域设置为默认值。重要！默认区域必须在可用区域列表中声明。

"cookieRemember" 属性指定是否将之前设置的区域存储在 Cookies 中。如果设置为 true（默认值），则区域将设置为上次更改时的区域，即使查询字符串中没有传递用户键也不会更改。

此外，"expiredLangCookie" 属性设置了上次区域的有效期（以秒为单位）。它可以省略，默认值为 30 天。