专栏首页编程乐园Laravel学习教程之本地化模块

Laravel学习教程之本地化模块

前言

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

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

模块组成

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

TranslationServiceProvide

本地化模块的服务提供者,既是一个模块的入口,也是与IOC容器交互的中心;注册翻译器实例translation.loader,注册翻译管理实例translator,并声明延迟加载服务;

Translato

翻译管理类;

MessageSelecto

消息过滤器,通过判断复数值来选择合适的消息;比如消息内容是这样的{0}没有|[1,19]一些|[20,*]很多,我们传的数字是 18,那么最后选择的消息就是"一些";

LoaderInterface

翻译器接口;声明了三个方法load,addNamespace,namespaces;

FileLoade

继承了LoaderInterface,从文件获取本地化资源数据;

ArrayLoade

继承了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-&gt;loaded[$namespace][$group][$locale] = $lines;

获取资源,并替换参数:/

/通过Arr::get方法从$this-&gt;loaded[$namespace][$group][$locale]中获取元素值:attribute 必须接受。;此时,参数数组为不空,循环替换,得到结果"用户名 必须接受。";

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

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

<?php

return [

'message' => 'hello, Faker/Provider',

......

];

同时,手动在Translato/

/r中注册第三方插件(也就是带命名空间)的资源根目录位置;

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-&gt;loaded[$namespace][$group][$locale] = $lines;

获取资源,并替换参数:通过Arr::get方法从$this-&gt;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-&gt;loaded[$namespace][$group][$locale] = $lines;

获取资源,并替换参数:通过Arr::get方法从$this-&gt;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(...);

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

原文链接:https://www.blog.zirun.me/php/4636.html

我来说两句

0 条评论
登录 后参与评论

相关文章

  • Laravel学习教程之路由模块

    前言 本文主要给大家介绍的是关于Laravel路由模块的相关内容,分享出来供大家参考学习,下面话不多说了,来一起看看详细的介绍吧。 备注:本文是基于Larave...

    用户2323866
  • Laravel学习教程之View模块详解

    前言 本文主要是给大家介绍了关于Laravel中View模块的相关资料,分享出来供大家参考学习,下面话不多说了,来一起看看详细的介绍吧。 本文是基于Larave...

    用户2323866
  • Laravel学习教程之广播模块详解

    前言 本文主要给大家介绍了关于Laravel广播模块的相关内容,分享出来供大家参考学习,下面话不多说了,来一起看看详细的介绍: 注意:本文是基于Laravel ...

    用户2323866
  • 深入剖析 Laravel 服务容器

    之前在 深度挖掘 Laravel 生命周期 一文中,我们有去探究 Laravel 究竟是如何接收 HTTP 请求,又是如何生成响应并最终呈现给用户的工作原理。

    柳公子
  • 如何选择PHP框架?

    PHP是世界上最受欢迎的编程语言之—。最近发布的PHP7令这种服务器的编程语言比以前变得更好,更稳定了。

    LiveEdu
  • Laravel5.8开发环境搭建与CRUD应用实践

    在这个面向初学者的教程中,我们将学习如何使用最新的PHP开发框架Laravel 5.8,来创建一个基于MySQL数据库的Web应用,实现联系人的增删改查功能。

    用户1408045
  • 如何在Ubuntu 14.04上使用Ansible部署高级PHP应用程序

    在本教程中,我们将介绍如何设置SSH密钥以支持代码部署/发布工具,配置系统防火墙,配置和配置数据库(包括密码!),以及设置任务调度程序(crons)和队列守护进...

    圣人惠好可爱
  • 怎样选择适合自己php框架

    PHP是世界上最流行的编程语言之一,并且最近PHP7的发布让这门服务器端的编程语言比以往更加的强大和稳定。

    猿哥
  • 通过 Laravel 创建一个 Vue 单页面应用(一)

    使用 laravel 创建一个 Vue 单页面应用 (SPA) 可以构建一个整洁的由 API 驱动的应用。在此教程中,我们将学习如何构建并运行一个以 Vue 路...

    hedeqiang
  • Laravel框架是什么

    Laravel是一个开源PHP框架,功能强大且易于理解。它遵循模型 - 视图 - 控制器设计模式(MVC)。Laravel重用了不同框架的现有组件,这有助于创...

    叫我可儿呀
  • 如何在Ubuntu 14.04上使用Ansible部署基本PHP应用程序

    本教程介绍使用Ansible配置基本PHP应用程序的过程。本教程结束时的目标是让您新Web服务器为基本的PHP应用程序提供服务,而无需在目标腾讯CVM上运行单个...

    所有的酒都不如你
  • 在 Laravel 项目中编写第一个 Vue 组件

    和 CSS 框架一样,Laravel 不强制你使用什么 JavaScript 客户端框架,但是开箱对 Vue.js 提供了良好的支持,如果你更熟悉 React ...

    学院君
  • Laravel 5 系列入门教程(一)【最适合中国人的 Laravel 教程】

    2. http://www.golaravel.com/laravel/docs/5.0/

    竹清
  • 2018年laravel教程第1节搭建项目phpstorm添加laravel代码提示新建路由和控制器渲染页面定义公共模板文件公共头部和底部小结

    PHP框架哪家强?这个问题估计得让PHPer撕起来,别的指标不说,仅从github的受欢迎程度来讲,laravel当之无愧是榜首:

    章鱼喵
  • Python模块化编程-函数#学习猿地

    > 函数就是把代码进行封装,以提高代码的重用性,提高开发效率,并且降低了后期的维护成本

    学习猿地
  • Python模块化编程-函数#学习猿地

    > 函数就是把代码进行封装,以提高代码的重用性,提高开发效率,并且降低了后期的维护成本

    学习猿地
  • Laravel 5 系列入门教程(二)【最适合中国人的 Laravel 教程】

    我们将改变学习路线,不再像 Laravel 4 教程那样先构建登录系统。在本篇教程中,我们将一起构建 Pages 的管理功能,尝试 Laravel 的路由和 P...

    竹清
  • 如何在Ubuntu 14.04上使用Ansible部署多个PHP应用程序

    本教程是关于在Ubuntu 14.04上使用Ansible部署PHP应用程序的系列文章中的第三篇。第一个教程涵盖了部署应用程序的基本步骤; 在第二个教程介绍更高...

    林岑影
  • laravel5.1框架基础之路由详解

    本文实例讲述了laravel5.1框架基础之路由。分享给大家供大家参考,具体如下:

    砸漏

扫码关注云+社区

领取腾讯云代金券