Your new understanding has made you powerful. Please use your new powers for good.

1.25.1 固定的中文写法

一直以来,我们都是硬编码方式返回中文的文案或者提示,如:

  1. $rs['msg'] = '用户不存在';

这种写法在项目根本不需要考虑国际化翻译时,是完全没问题的。

1.25.2 通用的翻译写法

当我们需要进行翻译时,可以这样进行调整:

  1. $rs['msg'] = T('user not exists');

然后在对应的翻译文件中(如中文对应文件是:./Language/zh_cn/common.php)添加对应的翻译即可:

  1. // $vim ./Language/zh_cn/common.php
  2. return array(
  3. 'user not exists' => '用户不存在',
  4. );

(1)当存在动态变量时?

有时,我们需要动态返回一些值,这里可以用 大括号 将需要动态替换的值包住并提供替换的参数即可,一如:

  1. echo T('hello {name}', array('name' => 'dogstar'));

如果对应的中文翻译是:

  1. 'hello {name}' => '您好,{name}',

将会看到输出:

  1. 您好,dogstar

(2)当多个动态变量时,还可以这样省略变量名

如果要简化动态变量的传递,可以这样:

  1. echo T('{0} I love you because {1}', array('PhalApi', 'no reasons'));

如果对应的中文翻译是:

  1. '{0} I love you because {1}' => '{0} 我爱你因为{1}',

将会看到输出:

  1. PhalApi 我爱你因为no reasons

(3)当翻译不存在时?

翻译不存在,有两种场景:一是指定的语言包不存在;二是语言包存在但翻译不存在。无论何种情况,找不到翻译时,都会用代码硬编码的内容返回。

1.25.3 语言的设定

当我们拥有了多种语言时,则可以在入口/初始化文件中,选择设定需要的语言。

  1. SL('zh_cn'); //SL()函数等效于PhalApi_Translator::setLanguage()

参数即为语言包的路径名,如下面的en, zh_cn:

  1. .
  2. |-- en
  3. | `-- common.php
  4. `-- zh_cn
  5. `-- common.php

此处,也可以通过客户端传递参数来自行选择语言。简单地:

  1. SL($_GET['lan']);

1.25.4 添加语言翻译包

有时需要手动添加语言翻译包,因为对应的翻译不一定在项目的./Language下,如扩展类库。

当需要添加额外的语言翻译包时,可以这样添加:

  1. PhalApi_Translator::addMessage(API_ROOT . '/Library/User');

在User这个目录下的翻译包类似地,为:

  1. ./Language/
  2. └── zh_cn
  3. └── common.php
  4. 1 directory, 1 file

相当于追加一个额外的项目路径,其他的加载过程和原来的一样。

1.25.5 建议

所以,你可以轻松看到,所谓的翻译也只是通过数组下标找一下对应的内容而已,没有太多的技术性,也没有过多的性能问题。

但正是有这样提前周到的国际化准备,我们可以对外(如像产品、BOSS和外界)传送这样一个隐喻: 我们的项目可以快速支持国际翻译 。这听起来多么高大尚啊!因为那些不懂技术的人,根本不在乎是用PHP的数组来存放还是什么技术,而在于能不能走向国际化。

SO?既然翻译”无伤大雅“(指对性能的影响和对代码编写的阻碍),统一使用翻译的写法是值得推荐的。

即使项目没有机会用到真正的翻译,但至少有两点我认为也是有用的:

  • 1、便于产品维护接口返回的提示文案;
  • 2、被同行问到时,你们有支持i18n吗?我们也可以笑着回答:有 ^_^ ;

    还有疑问?欢迎到社区提问! 切换到PhalApi 2.x 开发文档。

原文: https://www.phalapi.net/wikis/1-25.html