semitexa/locale

Semitexa Locale - translation, locale resolution, and i18n support for applications

Maintainers

Package info

github.com/semitexa/semitexa-locale

Type:semitexa-module

pkg:composer/semitexa/locale

Statistics

Installs: 58

Dependents: 2

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

2026.04.05.0855 2026-04-04 11:32 UTC

Requires

Suggests

  • semitexa/tenancy: Required for TenantResolvedLocaleListener — sets locale from tenant context

MIT 439a6b8999f41b91c11b6ae6b91ccc7fa021a23c

i18ntranslationslocalelocalizationsemitexa

This package is auto-updated.

Last update: 2026-04-05 09:00:32 UTC

README

Internationalization module with per-request locale resolution, coroutine-safe context, and translation with CLDR plural support.

Purpose

Resolves the active locale on every request through a composable, configurable resolver chain (commonly cookie, URL path, and Accept-Language header; actual order follows configuration). Stores the result in coroutine-safe context and provides a translation service with CLDR plural rules for Germanic and Slavic languages, with other languages currently falling back to Germanic rules.

Role in Semitexa

Depends on Core. Optional integration with Tenancy for tenant-driven locale defaults. Used by SSR for locale-aware template rendering, Mail for localized email content, and any module that needs translated output.

Key Features

  • Resolver chain (configuration-driven priority): CookieLocaleResolver, PathLocaleResolver, HeaderLocaleResolver (RFC 7231 quality factors)
  • Custom resolvers via LocaleResolverInterface
  • Coroutine-safe LocaleContextStore for Swoole
  • TranslationService with named placeholders and transChoice() for plurals
  • CLDR plural rules: Germanic (en, de), Slavic East (uk, ru), Slavic West (pl)
  • JSON translation files per module (Application/View/locales/{lang}.json)
  • Module-namespaced keys (MyModule.welcome)
  • LocaleResolved event for post-resolution hooks
  • TenantResolvedLocaleListener for automatic tenant-based locale when Tenancy is active

Notes

Translation catalogs are loaded once at worker boot and shared across requests. The context store uses Swoole coroutine storage in HTTP mode and static fallback in CLI/test mode.