Laravel学习教程之本地化模块

前言

本文主要给大家介绍了关于Laravel本地化模块的相关内容，分享出来供大家参考学习，话不多说了，来一起看看详细的介绍吧。

本文是基于Laravel 5.4版本的本地化模块代码进行分析书写；

模块组成

下图展示了本地化模块各个文件的关系，并进行简要说明；

• TranslationServiceProvider
  本地化模块的服务提供者，既是一个模块的入口，也是与IOC容器交互的中心；注册翻译器实例translation.loader，注册翻译管理实例translator，并声明延迟加载服务；
• Translator
  翻译管理类；
• MessageSelector
  消息过滤器，通过判断复数值来选择合适的消息；比如消息内容是这样的{0}没有|[1,19]一些|[20,*]很多，我们传的数字是 18，那么最后选择的消息就是"一些"；
• LoaderInterface
  翻译器接口；声明了三个方法load，addNamespace，namespaces；
• FileLoader
  继承了LoaderInterface，从文件获取本地化资源数据；
• ArrayLoader
  继承了LoaderInterface，在内存用数组维护本地化资源数据；
  

配置说明

在config配置目录下和本模块有关的参数只有app.php文件中的locale和fallback_locale；

locale表示默认本地化语言是什么，这样会优先从该语言资源目录中获取翻译（转换）内容；
如果locale表示的语言不存在，则使用fallback_locale这个备用语言；

笔者的locale是zh_CN，fallback_locale是en；

功能介绍

全局的语言资源目录在项目的resources/lang下，每个子目录分别以语言为名，比如en、zh_CN等；

另外一些子目录是命名空间为名，是对第三方加载库资源文件的补充替换；

有可能还存在en.json、zh_CN这类Json文件，项目有时候会从Json文件读取数据，这些数据均来自于这个已存在的Json文件；

翻译全局语言资源

笔者的语言资源根目录resources/lang下有zh_CN/validation.php，内容如下

<?php
return [
 'accepted'  => ':attribute 必须接受。',
 'active_url'  => ':attribute 不是一个有效的网址。',
 'after'  => ':attribute 必须是一个在 :date 之后的日期。',
 ......
];

通过调用代码

app('translator')->trans('validation.accepted', ['attribute' => '用户名'])

或者全局帮助函数trans

trans('validation.accepted', ['attribute' => '用户名'])

输出 "用户名 必须接受。"；

调用过程如下：

• 解析键名：将键名进行解析成数组 ($namespace = '*', $group = 'validation', $item = 'accepted')；namespace为*，表示在全局命名空间下；group，组，其实就是文件名，一个文件为一组；item是元素的意思；
• 获取语言数组： 这里的$locale为null，所以返回的是默认与备用语言组成的数组，也就是['zh_CN', 'en']；并进行for循环，进入语言资源目录中寻找需要的元素值，如果找到，即 break；
• 加载资源：因为命名空间为*，所以定位资源根目录为resources/lang；语言为zh_CN，所以子目录为zh_CN；group名为validation，这时就把resources/lang/zh_CN/validation.php文件中的所有内容都加载进内存中，并进行保存 $this->loaded[$namespace][$group][$locale] = $lines;
• 获取资源，并替换参数：通过Arr::get方法从$this->loaded[$namespace][$group][$locale]中获取元素值:attribute 必须接受。；此时，参数数组为不空，循环替换，得到结果"用户名 必须接受。"；
  

翻译带命名空间的语言资源

笔者在语言资源根目录resource/lang下，创建vendor/Faker/Provider/zh_CN/Internet.php文件，内容如下：

<?php
return [
 'message' => 'hello, Faker/Provider',
 ......
];

同时，手动在Translator中注册第三方插件（也就是带命名空间）的资源根目录位置；

app('translator')->addNamespace('Faker/Provider', base_path('vendor/xx/resource/lang'))

现在，获取带命名空间的资源；

trans('Faker/Provider::Internet.message');

输出 'hello, Faker/Provider'；

调用过程如下：

• 解析键名：将键名进行解析成数组 ($namespace = 'Faker/Provider', $group = 'Internet', $item = 'message')；
• 获取语言数组： 这里的$locale为null，所以返回的是默认与备用语言组成的数组，也就是['zh_CN', 'en']；并进行for循环，进入语言资源目录中寻找需要的元素值，如果找到，即 break；
• 加载资源：因为命名空间为Faker/Provider，此时会分两步；第一步读取第三方插件资源库下的信息，这时读取命名空间注册的根目录为base_path('vendor/xx/resource/lang')，就读取base_path('vendor/xx/resource/lang')/zh_CN/Internet.php内容，文件不存在，返回空数组；第二步读取全局语言资源，进行补充，也就是读取base_path('resource/lang/vendor/Faker/Provider')/zh_CN/Internet.php; 最后进行保存 $this->loaded[$namespace][$group][$locale] = $lines;
• 获取资源，并替换参数：通过Arr::get方法从$this->loaded[$namespace][$group][$locale]中获取元素值" hello, Faker/Provider"；此时，参数数组为空，直接返回结果 "hello, Faker/Provider"；
  

翻译Json文件中的资源

笔者在语言资源根目录resource/lang下，创建zh_CN.json文件，内容如下：

{
 "name": "zh_CN.json",
 "place": "../resources/lang/zh_CN.json"
} 

现在，获取Json文件中的name值；

trans('*.name')

输出 "zh_CN.json"；

调用过程如下：

• 解析键名：将键名进行解析成数组 ($namespace = '*', $group = '*', $item = 'name')；
• 获取语言数组： 这里的$locale为null，所以返回的是默认与备用语言组成的数组，也就是['zh_CN', 'en']；并进行for循环，进入语言资源目录中寻找需要的元素值，如果找到，即 break；
• 加载资源：因为命名空间为*，且组也为*，这时会读取语言根目录下，名字为语言值的Json文件；此时会读取resource/lang/zh_CN.json，将读取的内容，进行保存 $this->loaded[$namespace][$group][$locale] = $lines;
• 获取资源，并替换参数：通过Arr::get方法从$this->loaded[$namespace][$group][$locale]中获取元素值"zh_CN.json"；此时，参数数组为空，直接返回结果 "zh_CN.json"；

运行时绑定资源

资源的内容除了放在文件中，用到的时候在读取，也可以在项目运行时，存放；

以resources/lang/zh_CN/validation.php为例，现在想要在运行时，给这个组添加一个新的元素叫 extra，需要指定放在哪个语言下，可以这样写

app('translator')->addLines(array('validation.extra' => '测试添加额外数据'), 'zh_CN');

现在可以获取这个新添加的元素值

trans('validation.extra')

复数资源过滤

笔者通过 运行时绑定资源 添加一条翻译内容：

app('translator')->addLines(array('validation.extra' => '{0}没有|[1,19]一些|[20,*]很多'), 'zh_CN');

如果通过trans('validation.extra') ，获取的就是整条翻译内容，不是我们所期望的；用choice方法：

app('translator')->choice('validation.extra', 0) 得到 没有；

app('translator')->choice('validation.extra', 18) 得到 一些；

app('translator')->choice('validation.extra', 20) 得到 很多；

可以将app('translator')->choice(...)简写*局帮助函数trans_choice(...)；

总结

以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作能带来一定的帮助，如果有疑问大家可以留言交流，谢谢大家对的支持。

# laravel  # 模块化  # 模块  # Laravel学习教程之广播模块详解  # Laravel中的Auth模块详解  # Laravel学习教程之View模块详解  # Laravel学习教程之路由模块  # 基于Laravel实现的用户动态模块开发  # 的是  # 加载  # 键名  # 第三方  # 放在  # 目录中  # 不存在  # 绑定  # 为空  # 是一个  # 此时会  # 相关内容  # 有可能  # 是这样  # 说了  # 不多  # 继承了  # 这类  # 就把  # 给大家 

相关文章： 如何在阿里云虚拟主机上快速搭建个人网站？  沈阳个人网站制作公司,哪个网站能考到沈阳事业编招聘的信息？  手机网站制作平台,手机靓号代理商怎么制作属于自己的手机靓号网站？  北京网站制作公司哪家好一点,北京租房网站有哪些？  威客平台建站流程解析：高效搭建教程与设计优化方案  如何高效完成独享虚拟主机建站？  如何零成本快速生成个人自助网站？  重庆网站制作公司哪家好,重庆中考招生办官方网站？  如何通过宝塔面板实现本地网站访问？  Dapper的Execute方法的返回值是什么意思 Dapper Execute返回值详解  自助网站制作软件,个人如何自助建网站？  交易网站制作流程,我想开通一个网站，注册一个交易网址，需要那些手续？  建站为何优先选择香港服务器？  教学论文网站制作软件有哪些,写论文用什么软件 ？  专业商城网站制作公司有哪些,pi商城官网是哪个？  5种Android数据存储方式汇总  网站制作网站,深圳做网站哪家比较好？  ,石家庄四十八中学官网？  简历在线制作网站免费,免费下载个人简历的网站是哪些？  营销式网站制作方案,销售哪个网站招聘效果最好？  广州网站制作公司哪家好一点,广州欧莱雅百库网络科技有限公司官网？  如何在阿里云ECS服务器部署织梦CMS网站？  如何在Windows服务器上快速搭建网站？  教学网站制作软件,学习*后期制作的网站有哪些？  建站主机如何安装配置？新手必看操作指南  建站VPS配置与SEO优化指南：关键词排名提升策略  建站主机如何选？高性价比方案全解析  重庆市网站制作公司,重庆招聘网站哪个好？  中山网站制作网页,中山新生登记系统登记流程？  定制建站策划方案_专业建站与网站建设方案一站式指南  网站制作新手教程,新手建设一个网站需要注意些什么？  如何登录建站主机？访问步骤全解析  企业宣传片制作网站有哪些,传媒公司怎么找企业宣传片项目？  开心动漫网站制作软件下载,十分开心动画为何停播？  移民网站制作流程,怎么看加拿大移民官网？  武汉网站设计制作公司,武汉有哪些比较大的同城网站或论坛，就是里面都是武汉人的？  网站制作的方法有哪些,如何将自己制作的网站发布到网上？  如何快速使用云服务器搭建个人网站？  如何在云主机上快速搭建网站？  网站制作外包价格怎么算,招聘网站上写的“外包”是什么意思？  rsync同步时出现rsync: failed to set times on “xxxx”: Operation not permitted  如何通过西部建站助手安装IIS服务器？  如何自定义建站之星模板颜色并下载新样式？  南京网站制作费用,南京远驱官方网站？  广州建站公司哪家好？十大优质服务商推荐  建站之星ASP如何实现CMS高效搭建与安全管理？  宝塔Windows建站如何避免显示默认IIS页面？  C#如何序列化对象为XML XmlSerializer用法  如何规划企业建站流程的关键步骤？  宝塔新建站点报错如何解决？