think-lang

ThinkPHP 6.0 多语言优化扩展包

https://github.com/TLingC/think-lang

登录后复制

特色

支持通过如 mywebsite.com/zh-hans/ 的二级目录访问对应语言页面。
支持每种语言的语言包单独成目录，目录下可设有二级目录。

安装

composer require tlingc/think-lang

登录后复制

使用

基础配置

请参照官方文档（https://www.kancloud.cn/manual/thinkphp6_0/1037637）进行相关配置。同时注意如下与官方文档的不同点。

开启和加载语言包

中间件名称为：

&#39;tlingc\lang\middleware\LoadLangPack&#39;,

登录后复制

由于多语言通过二级目录访问，使用Cookie保存语言 功能无效。

语言文件定义

自动加载的应用语言文件：

// 单应用模式app\lang\当前语言.php
app\lang\当前语言\*.php
app\lang\当前语言\*\*.php// 多应用模式app\应用\lang\当前语言.php
app\应用\lang\当前语言\*.php
app\应用\lang\当前语言\*\*.php

登录后复制

请注意此扩展包没有对语言包解析行为进行修改，语言文件的文件名不会影响语言分组，在多个文件中存在相同定义时会导致被覆盖。

路由设置

使用二级目录访问对应语言页面，必须使用路由定义，同时建议开启 强制路由 模式。

use think\facade\Config;Route::view(&#39;/&#39;, &#39;index/index&#39;);$langs = Config::get(&#39;lang.allow_lang_list&#39;);foreach($langs as $lang){
	Route::rule($lang . &#39;/&#39;, &#39;index/index&#39;);
	Route::rule($lang . &#39;/welcome&#39;, &#39;index/welcome&#39;);}

登录后复制

重写 `url` 助手函数

在应用公共文件 common.php 中加入。

use think\facade\Request;use think\facade\Lang;use think\facade\Route;use think\route\Url as UrlBuild;function url(string $url = &#39;&#39;, array $vars = [], $suffix = true, $domain = false, $lang = true, $replace = false): UrlBuild{
    if (!$lang) {
		if($replace) {
			$explode = explode(&#39;/&#39;, Request::url(), 3);
			$url = $url . $explode[2];
		}
        return Route::buildUrl($url, $vars)->suffix($suffix)->domain($domain);
	}
	$lang = Lang::getLangSet();
	return Route::buildUrl(&#39;/&#39; . $lang . $url, $vars)->suffix($suffix)->domain($domain);}

登录后复制

对比官方提供的助手函数，增加了 $lang 及 $replace 参数。

普通跳转，生成url时会自动带上前方的语言名称。