Laravel学习教程之本地化模块


Posted in PHP onAugust 18, 2017

前言

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

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

模块组成

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

Laravel学习教程之本地化模块

  • 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(...);

总结

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

PHP 相关文章推荐
修改Zend引擎实现PHP源码加密的原理及实践
Apr 14 PHP
php 读取文件乱码问题
Feb 20 PHP
PHP计划任务之关闭浏览器后仍然继续执行的函数
Jul 22 PHP
PHP三元运算符的结合性介绍
Jan 10 PHP
phpMyAdmin出现无法载入 mcrypt 扩展,请检查PHP配置的解决方法
Mar 26 PHP
php开发文档 会员收费1期
Aug 14 PHP
Function eregi is deprecated (解决方法)
Jun 21 PHP
php实例分享之通过递归实现删除目录下的所有文件详解
May 15 PHP
PHP网页游戏学习之Xnova(ogame)源码解读(九)
Jun 24 PHP
PHP获取一个字符串中间一部分字符的方法
Aug 19 PHP
yii2 modal弹窗之ActiveForm ajax表单异步验证
Jun 13 PHP
Laravel获取所有的数据库表及结构的方法
Oct 10 PHP
PDO操作MySQL的基础教程(推荐)
Aug 18 #PHP
Laravel学习教程之路由模块
Aug 18 #PHP
Django中的cookie与session操作实例代码
Aug 17 #PHP
Django 中 cookie的使用
Aug 17 #PHP
PHP面向对象中new self()与 new static()的区别浅析
Aug 17 #PHP
通过修改Laravel Auth使用salt和password进行认证用户详解
Aug 17 #PHP
PHP实现执行外部程序的方法详解
Aug 17 #PHP
You might like
php下关于Cannot use a scalar value as an array的解决办法
2010/08/08 PHP
PHP 计算代码执行耗时的代码修正网上普遍错误
2011/05/14 PHP
php学习之数据类型之间的转换代码
2011/05/29 PHP
模板引擎smarty工作原理以及使用示例
2014/05/25 PHP
CI框架整合smarty步骤详解
2016/05/19 PHP
微信公众号判断用户是否已关注php代码解析
2016/06/24 PHP
PHP编程 SSO详细介绍及简单实例
2017/01/13 PHP
strpos() 函数判断字符串中是否包含某字符串的方法
2019/01/16 PHP
Jquery 实现表格颜色交替变化鼠标移过颜色变化实例
2013/08/28 Javascript
jQuery表格插件ParamQuery简单使用方法示例
2013/12/05 Javascript
文本域光标操作的jQuery扩展分享
2014/03/10 Javascript
原生javascript实现addClass,removeClass,hasClass函数
2016/02/25 Javascript
jQuery前端开发35个小技巧
2016/05/24 Javascript
Node.js中防止错误导致的进程阻塞的方法
2016/08/11 Javascript
使用JQuery中的trim()方法去掉前后空格
2016/09/16 Javascript
原生JS取代一些JQuery方法的简单实现
2016/09/20 Javascript
原生js实现addclass,removeclass,toggleclasss实例
2016/11/24 Javascript
js中let和var定义变量的区别
2018/02/08 Javascript
vue基础之data存储数据及v-for循环用法示例
2019/03/08 Javascript
Vue双向数据绑定(MVVM)的原理
2020/10/03 Javascript
[03:18]DOTA2亚洲邀请赛小组赛第一日 RECAP赛事回顾
2015/01/30 DOTA
[03:22]DAC最前线(第二期)—DOTA2亚洲邀请赛主赛场周边及线路探访
2015/01/24 DOTA
Python中的错误和异常处理简单操作示例【try-except用法】
2017/07/25 Python
Python3 queue队列模块详细介绍
2018/01/05 Python
使用Python给头像加上圣诞帽或圣诞老人小图标附源码
2019/12/25 Python
在python image 中实现安装中文字体
2020/05/16 Python
Django中使用Json返回数据的实现方法
2020/06/03 Python
Python 在函数上添加包装器
2020/07/28 Python
改变 Python 中线程执行顺序的方法
2020/09/24 Python
css3闪亮进度条效果实现思路及代码
2013/04/17 HTML / CSS
加强作风建设演讲稿
2014/10/24 职场文书
乡镇党的群众路线教育实践活动制度建设计划
2014/11/03 职场文书
优秀党员先进事迹材料
2014/12/18 职场文书
2015年检验科工作总结
2015/04/27 职场文书
我对PyTorch dataloader里的shuffle=True的理解
2021/05/20 Python
Nginx利用Logrotate实现日志分割
2022/05/20 Servers