# python: Определение локали и middleware
URL: https://generaltranslation.com/ru/docs/python/guides/middleware.mdx
---
title: Определение локали и middleware
description: Как работает определение локали в Flask и FastAPI и как его настроить
---

Middleware GT для Python автоматически определяет локаль пользователя при каждом запросе и делает её доступной для [`t()`](/docs/python/api/t) и [`get_locale()`](/docs/python/api/get-locale). В этом руководстве объясняется, как работает определение локали и как расширенно настраивать это поведение.

<Callout>
  Базовое введение в настройку пользовательского определения локали см. в [руководстве по пользовательскому определению локали](/docs/python/tutorials/custom-locale-detection). Здесь эти подходы рассматриваются подробнее.
</Callout>

## Поведение по умолчанию

Если колбэк `get_locale` не указан, GT разбирает заголовок `Accept-Language`, сопоставляет его с настроенными `locales` и, если совпадений нет, использует `default_locale`:

<Tabs items={['Flask', 'FastAPI']}>
  <Tab value="Flask">
    ```python
    from flask import Flask
    from gt_flask import initialize_gt

    app = Flask(__name__)
    initialize_gt(app, default_locale='en', locales=['es', 'fr'])
    ```
  </Tab>

  <Tab value="FastAPI">
    ```python
    from fastapi import FastAPI
    from gt_fastapi import initialize_gt

    app = FastAPI()
    initialize_gt(app, default_locale='en', locales=['es', 'fr'])
    ```
  </Tab>
</Tabs>

## Комбинирование стратегий определения локали

В продакшене обычно стоит проверять несколько источников в порядке приоритета. Передайте колбэк `get_locale` в `initialize_gt`:

<Tabs items={['Flask', 'FastAPI']}>
  <Tab value="Flask">
    ```python
    from flask import Flask
    from gt_flask import initialize_gt

    app = Flask(__name__)

    def get_locale(request) -> str:
        # 1. Явно заданный параметр запроса
        lang = request.args.get('lang')
        if lang:
            return lang

        # 2. Cookie (сохранённое предпочтение пользователя)
        locale = request.cookies.get('locale')
        if locale:
            return locale

        # 3. Префикс URL-пути (/es/about)
        parts = request.path.strip('/').split('/')
        if parts and parts[0] in ('es', 'fr', 'de'):
            return parts[0]

        # 4. Заголовок Accept-Language
        accept = request.headers.get('Accept-Language', '')
        if accept:
            return accept.split(',')[0].split(';')[0].strip()

        return 'en'

    initialize_gt(app, default_locale='en', locales=['es', 'fr', 'de'], get_locale=get_locale)
    ```
  </Tab>

  <Tab value="FastAPI">
    ```python
    from fastapi import FastAPI, Request
    from gt_fastapi import initialize_gt

    app = FastAPI()

    def get_locale(request: Request) -> str:
        # 1. Явно заданный параметр запроса
        lang = request.query_params.get('lang')
        if lang:
            return lang

        # 2. Cookie (сохранённое предпочтение пользователя)
        locale = request.cookies.get('locale')
        if locale:
            return locale

        # 3. Префикс URL-пути (/es/about)
        parts = request.url.path.strip('/').split('/')
        if parts and parts[0] in ('es', 'fr', 'de'):
            return parts[0]

        # 4. Заголовок Accept-Language
        accept = request.headers.get('accept-language', '')
        if accept:
            return accept.split(',')[0].split(';')[0].strip()

        return 'en'

    initialize_gt(app, default_locale='en', locales=['es', 'fr', 'de'], get_locale=get_locale)
    ```
  </Tab>
</Tabs>

## Сохранение локали в cookie

Дайте пользователям выбрать язык и запомните этот выбор:

<Tabs items={['Flask', 'FastAPI']}>
  <Tab value="Flask">
    ```python
    from flask import request, make_response, jsonify

    @app.route('/api/set-language', methods=['POST'])
    def set_language():
        locale = request.json.get('locale', 'en')
        response = make_response(jsonify({'ok': True}))
        response.set_cookie('locale', locale, max_age=365 * 24 * 60 * 60)
        return response
    ```
  </Tab>

  <Tab value="FastAPI">
    ```python
    from fastapi import Request
    from fastapi.responses import JSONResponse

    @app.post('/api/set-language')
    async def set_language(request: Request):
        body = await request.json()
        locale = body.get('locale', 'en')
        response = JSONResponse({'ok': True})
        response.set_cookie('locale', locale, max_age=365 * 24 * 60 * 60)
        return response
    ```
  </Tab>
</Tabs>

## Определение по профилю пользователя

Для приложений с аутентификацией берите локаль из пользовательских настроек:

```python
def get_locale(request) -> str:
    user = get_current_user(request)  # ваша логика аутентификации
    if user and user.preferred_locale:
        return user.preferred_locale

    # Откат к cookie или заголовку
    return request.cookies.get('locale') or 'en'
```


## Чтение определённой локали

Используйте [`get_locale()`](/docs/python/api/get-locale) на любом этапе обработки запроса, чтобы получить определённую локаль:

```python
from gt_flask import get_locale  # или gt_fastapi

@app.route('/api/info')
def info():
    return { 'locale': get_locale() }
```


## Следующие шаги

* [Руководство по пользовательскому определению локали](/docs/python/tutorials/custom-locale-detection) — краткое введение
* [Справка по API `get_locale()`](/docs/python/api/get-locale)
* [Подходы к переводу строк](/docs/python/guides/strings) — как переводить содержимое