Yii-현지화

I18N (Internationalization)다양한 언어에 적용 할 수있는 애플리케이션을 디자인하는 프로세스입니다. Yii는 I18N 기능의 전체 스펙트럼을 제공합니다.

로케일은 사용자의 언어와 국가를 지정하는 매개 변수 세트입니다. 예를 들어 en-US는 영어 로케일과 미국을 나타냅니다. Yii는 소스 언어와 대상 언어의 두 가지 유형의 언어를 제공합니다. 소스 언어는 애플리케이션의 모든 텍스트 메시지가 작성되는 언어입니다. 대상 언어는 최종 사용자에게 콘텐츠를 표시하는 데 사용해야하는 언어입니다.

메시지 번역 구성 요소는 원본 언어에서 대상 언어로 텍스트 메시지를 번역합니다. 메시지를 번역하려면 메시지 번역 서비스가 메시지 소스에서 검색해야합니다.

메시지 번역 서비스를 사용하려면 다음을 수행해야합니다.

번역하려는 텍스트 메시지를 Yii :: t () 메서드로 래핑합니다.
메시지 소스를 구성합니다.
메시지 소스에 메시지를 저장합니다.

Step 1 − Yii :: t () 메서드는 다음과 같이 사용할 수 있습니다.

echo \Yii::t('app', 'This is a message to translate!');

위 코드 스 니펫에서 '앱'은 메시지 카테고리를 나타냅니다.

Step 2 − 이제 config/web.php 파일.

<?php
   $params = require(__DIR__ . '/params.php'); $config = [
      'id' => 'basic',
      'basePath' => dirname(__DIR__),
      'bootstrap' => ['log'],
      'components' => [
         'request' => [
            // !!! insert a secret key in the following (if it is empty) - this
               //is required by cookie validation
            'cookieValidationKey' => 'ymoaYrebZHa8gURuolioHGlK8fLXCKjO',
         ],
         'cache' => [
            'class' => 'yii\caching\FileCache',
         ],
         'i18n' => [
            'translations' => [
               'app*' => [
                  'class' => 'yii\i18n\PhpMessageSource',
                  'fileMap' => [
                     'app' => 'app.php'
                  ],
               ],
            ],
         ],
         'user' => [
            'identityClass' => 'app\models\User',
            'enableAutoLogin' => true,
         ],
         'errorHandler' => [
            'errorAction' => 'site/error',
         ],
         'mailer' => [
            'class' => 'yii\swiftmailer\Mailer',
            // send all mails to a file by default. You have to set
            // 'useFileTransport' to false and configure a transport
            // for the mailer to send real emails.
            'useFileTransport' => true,
         ],
         'log' => [
            'flushInterval' => 1,
            'traceLevel' => YII_DEBUG ? 3 : 0,
            'targets' => [
               [
                  'class' => 'yii\log\FileTarget',
                  'exportInterval' => 1,
                  'logVars' => [],
               ],
            ],
         ],
         'db' => require(__DIR__ . '/db.php'),
      ],
      // set target language to be Russian
      'language' => 'ru-RU',
      // set source language to be English
      'sourceLanguage' => 'en-US',
      'modules' => [
         'hello' => [
            'class' => 'app\modules\hello\Hello',
         ],
      ],
      'params' => $params, ]; if (YII_ENV_DEV) { // configuration adjustments for 'dev' environment $config['bootstrap'][] = 'debug';
      $config['modules']['debug'] = [ 'class' => 'yii\debug\Module', ]; $config['bootstrap'][] = 'gii';
      $config['modules']['gii'] = [ 'class' => 'yii\gii\Module', ]; } return $config;
?>

위의 코드에서 소스 및 대상 언어를 정의합니다. 또한에서 지원하는 메시지 소스를 지정합니다.yii\i18n\PhpMessageSource. app * 패턴은 app으로 시작하는 모든 메시지 카테고리가이 특정 메시지 소스를 사용하여 번역되어야 함을 나타냅니다. 위의 구성에서 모든 러시아어 번역은 messages / ru-RU / app.php 파일에 있습니다.

Step 3− 이제 messages / ru-RU 디렉토리 구조를 생성합니다. ru-RU 폴더 안에 app.php라는 파일을 만듭니다. 이것은 모든 EN → RU 번역을 저장합니다.

<?php
   return [
      'This is a string to translate!' => 'Эта строка для перевода!'
   ];
?>

Step 4 − SiteController에 actionTranslation ()이라는 함수를 생성합니다.

public function actionTranslation() {
   echo \Yii::t('app', 'This is a string to translate!');
}

Step 5 − URL 입력 http://localhost:8080/index.php?r=site/translation 웹 브라우저에서 다음을 볼 수 있습니다.

대상 언어를 ru-RU로 설정함에 따라 메시지가 러시아어로 번역되었습니다. 응용 프로그램의 언어를 동적으로 변경할 수 있습니다.

Step 6 − 수정 actionTranslation() 방법.

public function actionTranslation() {
   \Yii::$app->language = 'en-US';
   echo \Yii::t('app', 'This is a string to translate!');
}

이제 메시지가 영어로 표시됩니다.

Step 7 − 번역 된 메시지에 하나 또는 여러 개의 매개 변수를 삽입 할 수 있습니다.

public function actionTranslation() {
   $username = 'Vladimir';
   // display a translated message with username being "Vladimir"
   echo \Yii::t('app', 'Hello, {username}!', [
      'username' => $username, ]), "<br>"; $username = 'John';
   // display a translated message with username being "John"
   echo \Yii::t('app', 'Hello, {username}!', [
      'username' => $username, ]), "<br>"; $price = 150;
   $count = 3; $subtotal = 450;
   echo \Yii::t('app', 'Price: {0}, Count: {1}, Subtotal: {2}', [$price, $count, $subtotal]);
}

다음은 출력입니다.

개별 텍스트 메시지를 번역하는 대신 전체보기 스크립트를 번역 할 수 있습니다. 예를 들어 대상 언어가 ru-RU이고 views / site / index.php보기 파일을 번역하려는 경우보기를 번역하고 views / site / ru-RU 디렉터리에 저장해야합니다.

Step 8− views / site / ru-RU 디렉토리 구조를 생성합니다. 그런 다음 ru-RU 폴더 안에 다음 코드를 사용하여 index.php라는 파일을 만듭니다.

<?php
   /* @var $this yii\web\View */
   $this->title = 'My Yii Application';
?>

<div class = "site-index">
   <div class = "jumbotron">
      <h1>Добро пожаловать!</h1>
   </div>
</div>

Step 9 − 대상 언어는 ru-RU이므로 URL을 입력하면 http://localhost:8080/index.php?r=site/index, 러시아어 번역 페이지가 표시됩니다.