README

Hoa 是一套 模块化、可扩展 和 结构化 的 PHP 库。
此外，Hoa 旨在成为工业和研究世界之间的桥梁。

Hoa\Locale

此库允许从系统、HTTP 客户端或其他来源获取区域信息。

安装

使用 Composer，要将此库包含到依赖项中，您需要要求 hoa/locale

$ composer require hoa/locale '~2.0'

有关更多安装程序，请阅读源代码页面。

测试

在运行测试套件之前，必须安装开发依赖项

$ composer install

然后，运行所有测试套件

$ vendor/bin/hoa test:run

有关更多信息，请阅读贡献指南。

快速使用

我们提供了一个快速概述，以获取关于 HTTP 客户端的语言和相关信息。接下来，我们将看到其他本地化器。

来自 HTTP 客户端的区域

要从 HTTP 客户端获取区域，我们将使用 Hoa\Locale\Localizer\Http 本地化器。然后，我们将打印以下有趣方法的输出结果

getLanguage 获取语言，
getScript 获取脚本，
getRegion 获取区域，
getVariants 获取区域变体。

因此

$locale = new Hoa\Locale(new Hoa\Locale\Localizer\Http());

echo
    'language : ', $locale->getLanguage(), "\n",
    'script   : ', $locale->getScript(), "\n",
    'region   : ', $locale->getRegion(), "\n",
    'variant  : ', implode(', ', $locale->getVariants()), "\n";

例如，当 Accept-Language HTTP 标头设置为 zh-Hant-TW-xy-ab-123 时，我们将得到

language : zh
script   : Hant
region   : TW
variant  : xy, ab, 123

其他本地化器

到目前为止，我们还有 Hoa\Locale\Localizer\System，可以从系统中获取区域信息，以及 Hoa\Locale\Localizer\Coerce，可以从任意区域表示中获取这些信息。

文档

Hoa\Locale 的黑客手册包含有关如何使用此库及其工作方式的详细信息。

要本地生成文档，请执行以下命令

$ composer require --dev hoa/devtools
$ vendor/bin/hoa devtools:documentation --open

更多文档可以在项目网站上找到： hoa-project.net。

获取帮助

主要有两种获取帮助的方式

在 #hoaproject IRC 频道中，
在 users.hoa-project.net 的论坛上。

贡献

你想贡献力量吗？谢谢！一份详细的贡献者指南解释了你需要了解的所有内容。

许可证

Hoa项目采用新BSD许可证（BSD-3-Clause）。请参阅LICENSE获取详细信息。

hoa / locale

维护者

详细信息