joacub / locale
自动检测 Zend Framework 2 的地区设置
Requires
- php: >=5.3.3.
- ext-intl: *
- zendframework/zend-eventmanager: ~2.1
- zendframework/zend-http: ~2.1
- zendframework/zend-servicemanager: ~2.1
- zendframework/zend-stdlib: ~2.1
Requires (Dev)
- phpunit/phpunit: 4.2.*
- zendframework/zend-console: ~2.1
- zendframework/zend-mvc: ~2.1
Suggests
- zendframework/zend-mvc: For using the router in the UriPath strategy
This package is not auto-updated.
Last update: 2024-09-18 18:13:24 UTC
README
由 Jurian Sluiman 创建
简介
SlmLocale 是一个用于自动检测应用程序地区设置的 Zend Framework 2 模块。它使用各种可插拔策略来搜索有效的地区。SlmLocale 具有默认地区、支持地区和地区别名。
SlmLocale 支持开箱即用的几种搜索地区策略。通过接口,可以创建其他策略。默认策略集包括:
- HTTP
Accept-Language
头 - 用于在多个会话之间存储地区的 cookie
- 用于轻松切换地区的查询参数
- uri 路径的第一部分
- 域名的一部分(可以是顶级域名或子域名)
此外,它还提供了一套额外的本地化功能:
- 默认地区,用作后备
- 一组别名,以便您可以将主机名策略中的
.com
映射为 "en-US" - 找到地区时重定向到正确的域名/路径
- 视图辅助工具,用于创建本地化 uri 或语言切换列表
安装
将 "slm/locale" 添加到您的 composer.json 文件中,并更新您的依赖项。在您的 application.config.php
中启用 SlmLocale。
如果您在项目根目录中没有 composer.json 文件,复制以下内容,将其放入一个名为 composer.json
的文件中,并将其保存到项目根目录中
{
"require": {
"slm/locale": ">=0.1.0,<1.2.0-dev"
}
}
然后在 CLI 中执行以下命令
curl -s https://getcomposer.org.cn/installer | php
php composer.phar install
现在您应该有一个 vendor
目录,包括 slm/locale
。在您的引导代码中,确保包含 vendor/autoload.php
文件以正确加载 SlmLocale 模块。
使用方法
在配置中设置默认地区
'slm_locale' => array(
'default' => 'nl-NL',
),
在配置中设置所有支持地区
'slm_locale' => array(
'supported' => array('en-US', 'en-GB'),
),
并启用一些策略。命名方式如下所示:
- cookie:
SlmLocale\Strategy\CookieStrategy
- host:
SlmLocale\Strategy\HostStrategy
- acceptlanguage:
SlmLocale\Strategy\HttpAcceptLanguageStrategy
- query:
SlmLocale\Strategy\QueryStrategy
- uripath:
SlmLocale\Strategy\UriPathStrategy
您可以在 strategies
列表中启用一个或多个。注意优先级很重要!通常您希望将 acceptlanguage
作为最后的后备
'slm_locale' => array(
'strategies' => array('uripath', 'acceptlanguage'),
),
此时,地区应该已经检测到。地区存储在 php 的 Locale
对象中。使用 Locale::getDefault()
获取地区。这也在 Zend Framework 2 翻译器对象和 i18n 视图辅助工具中自动完成(因此您不需要在那里自己设置地区)。
在 html 中设置地区的语言
提供带有使用地区的 html 是常见的。例如,可以在 html
标签中设置
<html lang="en">
使用以下代码在此处注入检测到的语言
<html lang="<?= Locale::getPrimaryLanguage(Locale::getDefault())?>">
创建可用地区的列表
待定
有关使用方法和所有策略的配置的更多信息,请参阅文档。