Yii2语言国际化的配置教程


Posted in PHP onAugust 19, 2018

前言

最近想将博客做成支持多语言的,还好Yii2支持这个功能,于是查看了下官方的文档,哎,看了半天不知道干嘛用的,于是各种百度,Google的搜索,最终才明白原来很简单,只是官方写的太复杂

下面介绍下具体的使用步骤,具体介绍我就不写了,官方写比我清楚,我就写怎么使用

第一步 创建i18n配置文件

./yii message/config @app/config/i18.php // yii 在项目目录下 Yii2创建的时候自动生成的

执行完命令之后会在项目根目录config下创建一个i18n.php文件

为什么要创建这个文件,因为我们为了多语言处理,需要生成一个对应的映射文件,只要生成就好了,稍后的配置程序会自动调用处理

第二步 修改配置规则

打开config/i18n.php,看下生成的配置文件的代码,如下:

return [
 'color' => null,
 'interactive' => true,
 'help' => null,
 'sourcePath' => '@yii',
 'messagePath' => '@yii/messages',
 'languages' => [],
 'translator' => 'Yii::t',
 'sort' => false,
 'overwrite' => true,
 'removeUnused' => false,
 'markUnused' => true,
 'except' => [
  '.svn',
  '.git',
  '.gitignore',
  '.gitkeep',
  '.hgignore',
  '.hgkeep',
  '/messages',
  '/BaseYii.php',
 ],
 'only' => [
  '*.php',
 ],
 'format' => 'php',
 'db' => 'db',
 'sourceMessageTable' => '{{%source_message}}',
 'messageTable' => '{{%message}}',
 'catalog' => 'messages',
 'ignoreCategories' => [],
 'phpFileHeader' => '',
 'phpDocBlock' => null,
];

修改后的代码,如下:

return [
 'color' => null,
 'interactive' => true,
 'help' => null,
 'sourcePath' => '@app',
 'messagePath' => '@app/messages',
 'languages' => ['zh-CN', 'ru-RU'],
 'translator' => 'Yii::t',
 'sort' => false,
 'overwrite' => true,
 'removeUnused' => false,
 'markUnused' => true,
 'except' => [
  '.svn',
  '.git',
  '.gitignore',
  '.gitkeep',
  '.hgignore',
  '.hgkeep',
  '/messages',
  '/BaseYii.php',
  'vendor',
 ],
 'only' => [
  '*.php',
 ],
 'format' => 'php',
 'db' => 'db',
 'sourceMessageTable' => '{{%source_message}}',
 'messageTable' => '{{%message}}',
 'catalog' => 'messages',
 'ignoreCategories' => [],
 'phpFileHeader' => '',
 'phpDocBlock' => null,
];

我这里只改了两个地方

'sourcePath' => '@app', // 将@yii改为@app 只处理我们自己应用中的代码
'messagePath' => '@app/messages', // 将@yii/messages改为@app/messages 将需要翻译的字段提取出来要放的目录
'languages' => ['zh-CN', 'ru-RU'], // 要翻译成目标的语言,我这里定义了一个"中文"和"俄语"

'except' => [
 '.svn',
 '.git',
 '.gitignore',
 '.gitkeep',
 '.hgignore',
 '.hgkeep',
 '/messages',
 '/BaseYii.php',
 'vendor', // 将vendor目录下的过滤掉,不然可能太多了
],

第三步 生成翻译配置文件

执行下面的命令

./yii message/extract @app/config/i18n.php

执行完之后会在messages目录下(如果没有messages目录的话需要手动创建下)得到如下的目录结构

├── ru-RU
│   └── app.php
└── zh-CN
    └── app.php

提示下再做这个操作之前,需要在自己的项目中有类似Yii:t()的调用,比如我这里在components/HeaderWidget.php这个文件中

Yii::t('app', 'Home')

这里的app的作用是用来进行文件分类的,我这里暂时没有计划生成的时候会将所有需要翻译的字段放在app开头命名的php文件app.php文件中

如果像下面这样调用的话

Yii::t('appp', 'Home')

会生成一个appp.php的文件

第四步 翻译配置文件

看下中文的翻译文件messages/zh-CN/app.php,我的是下面这个

return [
 'Archive' => '',
 'Autokid' => '',
 'Blog' => '',
 'Ctime' => '',
 'IP地址' => '',
 'UserAgent' => '',
 '主题' => '',
 '内容' => '',
 '姓名' => '',
 '日期' => '',
 '邮箱地址' => '',
 '页面路径' => '',
 'Home' => '首页', // 右边的键值对应 Yii::t('app', 'Home')中的Home,只需要在value中写入需要的汉字就可以了。
];

第五步 修改目标国际化语言

修改配置文件

'language' => 'zh-CN', // 指定为要翻译的语言

再打开网页,就可以看到已经翻译成了对应需要的语言,当然这样的配置很不灵活,如果是部署多态机器并通过域名或者其他方式来实现的话,也是可以的,这里的话我建议如下方式

创建自己的Controller,然后将语言配置放在Session中,通过获取Session中的语言来更换全站的语言。具体见后面分享

提示,网站很多地方提到要加个配置,官方也是

'i18n' => [
 'translations' => [
  'app*' => [
   'class' => 'yii\i18n\PhpMessageSource',
   'basePath' => '@app/messages',
   'sourceLanguage' => 'en-US',
   'fileMap' => [
    'app' => 'app.php',
   ],
  ],
 ],
],

我这边在配置的时候没有加,运行也都是正常的,如有遇到问题,可以一起沟通交流下。

总结

以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,如果有疑问大家可以留言交流,谢谢大家对三水点靠木的支持。

PHP 相关文章推荐
图形数字验证代码
Oct 09 PHP
如何使用PHP实现javascript的escape和unescape函数
Jun 29 PHP
PHP网页游戏学习之Xnova(ogame)源码解读(三)
Jun 23 PHP
php保存二进制原始数据为图片的程序代码
Oct 14 PHP
PHP实现获取域名的方法小结
Nov 05 PHP
THINKPHP支持YAML配置文件的设置方法
Mar 17 PHP
php简单实现查询数据库返回json数据
Apr 16 PHP
PHP魔术方法的使用示例
Jun 23 PHP
Smarty环境配置与使用入门教程
May 11 PHP
关于PHP定时发送服务的解决办法
Apr 23 PHP
Yii2中简单的场景使用介绍
Jun 02 PHP
PHP实现微信小程序人脸识别刷脸登录功能
May 24 PHP
Ubuntu中支持PHP5与PHP7双版本的简单实现
Aug 19 #PHP
Laravel框架执行原生SQL语句及使用paginate分页的方法
Aug 17 #PHP
Laravel框架实现修改登录和注册接口数据返回格式的方法
Aug 17 #PHP
ThinkPHP5+Layui实现图片上传加预览功能
Aug 17 #PHP
PHP实现类似题库抽题效果
Aug 16 #PHP
php实现的rc4加密解密类定义与用法示例
Aug 16 #PHP
Laravel框架实现定时发布任务的方法
Aug 16 #PHP
You might like
DOTA2 玩家自创拉野攻略 特色英雄快速成长篇
2020/04/20 DOTA
PHP 遍历文件实现代码
2011/05/04 PHP
PHP仿qq空间或朋友圈发布动态、评论动态、回复评论、删除动态或评论的功能(上)
2017/05/26 PHP
php实现有序数组旋转后寻找最小值方法
2018/09/27 PHP
php获取目录下所有文件及目录(多种方法)(推荐)
2019/05/14 PHP
php上传图片并给图片打上透明水印的代码
2010/06/07 Javascript
开源的javascript项目Kissy介绍
2014/11/28 Javascript
JS实现slide文字框缩放伸展效果代码
2015/11/05 Javascript
Javascript 获取鼠标当前的位置实现方法
2016/10/27 Javascript
VUE开发一个图片轮播的组件示例代码
2017/03/06 Javascript
JS实现加载时锁定HTML页面元素的方法
2017/06/24 Javascript
vue实现验证码按钮倒计时功能
2018/04/10 Javascript
Vue实现自定义下拉菜单功能
2018/07/16 Javascript
详解vue中this.$emit()的返回值是什么
2019/04/07 Javascript
[47:10]完美世界DOTA2联赛PWL S3 LBZS vs Rebirth 第二场 12.16
2020/12/18 DOTA
从Python的源码浅要剖析Python的内存管理
2015/04/16 Python
浅谈Python的Django框架中的缓存控制
2015/07/24 Python
浅谈Python peewee 使用经验
2017/10/20 Python
Python3之简单搭建自带服务器的实例讲解
2018/06/04 Python
解决Django migrate不能发现app.models的表问题
2019/08/31 Python
Expected conditions模块使用方法汇总代码解析
2020/08/13 Python
selenium携带cookies模拟登陆CSDN的实现
2021/01/19 Python
全世界最美丽的四星和五星级酒店预订:Prestigia.com
2017/11/15 全球购物
internal修饰符起什么作用
2013/12/16 面试题
编程实现去掉XML的重复结点
2014/05/28 面试题
集团公司总经理岗位职责
2013/12/20 职场文书
连带责任保证书
2014/04/29 职场文书
代办委托书怎么写
2014/08/01 职场文书
群众路线领导班子整改方案
2014/10/25 职场文书
督导岗位职责
2015/02/04 职场文书
毕业生自荐求职信书写的技巧
2019/08/26 职场文书
用Python进行栅格数据的分区统计和批量提取
2021/05/27 Python
使用Redis实现实时排行榜功能
2021/07/02 Redis
详细了解MVC+proxy
2021/07/09 Java/Android
「SHOW BY ROCK!!」“雫シークレットマインド”组合单曲MV公开
2022/03/21 日漫
基于docker安装zabbix的详细教程
2022/06/05 Servers