Starlette应用的国际化与本地化实践

Starlette是一个轻量级的异步Web框架，它提供了国际化和本地化的支持。以下是一些关于如何在Starlette应用中实施国际化和本地化的示例。

1. 设置默认语言：

在Starlette应用的入口文件中，可以设置应用的默认语言。例如，要将默认语言设置为英文，可以在应用实例化之前添加以下代码：

import starlette.applications
from starlette.middleware import Middleware
from starlette.middleware.base import BaseHTTPMiddleware
from starlette.middleware.sessions import SessionMiddleware
from starlette.middleware.gzip import GZipMiddleware
from starlette.middleware.errors import ServerErrorMiddleware
from starlette.middleware.authentication import AuthenticationMiddleware

app = starlette.applications.Starlette()

# 设置默认语言
app.state.default_locale = 'en'

2. 国际化字符串翻译：

在Starlette应用中，可以使用gettext工具来进行字符串的国际化翻译。首先需要在应用中创建一个用于翻译的gettext实例，并加载语言文件。例如，要为英语和法语加载翻译文件，可以添加以下代码：

import gettext

# 创建gettext实例
gettext_translation = gettext.translation(
    'messages',  # 翻译文件的前缀
    'locales',   # 存放翻译文件的目录
    languages=['en', 'fr']  # 支持的语言列表
)

# 将gettext实例绑定到app的state中，以便在整个应用中访问
app.state.gettext = gettext_translation.gettext

然后，在需要翻译的字符串中，可以使用gettext实例的gettext方法来进行翻译。例如：

from starlette.responses import HTMLResponse

async def homepage(request):
    # 获取gettext实例
    gettext = request.app.state.gettext
    # 翻译字符串
    message = gettext('Welcome to my website!')
    # 返回响应
    return HTMLResponse(message)

3. 根据客户端的首选语言进行内容协商：

Starlette提供了一个中间件，用于根据客户端的首选语言进行内容协商，从而提供适合客户端的语言版本的内容。可以在应用的中间件列表中添加ContentNegotiationMiddleware中间件，并设置支持的语言列表。例如，要支持英文和法文，可以添加以下代码：

from starlette.middleware import ContentNegotiationMiddleware
from starlette.responses import PlainTextResponse

# 添加ContentNegotiationMiddleware中间件
app.add_middleware(ContentNegotiationMiddleware, supported=['en', 'fr'])

# 设置路由和视图函数
@app.route('/')
async def homepage(request):
    return PlainTextResponse('Hello')

@app.route('/about')
async def about(request):
    return PlainTextResponse('About us')

当客户端发送请求时，中间件会根据客户端的首选语言选择适合客户端的语言版本的内容。例如，如果客户端的首选语言是法语，当访问/时，响应将是Bonjour，访问/about时，响应将是à propos de nous。

这些例子演示了如何在Starlette应用中实现国际化和本地化。通过设置默认语言，使用gettext进行翻译和根据客户端首选语言进行内容协商，可以为不同的语言提供适合的内容。这样可以提高应用的用户体验，并为具有不同语言偏好的用户提供更好的服务。