LuneticsLocaleBundle 技术文档

1. 安装指南

1.1 使用 Composer 安装

首先，确保你已经安装了 Composer，然后在项目根目录下运行以下命令来安装 LuneticsLocaleBundle：

composer require lunetics/locale-bundle

1.2 启用 Bundle

在 app/AppKernel.php 文件中注册该 Bundle：

public function registerBundles()
{
    $bundles = [
        // 其他 bundles
        new Lunetics\LocaleBundle\LuneticsLocaleBundle(),
    ];

    return $bundles;
}

1.3 配置 Bundle

在 app/config/config.yml 文件中添加以下配置：

lunetics_locale:
    guessing_order:
        - query
        - router
        - browser
        - cookie
        - session
        - subdomain

2. 项目的使用说明

LuneticsLocaleBundle 允许你在 Symfony 应用中根据不同的参数来猜测用户的 Locale。以下是一些常见的使用场景：

2.1 通过 URL 参数设置 Locale

你可以在 URL 中通过 _locale 参数来设置 Locale，例如：

http://example.com/en/homepage

2.2 通过浏览器设置 Locale

如果用户的首选语言在浏览器中设置，Bundle 会自动检测并设置相应的 Locale。

2.3 通过 Cookie 或 Session 设置 Locale

如果用户之前已经设置了 Locale，Bundle 会从 Cookie 或 Session 中读取并设置相应的 Locale。

2.4 通过子域名设置 Locale

你还可以通过子域名来设置 Locale，例如：

http://en.example.com/homepage

3. 项目 API 使用文档

3.1 获取当前 Locale

你可以通过以下代码获取当前的 Locale：

$locale = $request->getLocale();

3.2 设置 Locale

你可以通过以下代码手动设置 Locale：

$request->setLocale('fr');

3.3 获取支持的 Locales

你可以通过以下代码获取 Bundle 支持的所有 Locales：

$supportedLocales = $this->getParameter('lunetics_locale.allowed_locales');

4. 项目安装方式

4.1 通过 Composer 安装

如前所述，使用 Composer 安装是最常见的方式：

composer require lunetics/locale-bundle

4.2 手动安装

如果你不想使用 Composer，也可以手动下载 Bundle 并将其放置在 src/ 目录下，然后按照上述步骤启用和配置 Bundle。

---

通过以上步骤，你应该能够成功安装并使用 LuneticsLocaleBundle 来管理 Symfony 应用中的 Locale。