51lang.php,[李景山php]每天TP5-20170107|thinkphp5-Lang.php

// +----------------------------------------------------------------------

// | ThinkPHP [ WE CAN DO IT JUST THINK ]

// +----------------------------------------------------------------------

// | Copyright (c) 2006~2016 http://thinkphp.cn All rights reserved.

// +----------------------------------------------------------------------

// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )

// +----------------------------------------------------------------------

// | Author: liu21st 

// +----------------------------------------------------------------------

namespace think;

use think\App;

use think\Cookie;

use think\Log;

// 使用 app \ cookie\ log 类

class Lang

{// 语言 类

// 语言数据

private static $lang = [];// 语言数据

// 语言作用域

private static $range = 'zh-cn';// 语言作用域 语言类型

// 语言自动侦测的变量

protected static $langDetectVar = 'lang'; // 自动侦测变量

// 语言Cookie变量

protected static $langCookieVar = 'think_var'; // 语言 cookie 变量

// 允许语言列表

protected static $allowLangList = [];// 允许语言列表

// 设定当前的语言

public static function range($range = '')// 设定 当前的 语言

{// 设置 或者 是索取

if ('' == $range) {

return self::$range;

} else {

self::$range = $range;

}

}

/**

* 设置语言定义(不区分大小写)

* @param string|array  $name 语言变量

* @param string        $value 语言值

* @param string        $range 语言作用域

* @return mixed

*/

public static function set($name, $value = null, $range = '')

{

$range = $range ?: self::$range;// 设置语言 范围 ，范围 内部

// 批量定义

if (!isset(self::$lang[$range])) {// 获取语言 设置

self::$lang[$range] = [];

}

if (is_array($name)) {// 支持 数组设置 同时 也支持 字符串 的设置

return self::$lang[$range] = array_change_key_case($name) + self::$lang[$range];// 进行语言变量设置

} else {

return self::$lang[$range][strtolower($name)] = $value;// 单独设置

}

}

/**

* 加载语言定义(不区分大小写)

* @param string $file 语言文件

* @param string $range 语言作用域

* @return mixed

*/

public static function load($file, $range = '')

{

$range = $range ?: self::$range;// 范围

if (!isset(self::$lang[$range])) {// 语言定义数据

self::$lang[$range] = [];

}

// 批量定义

if (is_string($file)) {// 文件 字符串 转数组

$file = [$file];

}

$lang = [];// 语言 定义 临时仓库

foreach ($file as $_file) {

if (is_file($_file)) {// 如果是文件

// 记录加载信息

App::$debug && Log::record('[ LANG ] ' . $_file, 'info');// 调试 并且 记录 加载信息

$_lang = include $_file;// 临时数据

} else {

$_lang = [];

}

$lang = array_change_key_case($_lang) + $lang; // 拼接字符串 + 号的方式，有什么特别的吗？ array_merge不行吗

}

if (!empty($lang)) {// 不为空， 拼接

self::$lang[$range] = $lang + self::$lang[$range];

}

return self::$lang[$range];// 返回定义数组

}

/**

* 获取语言定义(不区分大小写)

* @param string|null   $name 语言变量

* @param array         $vars 变量替换

* @param string        $range 语言作用域

* @return mixed

*/

public static function has($name, $range = '')// 检测 当前的转义 是否存在

{

$range = $range ?: self::$range;

return isset(self::$lang[$range][strtolower($name)]);

}

/**

* 获取语言定义(不区分大小写)

* @param string|null   $name 语言变量

* @param array         $vars 变量替换

* @param string        $range 语言作用域

* @return mixed

*/

public static function get($name = null, $vars = [], $range = '')

{

$range = $range ?: self::$range;

// 空参数返回所有定义

if (empty($name)) {// 为空，返回 当前全部语言定义

return self::$lang[$range];

}

$key   = strtolower($name);// 找到key

$value = isset(self::$lang[$range][$key]) ? self::$lang[$range][$key] : $name;// 值是输入的信息？ 开玩笑吗？

// 变量解析

if (!empty($vars) && is_array($vars)) {// 变量 解析 获取数据不为空

/**

* Notes:

* 为了检测的方便，数字索引的判断仅仅是参数数组的第一个元素的key为数字0

* 数字索引采用的是系统的 sprintf 函数替换，用法请参考 sprintf 函数

*/

if (key($vars) === 0) {

// 数字索引解析

array_unshift($vars, $value);// 这个要加强 array_unshift array_change_key_case

$value = call_user_func_array('sprintf', $vars);// 格式化 输出

} else {

// 关联索引解析

$replace = array_keys($vars);

foreach ($replace as &$v) {

$v = "{:{$v}}";

}

$value = str_replace($replace, $vars, $value);// 临时替换数据

}

}

return $value;

}

/**

* 自动侦测设置获取语言选择

* @return string

*/

public static function detect()

{

// 自动侦测设置获取语言选择

$langSet = '';// 默认设置为空

if (isset($_GET[self::$langDetectVar])) {// url 设置

// url中设置了语言变量

$langSet = strtolower($_GET[self::$langDetectVar]);

Cookie::set(self::$langCookieVar, $langSet, 3600);

} elseif (Cookie::get(self::$langCookieVar)) {// 默认的cookie 设置

// 获取上次用户的选择

$langSet = strtolower(Cookie::get(self::$langCookieVar));

} elseif (isset($_SERVER['HTTP_ACCEPT_LANGUAGE'])) {// 浏览器 设置

// 自动侦测浏览器语言

preg_match('/^([a-z\d\-]+)/i', $_SERVER['HTTP_ACCEPT_LANGUAGE'], $matches);

$langSet = strtolower($matches[1]);

Cookie::set(self::$langCookieVar, $langSet, 3600);

}

if (empty(self::$allowLangList) || in_array($langSet, self::$allowLangList)) {// 默认设置 返回数据

// 合法的语言

self::$range = $langSet ?: self::$range;

}

if ('zh-hans-cn' == self::$range) {// 强制 转换 一个参数

self::$range = 'zh-cn';

}

return self::$range;

}

/**

* 设置语言自动侦测的变量

* @param string $var 变量名称

* @return void

*/

public static function setLangDetectVar($var)// 变量设置

{

self::$langDetectVar = $var;

}

/**

* 设置语言的cookie保存变量

* @param string $var 变量名称

* @return void

*/

public static function setLangCookieVar($var)// cookie变量

{

self::$langCookieVar = $var;

}

/**

* 设置允许的语言列表

* @param array $list 语言列表

* @return void

*/

public static function setAllowLangList($list)// 允许列表

{

self::$allowLangList = $list;

}

}