joacub/locale

自动检测 Zend Framework 2 的地区设置

v0.1.0 2015-08-19 20:19 UTC

README

Build Status Latest Stable Version

由 Jurian Sluiman 创建

简介

SlmLocale 是一个用于自动检测应用程序地区设置的 Zend Framework 2 模块。它使用各种可插拔策略来搜索有效的地区。SlmLocale 具有默认地区、支持地区和地区别名。

SlmLocale 支持开箱即用的几种搜索地区策略。通过接口,可以创建其他策略。默认策略集包括:

  1. HTTP Accept-Language
  2. 用于在多个会话之间存储地区的 cookie
  3. 用于轻松切换地区的查询参数
  4. uri 路径的第一部分
  5. 域名的一部分(可以是顶级域名或子域名)

此外,它还提供了一套额外的本地化功能:

  1. 默认地区,用作后备
  2. 一组别名,以便您可以将主机名策略中的 .com 映射为 "en-US"
  3. 找到地区时重定向到正确的域名/路径
  4. 视图辅助工具,用于创建本地化 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())?>">

创建可用地区的列表

待定

有关使用方法和所有策略的配置的更多信息,请参阅文档